This is documentation for Rasa Documentation v2.x, which is no longer actively maintained.
For up-to-date documentation, see the latest version (3.x).

Version: 2.x


You first have to create a mattermost app to get credentials. Once you have them you can add these to your credentials.yml.

Getting Credentials

Mattermost now uses bot accounts for better security. So you can use their guide to create your bot to get your token required for the credentials.yml file.

For more information on creating a bot account please see Bot Creation.

For information on converting existing user account into bot account please see User Conversion.

How to set up the outgoing webhook:

  1. To create the Mattermost outgoing webhook, login to your Mattermost team site and go to Main Menu > Integrations > Outgoing Webhooks.

  2. Click Add outgoing webhook.

  3. Fill out the details including the channel you want the bot in. You will need to ensure the trigger words section is set up with @yourbotname so that the bot doesn't trigger on everything that is said.

  4. The Content Type must be set to application/json.

  5. Make sure trigger when is set to value first word matches a trigger word exactly.

  6. Add the Callback URL, which will look like http://<host>:<port>/webhooks/mattermost/webhook, replacing the host and port with the appropriate values from your running Rasa X or Rasa Open Source server.

For more detailed steps, visit the Mattermost docs.

Running on Mattermost

Add the Mattermost credentials to your credentials.yml:

url: ""
token: "xxxxx" # the token for the bot account from creating the bot step.
webhook_url: "" # this should match the callback url from step 6

Restart your Rasa X or Rasa Open Source server to make the new channel endpoint available for Mattermost to send messages to.