Connect Slack: step-by-step guide
Posts the run summary to a channel, and with NEXUS_SLACK_NOTIFY=true one message per failing, flaky, chaos or visual-regression test. A message about a failure links its Jira ticket when there is one. This guide takes you from nothing to a verified connection, and lists the errors you can meet with their cause and fix.
Last updated:
Keep your credentials private. Never paste a token, key, password or webhook URL into a chat. Type it only in Studio → Settings → Integrations, where it is saved in your workspace's .env file and shown as dots. The same goes for an AI assistant: it can walk you through this guide, but it never needs your token.
What you need
- A Slack workspace where you can add an app.
- One Incoming Webhook URL for the channel that should get the messages.
Get the credentials
- In Slack, create an app with an Incoming Webhook (https://api.slack.com/messaging/webhooks) and pick the channel.
- Copy the webhook URL. It starts with https://hooks.slack.com/services/. The URL is itself the secret.
- Keep it in your clipboard. Do not paste it anywhere except the Studio (next step).
Connect it in the Studio
- In the Studio, open Settings → Integrations → Slack.
- Paste the webhook URL and press Save & send test. A test message goes to the channel.
- Turn on
SLACK_ENABLED. For one message per failing test, also turn onNEXUS_SLACK_NOTIFY.
Check that it works
- Send test message answers "Sent." and the message appears in the channel.
- Run any test. The run summary arrives in the channel.
Common errors
| What you see | Cause | Fix |
|---|---|---|
| "No webhook" | SLACK_WEBHOOK_URL is empty. | Paste the webhook URL in Settings → Integrations and save. |
"SLACK_WEBHOOK_URL is not a Slack Incoming Webhook" | The value does not start with https://hooks.slack.com/services/. | Copy the webhook URL again from your Slack app's Incoming Webhooks page. |
| HTTP 404 "no_service" or HTTP 403 "invalid_token" | The webhook was revoked or deleted, or the app was removed from the workspace. | Create a new Incoming Webhook and save the new URL. |
| HTTP 404 "channel_not_found" or HTTP 410 "channel_is_archived" | The channel the webhook posts to was deleted or archived. | Create a new webhook for an active channel. |
| "could not reach Slack (ENOTFOUND)" or "did not answer within 20 s" | This PC cannot reach Slack: a VPN or proxy, or no network. | Check the network from the same PC and retry. |
| The test works but failures do not post | SLACK_ENABLED is false, or only the run summary is on: per-test messages need NEXUS_SLACK_NOTIFY=true. | Turn on both switches. |
Settings keys
| Key | What it does | Valid value | How to check it |
|---|---|---|---|
SLACK_ENABLED | Send alerts to Slack | true or false | Turn on after the test message arrives. |
SLACK_WEBHOOK_URL | Slack channel for alerts (secret, saved only on this computer) | https://hooks.slack.com/services/… (nothing else is accepted) | Send test message posts to the channel. |
NEXUS_SLACK_NOTIFY | Slack alert per failure | true or false | One message per failing test arrives, not only the run summary. |
More: all integrations, the Settings guide, troubleshooting. Other guides: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
Still stuck? Write to [email protected] with the exact error line the Studio shows. Do not include a token.