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:history, groups:historyRead message threads to get context in threads where @Empirical is mentioned, in public and private channels
commandsAdd slash commands for common actions, like subscribing to test reports and triggering new runs