Slack

View as Markdown

Receive test result notifications directly in a Slack channel. When production monitoring or webhook-triggered group runs complete, TesterArmy posts a summary with links to each run.

Slack notifications are only sent for automated runs: Production Monitoring schedules and webhook-triggered group runs (including GitHub CI webhooks). Runs you start yourself - from the dashboard, the CLI, or the API - never post to Slack, even when they fail. To verify the integration, trigger a scheduled or webhook group run instead of starting one by hand.

Setup

  1. Go to Project → Settings → Integrations → Slack and click Add to Slack.
  2. Authorize the TesterArmy app for your Slack workspace.
  3. On Slack’s authorization screen, pick the channel where TesterArmy should post alerts.
  4. Return to TesterArmy and confirm that the integration shows the selected channel.

TesterArmy posts a welcome message to the selected channel after setup completes.

If you want to use a private channel, the person installing the Slack app must already be a member of that channel so it appears in Slack’s picker.

Choosing what to notify

Once Slack is connected, use the Notify on every run toggle:

  • Leave it off (the default) to be notified only when a run has failures.
  • Turn it on to be notified about every run, including ones where all tests pass.

This is set per channel, so Slack, Discord, and Email can each behave differently.

The toggle only widens which automated runs notify - it never enables notifications for manual runs.

Why am I not getting notifications?

  • The run was started by hand from the dashboard, the CLI, or the API. Only Production Monitoring schedules and webhook-triggered group runs notify.
  • The run was a single test rather than a group run. Notifications are sent once per group run, when the whole group finishes.
  • The run came from a pull-request preview webhook without a group webhook configured. Preview environments are intentionally muted.
  • The run passed and Notify on every run is off. Failures are always sent; passing runs need the toggle.

Changing the channel

  1. Go to Project → Settings → Integrations → Slack.
  2. Click Change channel.
  3. If this project is still using the legacy Slack bot connection, disconnect it first.
  4. Slack opens its authorization flow so you can pick a different destination channel.
  5. Finish setup and confirm that the integration shows the new channel.