> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botcadence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Send automation notifications and agent messages to Slack members or channels

Slack on **Integrations** connects a small helper account, called a **bot**, so Botcadence can send private messages and channel messages. Use it for **Automations** and the **Send Slack** agent tool.

This is not inbound Slack chat. To receive workspace messages in Conversations, connect **Slack** under [Channels](https://docs.botcadence.com/docs/deploy/channels/slack.md).

> [!WARNING]
>
> Paste a **Bot User OAuth Token** that starts with `xoxb-`. This is not Slack Sign-in for the dashboard. Do not share the token or include it in screenshots.

## Prerequisites

* Permission to create a Slack app and install it to the workspace
* These bot scopes: **chat:write**, **im:write**, **users:read**, **channels:read**, and **groups:read** (needed for private channels)
* The bot invited into every channel you want to post in

## Get a Bot User OAuth Token

Slack’s create-app screens change over time. The steps below match the current **Create New App** flow (including **AI agent**). If you already have an app, open it and jump to **OAuth & Permissions**.

**1. Open Slack apps**

Go to [https://api.slack.com/](https://api.slack.com/). If you land on developer docs instead of Your Apps, select **Manage Apps**.

![Slack developer docs with Manage Apps in the top right](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-01-manage-apps.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=eef6afd29cc9dc8cfa5abfd6c234952d)

Manage Apps on Slack developer docs

**2. Create a new app**

On **Your Apps**, select **Create New App**.

![Slack Your Apps page with Create New App](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-02-create-new-app.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=32f3d50a9949483e077d4d6630e20084)

Your Apps

**3. Choose how to create the app**

Slack asks how you want to create the app. Select **AI agent** (or **From scratch** / **From a manifest** if that is what you use), then continue.

![Create new app dialog with AI agent selected](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-03-app-type.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=19fff8e6ac278ce6b0ebd3b87fe1d2ef)

Create new app

**4. Name the agent and pick a workspace**

Enter an agent name and select the **Workspace** where Botcadence should post. Continue.

![Create AI agent form with name and workspace](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-04-agent-name-workspace.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=805f3455e75c48be593ce40954db8c42)

Create AI agent

**5. Create and install**

Review the agent, then select **Create and Install**. Approve the install in Slack when prompted.

![Review your AI agent with Create and Install](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-05-review-create-install.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=cf02328116ef4ff0f37a66489ca67ffc)

Review your AI agent

**6. Open OAuth & Permissions**

In the app sidebar under **Features**, select **OAuth & Permissions**.

![Slack app Basic Information with OAuth and Permissions in the sidebar](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-06-oauth-permissions.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=caf3ed8230c962e1aa9ca7fef6ce2a20)

OAuth & Permissions

**7. Add bot token scopes**

Under **Bot Token Scopes**, add these scopes if they are missing:

* **channels:read** — list public channels
* **chat:write** — post messages
* **groups:read** — list private channels
* **im:write** — send direct messages
* **users:read** — list workspace members

An AI-agent template may add extra scopes. That is fine. Botcadence still needs these five.

![Bot Token Scopes list including chat write, im write, users read, channels read, and groups read](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-07-bot-token-scopes.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=5fca8b5b6b8d09085515d3baf0ce19dd)

Bot Token Scopes

**8. Install and copy the token**

Scroll to **OAuth Tokens**. Install the app to the workspace (or **Reinstall** after you change scopes). Copy **Bot User OAuth Token**. It starts with `xoxb-`.

![OAuth Tokens section with Bot User OAuth Token and Copy](https://mintcdn.com/botcadence-a5dbc408/AeM72HIu2MFiWmUh/images/slack-oauth-08-bot-user-oauth-token.png?fit=max\&auto=format\&n=AeM72HIu2MFiWmUh\&q=85\&s=cd71bb2dd0bba015d2e5ed142dff7149)

Bot User OAuth Token

## Connect in Botcadence

**1. Open Add Integration**

In the project sidebar, select **Integrations**, then **Add Integration**. Select **Connect** on the **Slack** card.

**2. Paste the bot token**

On **Connect Slack**, paste **Bot User OAuth Token**. Keep this secret.

**3. Wait for validation**

The wizard checks the token. When it succeeds, you see **Slack Connected!**

## Verify

On **Integrations**, the row shows **Connected**.

> [!TIP]
>
> On an automation, pick this Slack connection, choose a member or a channel, and trigger a test. Confirm the DM or channel message arrives, and that the bot is in that channel.

## Use it

### Automations

Open **Automations**, enable Slack on the rule, select **Slack integration**, then choose **member** or **channel** and pick the destination. Invite the bot to the channel before the first post.

### Agent tool

Enable [Send Slack](https://docs.botcadence.com/docs/build/workflows/tools/send-slack.md) on chat **AI Configuration** or a workflow **Tools** tab. Select this Slack integration and a default **member** or **channel**. The agent can send to that default, or to another member or channel when the conversation needs it.

## Limits

* **Integrations Slack** sends outbound messages. **Channels Slack** is the inbox. You may need both.
* Posting to a channel fails if the bot is not a member of that channel.
* A revoked token or missing scope fails validation or sending until you paste a new token with the required scopes.

## Troubleshooting

> **Token validation fails**
>
> Confirm the token starts with `xoxb-` and the app is installed. Recopy the token. After you add scopes, **Reinstall** the app, then paste the new token.

> **Install is missing or OAuth Tokens is empty**
>
> Complete **Create and Install**, or select **Install to Workspace** on **OAuth & Permissions**. You need permission to install apps in that workspace.

> **Insufficient permissions**
>
> Add the five bot scopes, reinstall the app, and paste the updated token into Botcadence.

> **Channel messages never appear**
>
> Invite the bot into the channel. Private channels need **groups:read** and a bot membership.

> **I connected Slack under Channels but automations cannot send**
>
> Add Slack on **Integrations** with a bot token. Channel Slack does not replace the bot connection.

> **The agent cannot send Slack**
>
> Enable **Send Slack**, select this integration, and choose a default member or channel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.