Slack

Dialogflow's Slack Integration makes it easy to create your own Slack apps and bots and train them to understand natural language.

Note: When using a third party integration, requests and end-user data are sent to both Google and the third party. The terms of service, SLA, pricing, and quotas for your agent edition are applicable for Google's handling of these requests. The third party's terms of service, SLA, pricing, and quotas are applicable for the third party's handling of these requests.

Limitations

Only the default agent language is supported by this integration.

Setting Up Slack

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

• a Slack account
• a Slack Team

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 OAuth & Permissions in the left hand menu
2. Go to Scopes section and make sure the following OAuth Scopes are in the Bot Token Scopes section
3. Click on App Home in the left hand menu
4. Enable Always Show My Bot as Online and edit App Dislay Name if needed (this is what users will see for your bot)

Enabling Integration in Dialogflow

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 ID, Client Secret, and Verification Token.

Link Slack to Dialogflow

1. In Dialogflow, go to Integrations in the left hand menu
2. Click on the Slack tile
3. Enter the related values into the following fields:
   1. Client ID
   2. Client Secret
   3. Verification Token
4. Click Start

Continuing Slack Setup

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

Add OAuth URL

1. Copy the OAuth URL from Dialogflow's Slack setting page

Note: If your Slack App is a classic Slack App and you haven't upgraded it yet, you will need to click Show URLs for legacy Slack workflow on Dialogflow's Slack setting page, and then copy the OAuth URL. Please see Quickstart: differences between old and new Slack apps for more information.

1. Go to the Slack Developer Console and click on OAuth & Permissions in the left hand menu
2. Click on the Add a new Redirect URL button and paste the OAuth URL
3. Click Add
4. Click Save URLs button

Add Event Request URL and Enable Event Subscriptions

1. Copy the Event Request URL from Dialogflow'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. 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. Under the Subscribe to events on behalf of users section, click the Add Workspace Event button to add the im_created event, then press Save Changes.

   

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

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 Workplace section, click the Add to Slack button
3. On the next page, click the Authorize button to add the agent

Testing

You can test your agent without creating a public Slack bot. To do so, go to the Integrations page for your agent and click the switch on the Slack tile. In the pop-up window, click the Test In Slack button.

You'll be prompted to log in to Slack. Once logged in, navigate to the instance and locate the bot user called @dialogflow-bot. You can direct message the agent to test it or add it to channels in your instance.

Note: In order to change the name of the agent or add a logo, you'll need to make the bot public.

Events

The following events are invoked by this integration:

Event	Description
SLACK_WELCOME	Triggered when a user starts a conversation with your Slack bot.

Rich response messages

The following rich response messages are supported.

Image responses

Supported formats and sizes:

• gif
• jpeg
• png
• bmp

Card responses

There are no mandatory fields for cards in Slack – any combination of elements can be used.

Buttons with a URL and with a text postback are supported. Buttons with a URL are displayed as hyperlinks.

Quick reply responses

Quick replies are supported in one-click Slack integrations and correspond to a text version of Slack interactive buttons.

Custom payload responses

Formatted text in one-click Slack integration

Your Slack bots can send formatted text, as the following example shows:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}