Slack Integration

Written by Hasan Rizvi
Posted On Aug, 01, 2018
Botsify's Slack Integration makes it easy to create your own Slack apps and bots and train them to understand natural language.

Setting Up Slack

In order to set up the Slack integration for your chatbot, you'll need the following:

Create a Slack App

  1. Navigate to the Slack Developer Console
  2. Enter a name for your app
  3. Choose a Team you would like the app associated with
  4. Click the Create App button




Add a Bot User

  1. Click on Bot Users in the left-hand menu
  2. Click the Add a Bot User button
  3. Enter a name for your Slack bot (this is what users will see when they add your bot)
  4. Enable Always Show My Bot as Online
  5. Click the Add Bot User button




Enabling Integration in Botsify

In the Slack Developer Console, click on Basic Information in the left-hand menu and scroll down to the App Credentials section. Make note of the Client IDClient Secret, and Verification Token.



Link Slack to Botsify

  1. In Botsify, go to Settings in the left-hand menu
  2. Click on the Platforms tab
  3. Turn on the toggle for Slack
  4. Enter the related values into the following fields:
    • Client ID
    • Client Secret
    • Verification Token
  5. Click Save




Continuing Slack Setup

Now that you've set up Slack and Botsify, you'll enable OAuth, Event Requests URLs (provided by Botsify) and Event Subscriptions.

Add OAuth URL

  1. Copy the OAuth URL from Botsify's Slack setting page
  2. Go to the Slack Developer Console and click on OAuth & Permissions in the left-hand menu
  3. Click on the Add a new Redirect URL button and paste the OAuth URL
  4. Click Add




Add Event Request URL

  1. Copy the Event Request URL from Botsify's Slack setting page
  2. Go to the Slack Developer Console and click on Event Subscriptions in the left menu
  3. Click on the switch to enable Events and paste the Event Subscription URL in to Request URL field. After a few moments you should see a green "Verified" above the Request URL field.



  4. Once you're done updating these two settings, click the Save Changes button at the bottom of the page.

Enable Event Subscriptions

  1. Click on Event Subscriptions in the left menu
  2. Click the switch to enable the option
  3. Under the Subscribe to Bot Events, click on the Add Bot User Event button. This will reveal text field and list of events. You can enter terms into this field to search for events you want your bot to respond to. Here's a list of events we suggest adding:
    Event Name Event Description
    message.im A message was posted in a direct message channel
    message.groups A message was posted to a private channel
    message.channels A message was posted to a channel
    im_created A DM was created




  4. Once you've added the events, click the Save Changes button at the bottom of the screen

Enable Interactive Components

  1. Click on Interactive Components in the left menu
  2. Click the switch to enable the option
  3. Copy the Interactivity Request URL from Botsify's Slack setting page and paste into Interactivity Request URL




Add Your Slack Bot to a Team

  1. In the Slack Developer Console, click on Manage Distribution in the left menu
  2. Under the Share Your App with Your Team section, click the Add to Slack button



  3. On the next page, click the Authorize button to add the agent