The official Slack integration allows members of your Slack workspace to chat with your bot via a Slack app.

​
Setup

You will need:
  1. In Botpress Studio, select Explore Hub in the upper-right corner.
  2. Search for the Slack integration, then select Install Integration.
  3. In the Configuration menu, select Authorize Slack.
  4. Follow the instructions to connect Botpress to your Slack account.

​
Options

The Slack integration’s Configuration menu offers a few additional options:

​
Custom display name / avatar

  • Fill in the Bot name field to display a custom name as the sender in Slack conversations.
  • Fill in the Bot avatar URL field to set a custom image as the bot’s Slack avatar.
The image should be square, at least 512x512 pixels, and no larger than 1024x1024 pixels. The URL must be publicly accessible. Supported formats include GIF, PNG, JPG, JPEG, HEIC, and HEIF.

​
Typing indicator emoji

When the Typing indicator emoji option is enabled, the bot will react to incoming messages with an emoji to indicate that it’s processing the message.

​
Reply threading

When the Reply Threading Enabled option is enabled, the bot will reply to incoming messages in threads. If you want the bot to only reply in a thread when mentioned, enable the Require Bot Mention for Reply Threading option.

​
Limitations

Here are some limitations with the Slack integration:

​
API rate limits

Standard Slack API limits apply to the Slack integration in Botpress. These include rate limits, message size restrictions, and other constraints imposed by the Slack platform. Ensure that your bot adheres to these limits to maintain optimal performance and reliability.
For more information, check out the Slack API documentation.

​
Rich text processing

Slack uses a proprietary markup language, mrkdwn, to format rich text in messages. Since Botpress uses standard Markdown for rich text, we convert incoming mrkdwn messages from Slack to Markdown. This is to ensure that:
  • Studio’s interface can read them properly
  • Botpress’ AI inference engine can understand them
However, any outgoing AI-generated messages your bot sends to the Slack integration will still be rendered in Markdown by default. This means rich text messages from your bot may not be rendered properly in Slack without additional processing.