Slack

Bring your agent into Slack so your team can interact with it in any channel.

How it works

Your agent connects to Slack using Socket Mode, which means it listens for messages in real-time without needing a public URL. The setup wizard in your dashboard walks you through the full process step by step.

Setup

Click Configure on the Slack card in your dashboard to open the setup wizard. It will guide you through four steps:

Create a Slack App — go to api.slack.com/apps, create from scratch, name it, and select your workspace.
Enable Socket Mode — toggle Socket Mode on and create an App-Level Token with the connections:write scope. Paste the token (starts with xapp-) into the wizard.
Bot Permissions & Events — add the required scopes and event subscriptions, install to your workspace, then paste the Bot User OAuth Token (starts with xoxb-).
Connect — confirm your tokens and click Connect. Your agent will come online in Slack within a few seconds.

Required scopes

These Bot User OAuth Token Scopes are added in OAuth & Permissions:

app_mentions:read
channels:history
chat:write
groups:history
im:history
im:read
im:write
mpim:history

Required events

These are subscribed under Event Subscriptions → Subscribe to bot events:

app_mention
message.channels
message.groups
message.im
message.mpim

Messages Tab

Go to App Home and under Messages Tab, check Allow users to send Slash commands and messages from the messages tab. This lets users DM your agent directly.

Using your agent in Slack

Invite the bot to any channel where you want it to participate.
Mention the bot with @name to get its attention.
In DMs, the bot responds to every message.