This is unreleased documentation for Rasa & Rasa Pro Documentation Main/Unreleased version.
For the latest released documentation, see the latest version (3.x).
Connecting a bot to Slack requires you to configure it to send messages (using API credentials) and to receive messages (using a webhook).
Create a new file
credentials.yml in the root folder of your Rasa
project (if you've used
rasa init this file should already exist and you can
just edit it). Add the following lines to the file:
slack_channel can be a channel or an individual person that the bot should
listen to for communications, in addition to the default behavior of listening
for direct messages and app mentions, i.e. @app_name.
To get a channel id, right click on the channel in Slack and choose Copy Link.
The id will be the last component in the URL.
In the next couple steps, you'll create a Slack App to get the values for
To create the app go to Your Apps and click on Create New App.
Fill out your App Name and select the Development Workspace where you'll play around and build your app.
Head over to OAuth & Permissions and scroll down to Scopes. Scopes give your app permission to do things in your workspace.
To get started, you should at least add the following scopes:
In Slacks API documentation you can find a list and explanation of all available scopes.
On the OAuth & Permissions page, click Install App to Workspace to add the bot to your workspace.
Once added, Slack will show you a Bot User OAuth Access Token which you'll need to add to your
credentials.ymlas the value for
slack_token:credentials.ymlslack:slack_channel: "your-channel" # choose a channel for your botslack_token: "xoxb-XXX" # token obtained in the next stepslack_signing_secret: "YYY" # secret obtained in the next step
The token should start with
Head over to Basic Information to gather the Signing Secret.
Copy the signing secret into your
credentials.ymlas the value for
slack_signing_secret:credentials.ymlslack:slack_channel: "your-channel" # choose a channel for your botslack_token: "xoxb-XXX" # token obtained in the next stepslack_signing_secret: "YYY" # secret obtained in the next step
This setup will allow your bot to send messages. Now let's head over to the setup for receiving and reacting to messages.
Before continuing, make sure you have configured a Slack App for Sending Messages and have added Slack credentials to your
To receive messages, you will need a publicly available URL for Slack to reach your bot and tell you about new messages. If you are running locally, you can test channels using ngrok
To configure your bot to receive messages, your bot needs to be running. Start your bot e.g. usingrasa run
If you are running locally, make sure ngrok (or another tool to retrieve a public url) is running as well.
To send messages directly to your bot using the slack UI, head to App Home, scroll to the bottom and select the checkbox for
Allow users to send Slash commands and messages from the messages tab.
You might have to quit the Slack app and re-open it before your changes take effect.
Configure the webhook by heading to Event Subscriptions and turning Enable Events on.
As a request URL enter the public url of your bot and append
<host>with your URL. If you are using ngrok, your url should look like
You won't be able to use a
As a last step, you'll need to Subscribe to bot events on the same page. You'll need to add the following events:
Make sure to hit Save Changes at the bottom of the page after you've added these events.
(If you didn't grant all required permissions to your app while setting up sending of messages, you'll be prompted to reinstall your app which you will need to do. Otherwise, Slack will confirm your change with a Success!)
invite to channels
As per Slack docs, make
sure you invite your bot to a channel it should be accessing. You can do this
/invite in the channel.
Your bot is now ready to go and will receive webhook notifications about new messages.
Optional: Interactive Components
After you've completed Sending Messages and Receiving Messages your bot is ready to go. If you want to use Slack's interactive components (buttons or menus), you'll need to do some additional configuration:
Open the Interactivity & Shortcuts page and toggle Interactivity to be on.
Afterwards, you'll need to enter the same url into the Request URL field which
you used in Step 2 of Receiving Messages, e.g.
Additional Slack Options
Here is a complete overview of all the configuration parameters for the Slack connection:
Make sure to restart your Rasa server after changing the
credentials.yml for the changes to take effect.