Slack

The Slack app allows you to be notified in Slack about content changes happening in Contentful. When editors make changes to entries of a particular content type, this app can automatically post these updates to a channel in your Slack workspace.

This way, editors are notified when something changes in the content or when new content is created, deleted or published.

Overview

The Slack app provides the following functionality:

  • Be notified when entries are (un)published, deleted and created

  • Selection of one or more channels to be notified

  • Can be used for several different content types and events at the same time

Requirements

To use this app, you will need the following:

  • You must have permission to add apps to your Slack workspace

  • You are authorized to add apps to a Slack channel

  • The Contentful app is installed in Slack and invited to the channel where you want the app to post messages

Usage

Step 1: Install and configure

Click on the "Add to Slack" button to authenticate with Slack:

Screen Shot 2022-04-06 at 16.20.59

This authorizes the app to act on your behalf in API interactions from Contentful to Slack within the listed scope.

Screen Shot 2022-04-06 at 16.22.43

Step 2: Configure Contentful events for which you want to be notified

For every notification you set up, you can:

  1. Select the content type you want the events to be linked to

  2. Select the Slack channel in the dropdown you want the message to be sent. Make sure you add the Contentful app to that channel by inviting it

  3. Select the events you want to be notified for

Screen Shot 2022-04-06 at 16.27.34

Step 3: Send messages

Trigger one of the selected events to be notified in the selected Slack channel:

Screen Shot 2022-04-06 at 17.06.25

Under the hood

Internally, the app will:

  1. Authenticate with Slack via OAuth in the selected workspace.

  2. Install the app to the connected workspace.

  3. Ask you to select a content type and a channel.

  4. Creates AppEvents for the selected events.

  5. When an event occurs it will post a message in a specific format to the selected channel using the Slack message API.

Was this helpful?
add-circle arrow-right remove style-two-pin-marker subtract-circle