Slack

Overview

You can connect an agent to a Slack workspace, allowing users to interact with it directly from Slack. Once connected, the agent responds to messages sent in the configured channel or via direct message.

Prerequisites

Before connecting, you need a Slack app with the following:

• A Bot User OAuth Token (starts with xoxb-)
• A Signing Secret from the Slack app settings

To create a Slack app and retrieve these credentials:

1. Go to api.slack.com/apps  and create a new app.
2. Under OAuth & Permissions, install the app to your workspace and copy the Bot User OAuth Token.
3. Under Basic Information, copy the Signing Secret.

Connecting Slack to an Agent

1. Open the agent you want to connect.
2. Go to the Integrations tab.
3. In the Slack Integration card, click Connect.
4. Enter the following credentials:
   • Bot User OAuth Token — the xoxb-... token from your Slack app.
   • Signing Secret — from your Slack app’s Basic Information page.
5. Click Connect Slack.

Once connected, the card shows the bot ID and team ID confirming the connection.

Disconnecting

To remove the Slack integration from an agent:

1. Open the agent’s Integrations tab.
2. In the connected Slack card, click Disconnect.
3. Confirm the action. All Slack credentials are removed and the integration is disabled.