# Slack
URL: https://docs.clearly-ai.com/docs/integrations/communication/slack
Description: Connect Clearly AI to Slack.
## Getting started [#getting-started]

If your IT team manages Slack app installation, share the Clearly AI Slack app manifest with them. The manifest is the source of truth for the bot permissions and event subscriptions the integration requires.

### Required bot scopes [#required-bot-scopes]

These are the required bot scopes from the Slack app manifest under `oauth_config.scopes.bot`:

| Scope               | Purpose                            |
| ------------------- | ---------------------------------- |
| `channels:join`     | Join public channels when needed   |
| `chat:write`        | Send messages                      |
| `files:read`        | Read shared files                  |
| `links:read`        | Read links in messages             |
| `app_mentions:read` | Read app mentions                  |
| `channels:history`  | Read messages in public channels   |
| `channels:read`     | Read public channel metadata       |
| `groups:history`    | Read messages in private channels  |
| `im:history`        | Read direct messages               |
| `im:write`          | Send direct messages               |
| `mpim:history`      | Read group direct messages         |
| `mpim:read`         | Read group direct message metadata |
| `reactions:read`    | Read reactions                     |
| `reactions:write`   | Add reactions                      |
| `users:read`        | Read user profiles                 |
| `users:read.email`  | Read user email addresses          |

### Required bot events [#required-bot-events]

These are the required bot events from the manifest under `settings.event_subscriptions.bot_events`:

* `app_mention`
* `message.channels`
* `message.im`
* `reaction_added`

### Request URL [#request-url]

The event subscription request URL is the Slack integration's webhook URL. To find it in Clearly AI, open **Organization settings**, select **Integrations**, click **Configure** on the Slack card, open the **Webhooks** tab, click **Edit webhook**, and copy the **Webhook URL**. In the manifest, it goes under `settings.event_subscriptions.request_url`.

### Notes for admins [#notes-for-admins]

* The required scopes are the bot scopes listed in the manifest. They are not user scopes.
* If your IT team manages Slack app approvals through Okta or another identity layer, they should still use the Slack manifest as the source of truth for requested permissions.
* To get the full Slack app manifest, click **Export Slack manifest** in the same webhook dialog. The exported manifest already sets the webhook URL as the request URL.

## Related [#related]

* [Integrations](https://docs.clearly-ai.com/docs/integrations) - Auth patterns and credential scope