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

# ZeroDrift for Slack

> Connect a Slack workspace to ZeroDrift from Command. Install steps, who can use the app, how audits, schedules and live monitoring read Slack, limits, and how to disconnect.

ZeroDrift for Slack checks the messages people post in Slack against your workspace's active rules. It finds messages that break a rule and reports them. It never blocks, edits or removes a message.

**Connect it from ZeroDrift Command.** Open **Connections** in Command and connect Slack. That installs the app in your Slack workspace. The app is not in the Slack Marketplace, so you do not install it from there.

[![Add to Slack](https://platform.slack-edge.com/img/add_to_slack.png)](https://slack.com/oauth/v2/authorize?client_id=9536977023282.12636080981284\&scope=commands,app_mentions:read,chat:write,im:write,users:read,channels:read,groups:read,channels:history,groups:history,channels:join\&user_scope=channels:read,channels:history,groups:read,groups:history,im:read,im:history,mpim:read,mpim:history,users:read)

Sign in to ZeroDrift Command first. The button opens Slack's permission screen for the ZeroDrift app.

To send the install to someone else, such as a Slack admin, share the [install link](https://slack.com/oauth/v2/authorize?client_id=9536977023282.12636080981284\&scope=commands,app_mentions:read,chat:write,im:write,users:read,channels:read,groups:read,channels:history,groups:history,channels:join\&user_scope=channels:read,channels:history,groups:read,groups:history,im:read,im:history,mpim:read,mpim:history,users:read). They need to be signed in to ZeroDrift Command as an owner or admin.

The app is generally available, in all regions.

After you connect, try a [task guide](#next-steps).

## What it does

| Feature | What it does | Where you start it |
| - | - | - |
| **Audit** | Checks the recent messages of one channel or DM, once. | `/zerodrift` in Slack, or **New audit** in Command |
| **Schedule** | Runs the same audit on channels every day or every week. | The app's **Home** tab in Slack |
| **Live monitoring** | Checks each new message in the channels you pick, as it is posted. | The app's **Home** tab in Slack |

## Before you start

* A ZeroDrift workspace, and the **Owner** or **Admin** role in it. Only owners and admins can connect Slack, link their Slack account and run checks.
* Permission to install apps in your Slack workspace. If your Slack workspace requires app approval, a Slack admin must approve the app.
* For audits and schedules: a billing account set up in ZeroDrift Command, with a credit card added, under [Settings > Billing](https://app.zerodrift.ai/settings/billing). Audits are charged for each message checked, and an audit does not run without one. See [Pricing](https://docs.zerodrift.com/pricing.md).
* For live monitoring, an active API key in **Settings > API keys** in Command. Without one, live monitoring checks nothing.

A Slack workspace can be connected to one ZeroDrift workspace at a time.

## Connect Slack

**1. Open Connections**

In ZeroDrift Command, open **Connections**. Under **Enforcement surfaces**, find **Slack** and select **Connect**.

**2. Choose the Slack workspace**

Slack opens its permission screen in a new tab. Pick the Slack workspace at the top right if you belong to more than one.

**3. Review the notice and allow**

Slack shows an **App not approved by Slack** notice. This is expected: ZeroDrift distributes the app directly, not through the Slack Marketplace. Review what the app can view and do, then select **Allow**.

**4. Confirm**

The tab shows "Slack connected. ZeroDrift is installed in your Slack workspace." Close it. Back on **Connections**, the Slack row shows **Connected** and a **Manage** button.

**5. Open the app in Slack**

In Slack, open **Apps > ZeroDrift > Home**. The Home tab shows the Command account and workspace you are connected as, your recent runs, your schedules and the live monitoring channels.

The admin who connects Slack is linked automatically. To check the connection, type `/zerodrift help` in any channel.

### Link other admins

Each owner or admin links their own Slack account before they can use the app. In Slack, open **Apps > ZeroDrift > Home** and follow the link step there. The Home tab lists the other linked admins.

Anyone who is not a linked owner or admin and types `/zerodrift` sees: "Only ZeroDrift workspace admins can run validations from Slack."

When an owner or admin is demoted or removed in Command, their Slack link is removed and their schedules pause.

## How it works

The app reads Slack in two ways, and which one applies depends on the feature.

| | Reads as | Covers | Invite needed |
| - | - | - | - |
| **Audit with `/zerodrift`** | The admin's own Slack account | Public channels, private channels the admin is in, and the admin's DMs and group DMs | No |
| **Schedule, and New audit in Command** | The admin's own Slack account | Public channels and private channels the admin is in. No DMs. | No |
| **Live monitoring** | The ZeroDrift bot | Public and private channels you pick. No DMs. | Private channels only: `/invite @ZeroDrift` |

An audit reads with the account of the admin who starts it, so it can reach what that admin can already see in Slack and nothing more. Live monitoring reads with the bot. The bot joins a public channel itself when you pick it, and needs an invite to a private one.

ZeroDrift checks the text of posts and thread replies. It does not check files, attachments or posts from bots.

### Where results appear

* **Audits and scheduled runs:** ZeroDrift sends you a direct message in Slack when the run finishes, with a link to the audit. The run is also listed on the app's Home tab under **Your recent runs**, and under **Audits** in Command.
* **Live monitoring:** flagged messages appear in **Activity** in Command. Nobody is notified in Slack.

See [Read the Results](https://docs.zerodrift.com/guides/slack-app/read-results.md).

### What to expect

* **Detection only.** A message that breaks a rule is **Flagged**, never **Blocked**. It has already been posted, and ZeroDrift does not edit or remove it.
* **Your workspace's active rules.** Live monitoring checks against the rules active in your ZeroDrift workspace. Audits check against regulations only. Custom policies do not run in an audit yet.
* **A record, not a gate.** ZeroDrift tells you what was posted. It does not stop anyone from posting.

## Permissions the app requests

Slack asks you to approve two sets of permissions.

**Bot permissions:** `commands`, `app_mentions:read`, `chat:write`, `im:write`, `users:read`, `channels:read`, `groups:read`, `channels:history`, `groups:history` and `channels:join`. The last three are used only for live monitoring.

**User permissions**, for the admin who approves: `channels:read`, `channels:history`, `groups:read`, `groups:history`, `im:read`, `im:history`, `mpim:read`, `mpim:history` and `users:read`. Audits read with these.

## Limits

* **Detection only.** Nothing is blocked, edited or removed in Slack.
* **Audit window.** An audit covers up to the last 30 days.
* **Audits check regulations only.** Custom policies cannot run in an audit yet.
* **Audits take longer on busy channels.** Slack limits how fast an app outside the Marketplace can read message history. A long window or a busy channel takes longer to collect.
* **Schedules.** Up to 20 schedules for each Slack workspace, and up to 20 channels in each schedule.
* **Live monitoring.** Up to 50 channels. No DMs.
* **Schedules and live monitoring on the same channel check messages twice.** A message in a channel that has both is checked once when it is posted and again in the scheduled run.
* **Text only.** Files, attachments and bot posts are not checked.

## Data read and sent

| | |
| - | - |
| **What ZeroDrift reads** | The text of posts and thread replies in the conversations you choose, with the sender's ID and display name, the channel ID and name, the timestamp and the message link. No files or attachments. |
| **Audits and scheduled runs** | Only the message text is sent for scoring, to ZeroDrift's own model. |
| **Live monitoring** | Messages are checked through the ZeroDrift validation API, the same path as other API checks in your workspace. ZeroDrift's own model is used first. If it is unavailable, or your custom rules need it, the check uses your workspace's configured model provider. |
| **Audit downloads** | The download links work for 14 days after the audit ends. The audit workbook contains message text. This window covers the download files only. |
| **Live monitoring results** | Activity shows the flagged excerpt and the rules it broke, not the full message. |

Customer data is not used to train ZeroDrift or third-party AI models.

The retention schedule on [Data Retention](https://docs.zerodrift.com/data-retention.md) does not yet cover Slack message content. For how long ZeroDrift keeps Slack messages, and to ask for deletion, contact [support@zerodrift.ai](mailto:support@zerodrift.ai).

## Troubleshoot

| What you see | What to do |
| - | - |
| "App not approved by Slack" on the permission screen | Expected. The app is distributed directly by ZeroDrift, not through the Slack Marketplace. Review the permissions and select **Allow**. |
| "Already connected" after you select Allow | This Slack workspace is connected to a different ZeroDrift workspace. The page names that workspace when it can. An owner or admin there can disconnect it, or a Slack admin can remove the app from Slack. Then connect again. |
| "Only ZeroDrift workspace admins can run validations from Slack." | You are not a linked owner or admin. Ask an owner to give you the Admin role in Command, then link your Slack account from the app's Home tab. |
| Live monitoring is on but nothing appears in Activity | Check that your workspace has an active API key in **Settings > API keys**. The Home tab says so when one is missing. For a private channel, run `/invite @ZeroDrift` in it. |
| Live monitoring cannot be turned on, or a channel cannot be picked | If you connected Slack before live monitoring was available, reconnect Slack from **Connections** to grant the permissions it needs. |
| An audit does not start or does not finish | Check that your ZeroDrift workspace has a billing account set up, with a credit card added, under [Settings > Billing](https://app.zerodrift.ai/settings/billing). Audits and scheduled runs need one. |
| A scheduled run did not happen | Schedules pause when their owner is demoted or removed in Command. Check the schedule on the Home tab. |

## Disconnect

Only owners and admins can disconnect Slack.

1. In Command, open **Connections**. On the **Slack** row, select **Manage**.
2. The **Use in Slack** dialog shows the commands, the date Slack was connected and a **Disconnect** button. Select **Disconnect** and confirm.

Disconnecting removes the app from the Slack workspace. It also pauses every schedule, unlinks every admin and clears the live monitoring channels. The Slack workspace is then free to connect to another ZeroDrift workspace.

A Slack admin can also remove the app from Slack. That has the same effect.

## Next steps

> [card] [Run an Audit](https://docs.zerodrift.com/guides/slack-app/run-an-audit.md)
>
> Check the recent messages of a channel or DM with `/zerodrift`.

> [card] [Schedule Validations](https://docs.zerodrift.com/guides/slack-app/schedule-validations.md)
>
> Run an audit on your channels every day or every week.

> [card] [Live Monitoring](https://docs.zerodrift.com/guides/slack-app/live-monitoring.md)
>
> Check each new message in the channels you pick, as it is posted.

> [card] [Read the Results](https://docs.zerodrift.com/guides/slack-app/read-results.md)
>
> Find results in Slack, Audits and Activity, and read the audit workbook.

## Support

[support@zerodrift.ai](mailto:support@zerodrift.ai)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.