# Slack

> Connect Slack to let your agent answer in channels and DMs, and to receive notifications about escalations and events. Covers the bot token, scopes, and the Events API.

The Slack integration brings Bookbag into your team's Slack. There are two complementary use cases: your agent **answering** questions inside Slack, and Bookbag **notifying** Slack when something happens (like an escalation).

## Answering in Slack

Connecting Slack as a [channel](/docs/deploy/slack) lets the agent reply in DMs, in channels it's invited to, and on @-mentions. You provide a **Bot User OAuth token** and register Bookbag's inbound URL with the Slack Events API; Slack's URL-verification handshake is answered automatically.

| You provide | Used for |
| --- | --- |
| Bot User OAuth token | Sending replies via Slack's `chat.postMessage`. |
| Events API request URL | Delivering inbound messages to Bookbag. |
| Default channel (optional) | Where to post when no originating channel applies. |

> **RECOMMENDED BOT SCOPES:** Grant `chat:write` for replies, and subscribe to `message.channels`, `message.im`, and `app_mention` events so the agent hears DMs, channel messages, and mentions.

## Notifications to Slack

You can also use Slack purely as a destination for events — for example, post a message when a lead is captured or a conversation escalates. Pair an [outbound webhook](/docs/integrations/webhooks) with a Slack incoming webhook, or route through [Zapier](/docs/integrations/zapier) for no-code notifications.

## Connect Slack

1. **Create and install a Slack app** — At api.slack.com/apps, create an app, add a bot user with the scopes above, and install it to your workspace to get the bot token.
2. **Connect in Bookbag** — On the agent's Deploy tab, open the Slack card and paste the bot token.
3. **Register the Events API URL** — Set your app's Event Subscriptions request URL to the Slack inbound webhook shown on the channel card; Bookbag answers the verification automatically.

## What's next

- [Slack channel](/docs/deploy/slack) — Full setup for answering in Slack.
- [Webhooks](/docs/integrations/webhooks) — Send events to Slack or anywhere else.
- [Zapier](/docs/integrations/zapier) — No-code Slack notifications.