Skip to main content

Slack

A Slack channel posts the organization's notifications to one Slack channel, through a Slack incoming webhook. Slack is on the Enterprise plan; the Developer plan has email only. Add the webhook once, then choose which topics go to Slack.

Before you start​

  • The organization owner or admin role, on the Enterprise plan.
  • A Slack incoming webhook for the channel. In Slack, at api.slack.com/apps: pick or create an app, turn on Incoming Webhooks, select Add New Webhook to Workspace, pick the channel, and copy the URL that starts with https://hooks.slack.com/services/.

In the console​

  1. Select your name at the bottom of the sidebar, then Organization settings, then Notifications (open it). Select Manage delivery.
  2. In Add Notification Channel, pick Slack under Channel Type, paste the Slack Webhook URL, and select Create Channel.
  3. Open Manage delivery and select Slack again, then Test Webhook: a test message posts to the channel.
  4. On each topic you want in Slack, select Turn on, tick Slack, and select Turn on.

You should see​

The test message in the Slack channel, and Slack under Delivered to on the topics you turned on.

How the webhook is kept safe​

A webhook URL lets anyone who has it post to the channel, so AstroPulse treats it as a secret. Once saved it is never shown again: the console, the API and astroctl show it with its secret part replaced by asterisks. Test Webhook uses the saved URL, so you never need to paste it again. An organization has one Slack integration; saving a new URL replaces the old one.

Other ways in​

  • Nova: ask it to connect Slack with your webhook, or to send a topic to Slack. It confirms the test message before delivering.
  • API: the notifications calls in the API reference.

With astroctl​

Terminal
astroctl notifications integrations configure --channel slack \
--webhook-url https://hooks.slack.com/services/... --slack-channel "#alerts"
astroctl notifications subscriptions upsert --topic application-pipeline --channels slack
astroctl notifications integrations test --channel slack

configure sends a test message unless you add --skip-webhook-test. Every flag: astroctl notifications integrations configure.

If it's refused​

"invalid Slack webhook URL format. Must be like: https://hooks.slack.com/services/..."
Cause
The URL is not a Slack incoming-webhook address.
Fix
Copy the incoming webhook URL from Slack again; it starts with https://hooks.slack.com/services/.

Troubleshooting​

The test message does not arrive: check the webhook still exists in Slack and its app may post to the channel, then save a fresh webhook URL. Topics don't post: check each lists Slack under Delivered to.

Next​