Skip to main content

Slack

Messaging channels

Requirements​

Create a Slack App​

You will need a Slack App to connect your bot to Slack

  1. Go to your apps page
  2. Click Create new app, select From scratch then give it a name. Remember your App's name, you'll need it in a few minutes

Channel Configuration​

Signing Secret​

The signing secret is used to verify webhook requests

  1. In the left sidebar, click on Settings > Basic Information
  2. Scroll down to App Credentials section. Copy paste the value of the signing secret to the Signing Secret channel configuration

Bot Token​

The bot token is used to authenticate requests made to the Slack API

  1. In the left sidebar, click on Features > OAuth & Permissions
  2. Add chat:write under the Scope > Bot Token Scopes section
  3. Click on Install to Workspace in the OAuth Tokens for Your Workspace section
  4. Copy paste the value in Bot User OAuth Token to the Bot Token channel configuration

Save Configuration​

Channel configuration is complete, you can now click Save. It is important you save your configuration before configuring the webhooks, otherwise Slack will be unable to validate the webhook url

Webhook Configuration​

Events Webhook​

Slack sends regular events such as messages to the event webhook

  1. In the left sidebar, click on Features > Event Subscriptions
  2. Turn on events by click the On/Off button
  3. Under Subscribe to bot event, add message.im and message.channels
  4. Copy paste the webhook url provided in the channel configuration UI to the Request URL field
  5. Click the Save Changes button. Make sure your slack channel configuration is saved before doing this step, otherwise webhook validation will fail
  6. A yellow banner will be displayed at the top of the screen. Click the reinstall your App link

Interactivity Webhook​

Slack sends "interactive" events such as reactions to message to the interactivity webhook

  1. In the left sidebar, click on Features > Interactivity & Shortcuts
  2. Turn on interactivity by click the On/Off button
  3. Copy paste the webhook url provided in the channel configuration UI to the Request URL field
  4. Click the Save Changes button

Install App​

Add App to Workspace​

Your slack app needs to be added to your workspace to allow Slack users to communicate with it

  1. In the left sidebar, click on Features > App Home
  2. Scroll down and tick Allow users to send Slash commands and messages from the messages tab
  3. In Slack, under the Apps section of the sidebar, click the + Add apps button. In the search bar, type the name of your Slack app. Click on your Slack app in the search results. You can now chat with your Slack App

Connecting with Botpress Cloud​

Messaging channels

  1. Paste your Signing Secret and Bot Token and enable the channel.
  2. Click save and send message to your bot on slack.