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 page on our dashboard
  2. Click on “Install” on the Slack app to start the OAuth flow

Configuration

After installation, pick a channel in your Slack workspace where you want to see test reports and/or start agent sessions.

  1. Navigate to this Slack channel

  2. Add the @Empirical bot to this invite: mentioning the bot should do it

  3. Run a slash command to link this channel, by sending this message in Slack

    /empirical link repo-tests
    

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:

ScopePurpose
chat:write, chat:write.customizeUsed to share test run reports and AI agent responses
app_mentions:readBot listens to @Empirical mentions to start AI chat sessions
reactions:writeAdd reactions to messages to acknowledge that agent is working
channels:historyRead message threads to get context in threads where @Empirical is mentioned
commandsAdd slash commands for common actions, like subscribing to test reports and triggering new runs