Slack
Slack API integration for messaging, channels, and workspace management
The Slack integration lets your agents send messages, read channel history, search messages, and manage workspace interactions.
Prerequisites
You need one of the following:
- Slack Bot Token (
xoxb-) — Create a Slack App at api.slack.com/apps, add the required bot scopes (e.g.,channels:read,chat:write,users:read), and install it to your workspace. - OAuth — For user-level access. Supports both bot scopes and user scopes, so the agent can act on behalf of individual users.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Slack from the integration list
- Give the config a display name (e.g., "Slack - Company Workspace")
- Choose your authentication method:
- Bot Token — Paste your
xoxb-token - OAuth — Click Connect to start the Slack OAuth flow. You'll be redirected to Slack to authorize access. Per-tool scopes ensure the agent only requests the permissions each tool needs.
- Bot Token — Paste your
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Slack tools from the tools panel
- The agent uses your integration config for all Slack API calls
- Tools are referenced as
slack.send_message,slack.list_channels, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_channels | List public and private channels in the workspace | ReadOnly |
get_channel_history | Retrieve message history from a Slack channel | ReadOnly |
send_message | Send a message to a Slack channel | Irreversible |
reply_to_thread | Reply to a message thread in Slack | Irreversible |
list_users | List all users in the Slack workspace | ReadOnly |
get_user_info | Get detailed information about a Slack user | ReadOnly |
search_messages | Search for messages across the workspace | ReadOnly |
add_reaction | Add an emoji reaction to a message | Reversible |
upload_file | Upload a text snippet or file content to a channel | Irreversible |