> ## 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

> Connect Slack so workspace messages appear in Conversations

The Slack **channel** is inbound chat from a Slack workspace. Customers (or teammates) message the app; threads appear in **Conversations**.

This is not [Slack on Integrations](/docs/build/integrations/slack). That bot token is for **Automations** and **Send Slack**. To generate the **Bot User OAuth Token**, follow the Integrations walkthrough. You may need both: Integrations to notify Slack, Channels to read Slack into the inbox.

## Prerequisites

* A Slack app installed to the workspace
* **Bot Token** and **Signing Secret** from the Slack app
* Grant **files:read** so inbound attachments can be stored
* Permission to create channels

## Connect

<Steps>
  <Step title="Open Channels">
    In the project sidebar, select **Channels**. Select **Slack**.
  </Step>

  <Step title="Configure Slack">
    Enter **Bot Token** and **Signing Secret**.
  </Step>

  <Step title="Set the workspace name">
    Enter **Slack Workspace Name** as the channel identifier when the create form asks for it.
  </Step>

  <Step title="Create">
    Create the channel. Invite the Slack app to the channels you want the agent to see.
  </Step>
</Steps>

## Verify

<Check>
  Message the app in Slack. The thread appears in [Conversations](/docs/operate/conversations).
</Check>

## Use it

Inbound Slack uses this channel's workflow. Outbound posts from automations still need the Integrations Slack connection.

## Limits

* Signing secret must match the Slack app that issued the bot token.
* Private channels require the app to be invited.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Slack events fail signature checks">
    Recopy **Signing Secret** from the same Slack app as the bot token.
  </Accordion>

  <Accordion title="No messages in Conversations">
    Confirm event subscriptions / Request URL in Slack point at this project, the app is in the channel, and this Channels Slack row is enabled.
  </Accordion>

  <Accordion title="Automations cannot post">
    Connect Slack under **Integrations** as well. Channel Slack does not replace that bot connection.
  </Accordion>
</AccordionGroup>