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

# Deploy Agent to Slack

> Deploy your Agent to Slack so your team can chat with it directly in channels and DMs.

Deploy your [Agent](/agents/overview) to Slack so team members can chat with it in channels and direct messages — no need to leave their daily communication tool.

<Info>
  **Prerequisites**:

  * An [Agent created in Cassidy](/agents/build-and-configure)
  * Admin access to your Slack workspace
</Info>

## Set up the deployment

<Steps>
  <Step title="Select your Agent">
    Navigate to **Agents** in the sidebar and click the Agent you want to deploy. You can also open the more options menu (**...**) and select **Edit**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-0.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=ca524c772842570a47894549e4d1774c" alt="Agents page showing a list of available Agents" width="2424" height="966" data-path="images/integrations/deploying-agents-to-slack-img-0.png" />
    </Frame>
  </Step>

  <Step title="Open the Deployments tab">
    In your Agent's settings, click the **Deployments** tab.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-1.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=6149da0ad706d8ae025f9ca67ef3f4a1" alt="Agent settings with the Deployments tab highlighted" width="2490" height="1186" data-path="images/integrations/deploying-agents-to-slack-img-1.png" />
    </Frame>
  </Step>

  <Step title="Configure Slack display name and description">
    Adjust the **Slack Display Name** and **Description** for how the Agent appears in Slack. Click **Next** when you're ready.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-2.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=b9deae7b34c74313bb4df59217e6883b" alt="Slack display name and description fields in deployment settings" width="1676" height="954" data-path="images/integrations/deploying-agents-to-slack-img-2.png" />
    </Frame>
  </Step>

  <Step title="Copy the app manifest">
    Click **Copy** to copy the app manifest provided by Cassidy. You'll paste this into Slack in the next step.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-3.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=b8ce829cc72a2b16bd47d272200353a4" alt="App manifest ready to copy in the Cassidy deployment dialog" width="1654" height="930" data-path="images/integrations/deploying-agents-to-slack-img-3.png" />
    </Frame>
  </Step>

  <Step title="Create a new Slack app">
    Go to [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-4.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=45df9c877ab462ed4c969690d08115ad" alt="Slack API apps page with the Create New App button" width="2528" height="726" data-path="images/integrations/deploying-agents-to-slack-img-4.png" />
    </Frame>
  </Step>

  <Step title="Choose 'From a manifest'">
    Select **From a manifest**, then choose your organization's workspace and click **Next**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-5.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=ce472a16e557def35d3620a74d6b972b" alt="Slack app creation dialog with From a manifest option selected" width="1080" height="748" data-path="images/integrations/deploying-agents-to-slack-img-5.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-6.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=70f661d9453c0da828aced0461f6726e" alt="Workspace selector for the new Slack app" width="1084" height="746" data-path="images/integrations/deploying-agents-to-slack-img-6.png" />
    </Frame>
  </Step>

  <Step title="Paste the manifest">
    Paste the manifest you copied from Cassidy into the input area. Click **Next**, then **Create** to finish creating the Slack app.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-7.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=6f83785baca3c976b4d9e284f229bbc5" alt="Manifest input area in the Slack app creation flow" width="1106" height="1098" data-path="images/integrations/deploying-agents-to-slack-img-7.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-8.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=6cdc553111443e807eeb4ed425a05324" alt="Confirmation screen before creating the Slack app" width="1088" height="790" data-path="images/integrations/deploying-agents-to-slack-img-8.png" />
    </Frame>
  </Step>

  <Step title="Copy credentials from Slack">
    In your new Slack app's **Basic Information** page, copy the **App ID**, **Client ID**, **Client Secret**, and **Signing Secret**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-9.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=3319c345a1c5221495c70f9d6c429acc" alt="Slack app Basic Information page showing App ID, Client ID, Client Secret, and Signing Secret" width="2528" height="1750" data-path="images/integrations/deploying-agents-to-slack-img-9.png" />
    </Frame>
  </Step>

  <Step title="Paste credentials into Cassidy">
    Back in the Cassidy deployment dialog, paste each credential into the corresponding field and click **Next**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-10.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=c9cfbe2d13556a1c04dd0676fcffa23a" alt="Cassidy credential fields for App ID, Client ID, Client Secret, and Signing Secret" width="1678" height="1292" data-path="images/integrations/deploying-agents-to-slack-img-10.png" />
    </Frame>
  </Step>

  <Step title="Deploy to Slack">
    Click **Deploy to Slack** and complete the OAuth authorization to finish the connection.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-11.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=fe43dbab778dd8c67f1e6deb0c0c3a03" alt="Deploy to Slack button in the Cassidy deployment dialog" width="1662" height="966" data-path="images/integrations/deploying-agents-to-slack-img-11.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-12.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=6008f820aaf9c80f0520c465da3d0711" alt="Slack OAuth authorization screen for the deployed Agent" width="1196" height="1386" data-path="images/integrations/deploying-agents-to-slack-img-12.png" />
    </Frame>
  </Step>

  <Step title="Configure the response mode">
    Choose how the Agent responds in Slack:

    * **Always respond** — the Agent replies to every message in channels where it's added
    * **Respond when mentioned** — the Agent only replies when mentioned with @
    * **Only respond when mentioned** — the Agent replies when mentioned, even in ongoing threads

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-13.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=742cf811fcb3e4b30368d84806fb213f" alt="Response mode settings showing Always respond, Respond when mentioned, and Only respond when mentioned" width="1824" height="1200" data-path="images/integrations/deploying-agents-to-slack-img-13.png" />
    </Frame>
  </Step>
</Steps>

## Chat with your Agent in Slack

Once deployed, your team can interact with the Agent in two ways:

* **Direct messages** — start a new DM in Slack and search for the app by its display name. Send a message to begin a conversation. Each thread is a separate conversation.
* **Channel mentions** — in any channel, @ mention the Agent by its display name. Slack prompts you to invite the app to the channel on first mention. Once added, the Agent responds to messages based on the response mode you configured.

You can send images and files to the Agent in Slack just like you do when [chatting with Agents](/guides/chatting-with-an-agent) on Cassidy.

<Frame>
  <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-14.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=a4475f714896c20564a087e109d64b5a" alt="Agent responding to a message in a Slack channel" width="1202" height="1130" data-path="images/integrations/deploying-agents-to-slack-img-14.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-slack-img-15.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=9d43eb14214cd38ab215940afdefa2a1" alt="Agent replying in a Slack channel thread" width="2214" height="1630" data-path="images/integrations/deploying-agents-to-slack-img-15.png" />
</Frame>

## Remove the deployment

To remove the Agent from Slack, either delete the app directly in Slack or click **Remove from Slack** in the Cassidy deployment settings for that Agent.

## Next steps

<CardGroup cols={2}>
  <Card title="Import Slack channels to Knowledge Base" icon="book" href="/integrations/slack/knowledge-base">
    Give your Agent context from real Slack conversations.
  </Card>

  <Card title="Deploy via email" icon="envelope" href="/agents/deploy/email">
    Let users interact with your Agent by sending and receiving emails.
  </Card>

  <Card title="Trigger Workflows from Slack" icon="diagram-project" href="/integrations/slack/workflows">
    Automate actions when messages arrive in Slack channels.
  </Card>
</CardGroup>
