Slack Integration
The Slack integration connects a Slack App (bot user) to an agent. Once configured, the agent receives messages sent in Slack channels or direct messages and replies using the bot token.
Prerequisites
You need a Slack App with a Bot User. From your Slack App configuration page you will need:
| Credential | Where to find it |
|---|---|
| Bot Token | OAuth & Permissions → Bot User OAuth Token (xoxb-...) |
| Signing Secret | Basic Information → App Credentials → Signing Secret |
Setup
1. Link the Slack App to an agent
In the agent settings, go to the Integrations tab and select Slack. Enter your Bot Token and Signing Secret, then save.
2. Configure the webhook URL in Slack
Copy the webhook URL shown after saving and paste it into your Slack App’s Event Subscriptions page as the Request URL. Slack will send a verification challenge automatically — the integration handles this for you.
3. Subscribe to events
In the Slack App’s Event Subscriptions, subscribe at minimum to the message.channels and/or message.im bot events so the agent receives user messages.
Once done, the agent will respond to messages in any channel or DM where the bot is present.
Workflow Node
The Slack workflow node lets a workflow send a message to a Slack channel or user from within an automation.
| Input | Required | Description |
|---|---|---|
channel | One of channel/user | Channel name (e.g. #general) or channel ID |
user | One of channel/user | User ID (e.g. U1234567890) or @username |
message | Yes | The text to send |
botToken | No | Bot token override; uses the agent’s default if omitted |
blocks | No | JSON array of Slack Block Kit blocks for rich formatting |