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

# Slack

> Install and configure our Slack app

Our Slack app adds the `@Empirical` bot to your Slack workspace. This bot
shares test reports in the channel, and tagging the bot will start agent sessions.

## Installation

1. Navigate to the [Integrations](https://dash.empirical.run/settings/integrations) page on our dashboard
2. Click on "Install" on the Slack app to start the OAuth flow

## Configuration

After installation, connect each Slack channel from the dashboard.

1. Navigate to your project's Slack channels settings page: **Settings** > **Slack channels**

2. Click **Add channel**

3. Confirm that the Empirical Slack app is installed for the connected workspace

4. In Slack, navigate to the channel you want to connect

5. Invite `@Empirical` to the channel

6. Run this slash command in the channel:

   ```
   /empirical
   ```

7. In the Slack modal, select the project to connect to this channel

8. Choose which environments should send test run notifications

Environment notification modes:

* **None**: links the channel without sending test run notifications
* **Selected environments**: sends notifications only for the environments you select
* **All environments**: sends notifications for every current and future environment

You can rerun `/empirical` in a connected channel to update its notification settings or delete the subscription.

## Permissions

The Slack app can send and read messages only in channels where the bot has been added. Specifically, it requests for these permission scopes:

| Scope                                | Purpose                                                                                                        |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| `chat:write`, `chat:write.customize` | Used to share test run reports and AI agent responses                                                          |
| `app_mentions:read`                  | Bot listens to `@Empirical` mentions to start AI chat sessions                                                 |
| `reactions:write`                    | Add reactions to messages to acknowledge that agent is working                                                 |
| `channels:history`, `groups:history` | Read message threads to get context in threads where `@Empirical` is mentioned, in public and private channels |
| `commands`                           | Add slash commands for common actions, like subscribing to test reports and triggering new runs                |
| `files:read`                         | Download image attachments shared in Slack threads for AI agent context                                        |