Home›Integrations›Promoting to Slack

Promoting to Slack

Let Block Editor content authors promote pages to a Slack workspace by configuring a Slack app and a promotion channel.

The Block Editor lets content authors promote content across many channels in your business, including Slack. This guide explains how to configure Interact to promote to your Slack workspace.

Before you start

You need:

  • A Power User account in Interact with access to Control Panel > Block Editor.
  • An administrator account in your Slack workspace with permission to create Slack apps and install them.
  • Your intranet domain to hand.

Step 1: Create a Slack app

  1. Go to https://api.slack.com/apps and sign in if necessary. Select Create New App, then From scratch. Specify an app name for the integration and select the workspace where you will develop your app.

Creating a Slack app from scratch

  1. Go to the OAuth & Permissions section. Towards the bottom of the page, set the required Bot Token Scopes. Select Add an OAuth Scope and add channels:read, chat:write and groups:read. No scopes need to be added to User Token Scopes.

For more on Slack access tokens, see the Slack token types documentation.

Bot token scopes

  1. Scroll back to the top of the OAuth & Permissions page. Select Install to Workspace, then Allow. This returns you to the OAuth & Permissions page, where you now see your Bot User OAuth Token for the first time. Make a copy of this. It is accessible again if you forget it. A Bot User OAuth Token always begins with xoxb.

Bot User OAuth Token

  1. Add your newly created app individually to any public or private channels you want it to post to.

Adding the app to a channel

Confirming the app in a channel

Step 2: Configure a promotion channel

  1. Go to Control Panel > Block Editor > Promotion Channels > Add New Channel.
  2. Specify the Name and Type. The Name is what your content authors see when selecting which platform to promote to, so Slack is fine here. Set the Type to Slack.
  3. Mark it as active.
  4. Replace the placeholders in the credentials and configuration fields, using your own Bot User OAuth Token in the BotApiToken field. You can find the BotUsername in the App Home screen of https://api.slack.com/apps/.
  5. IconEmoji is an emoji that is available on your Slack app.
  6. Select Save.
{
   "BotApiToken": "{{bot_user_oauth_token}}",
   "BotUsername": "{{slack_app_username}}"
}

{
   "IconEmoji": ":{{slack_emoji_name}}:"
}

Promotion channel configuration

Note: Use the default name for your BotUsername. In the example screen, it is my_interact_intranet.

App Home default name

You can now promote a page to a Slack channel.

Promote dialog showing Slack

Promoted page in Slack

Section: Integrations