@Empirical bot to your Slack workspace. This bot
shares test reports in the channel, and tagging the bot will start agent sessions.
Installation
- Navigate to the Integrations page on our dashboard
- Click on “Install” on the Slack app to start the OAuth flow
Configuration
After installation, connect each Slack channel from the dashboard.- Navigate to your project’s Slack channels settings page: Settings > Slack channels
- Click Add channel
- Confirm that the Empirical Slack app is installed for the connected workspace
- In Slack, navigate to the channel you want to connect
-
Invite
@Empiricalto the channel -
Run this slash command in the channel:
- In the Slack modal, select the project to connect to this channel
- Choose which environments should send test run notifications
- 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
/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 |