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

# Slack integration

> Add the SiteGPT app to Slack and get instant AI answers in channels, threads, and DMs

Connect your SiteGPT chatbot to Slack with one click. The bot answers questions in the channels you invite it to, responds to mentions and DMs, hands conversations to humans on demand, and cross-posts escalations to the channel you choose — all from the official SiteGPT Slack app, with no app creation or tokens.

## How it works

<CardGroup cols={2}>
  <Card title="One-click install" icon="bolt">
    Add the official SiteGPT app from your dashboard — no custom app, no manifest, no tokens
  </Card>

  <Card title="Channels, threads, and DMs" icon="message">
    Answers in invited channels, on @mentions anywhere, and in direct messages
  </Card>

  <Card title="Reaction workflows" icon="face-smile">
    React with ❓ to summon the bot into any thread, ✅ to hand it to a human
  </Card>

  <Card title="Escalation channel" icon="bell">
    Escalated conversations cross-post to the channel you pick during install
  </Card>
</CardGroup>

## Prerequisites

<Check>Permission to install apps in your Slack workspace</Check>
<Check>A trained SiteGPT chatbot ready to deploy</Check>

## Setup

<Steps>
  <Step title="Add to Slack">
    Navigate to **Integrations** in your SiteGPT dashboard, open the **Slack** card, and click **Add to Slack**.

    Slack shows its standard authorization screen listing the app's permissions.
  </Step>

  <Step title="Choose your escalation channel">
    On the authorization screen, Slack asks where the app may post — pick the channel that should receive **escalation notifications** (for example `#support`). When a conversation escalates to a human, the bot cross-posts it there.

    Click **Allow**. You're redirected back to SiteGPT with the integration connected.
  </Step>

  <Step title="Invite the bot to channels">
    The bot only sees messages in channels it's a member of. In each channel where you want automatic answers:

    ```
    /invite @SiteGPT
    ```

    The bot posts a short intro explaining how to work with it whenever it joins a channel.
  </Step>

  <Step title="Test it">
    Ask a question in an invited channel. The bot replies in a thread with an answer and source citations.
  </Step>
</Steps>

## Ways to use the bot

<Tabs>
  <Tab title="Invited channels" icon="hashtag">
    In any channel the bot has joined, it answers every question automatically, replying in a thread with source citations. Great for support and internal-knowledge channels.
  </Tab>

  <Tab title="Mentions" icon="at">
    Mention the bot anywhere it's a member:

    ```
    @SiteGPT How do I reset my password?
    ```

    It answers in the message's thread, keeping the channel tidy.
  </Tab>

  <Tab title="Direct messages" icon="message">
    Open the bot under **Apps** in your Slack sidebar and ask questions privately. Useful for sensitive questions or quick personal lookups.
  </Tab>

  <Tab title="Reactions" icon="face-smile">
    Two reaction workflows work on any message in a channel the bot has joined:

    * **Summon**: react with ❓ (also 🎫 or 🆘) and the bot reads the thread and answers on demand — even in threads it wasn't part of.
    * **Hand to a human**: react with ✅ and the bot goes silent in that thread so a person can take over. The takeover is visible in your SiteGPT dashboard. React with ❓ to bring the bot back.
  </Tab>
</Tabs>

## How the bot behaves

* Replies in threads with source citations
* Renders tables from your knowledge base as aligned grids (or a field-by-field layout for wide tables)
* Maintains conversation context within each thread
* Cross-posts escalated conversations to your chosen escalation channel
* Posts a short how-to intro when it joins a channel
* Syncs every conversation to your SiteGPT **Chat History**

## Permissions

The app requests bot-only scopes — it can never read messages as you:

| Scope                                              | Why                                                       |
| -------------------------------------------------- | --------------------------------------------------------- |
| `app_mentions:read`                                | See when the bot is mentioned                             |
| `chat:write`                                       | Post answers                                              |
| `channels:history`, `groups:history`, `im:history` | Read messages in channels it's invited to and its own DMs |
| `channels:read`, `groups:read`                     | Resolve channel names for intros and takeovers            |
| `reactions:read`                                   | Power the ❓ / ✅ reaction workflows                        |
| `incoming-webhook`                                 | Post escalations to the channel you picked at install     |

## Managing the integration

<Tabs>
  <Tab title="Monitor" icon="chart-line">
    Open **Chat History** in SiteGPT to review Slack transcripts, spot common questions, and export conversation data.
  </Tab>

  <Tab title="Update your bot" icon="arrows-rotate">
    Training data, instructions, and settings changes apply to Slack immediately — no reconnection needed.
  </Tab>

  <Tab title="Disconnect" icon="plug">
    Open **Integrations** in SiteGPT, click **Manage** next to Slack, then **Disconnect**. You can also remove the app from Slack's workspace settings — SiteGPT detects the uninstall and cleans up.
  </Tab>
</Tabs>

## Next steps

<CardGroup cols={2}>
  <Card title="Human support" icon="user-headset" href="/docs/features/human-support">
    Configure when conversations escalate
  </Card>

  <Card title="Lead collection" icon="address-book" href="/docs/features/lead-collection">
    Capture leads from Slack conversations
  </Card>

  <Card title="Webhooks" icon="webhook" href="/docs/developers/webhooks">
    Receive real-time conversation notifications
  </Card>

  <Card title="Chat history" icon="messages" href="/docs/navigating-your-chatbot/chat-history">
    Review and analyze Slack conversations
  </Card>
</CardGroup>