Skip to main content

Slack Notifications

Enterprise only

Slack integration is available on the Enterprise plan. Developer plan supports email notifications only. See pricing →

Get real-time alerts delivered directly to your Slack channels when clusters provision, applications deploy, or system events occur.

Create a Slack webhook

Every surface needs a Slack Incoming Webhook URL first. You create it once in Slack:

  1. Go to api.slack.com/apps
  2. Select your app (or create one), then Incoming Webhooks and Activate
  3. Click Add New Webhook to Workspace, select a channel, then Authorize
  4. Copy the webhook URL (https://hooks.slack.com/services/...)

Add the Slack integration

Register the webhook with AstroPulse from whichever surface fits how you work. All three configure the same integration and enforce the same validation.

Console

  1. Go to the AstroPulse Console, then Settings and Notifications
  2. Click Add Channel and select Slack
  3. Paste your webhook URL
  4. Click Test Webhook. A test message is sent to your channel.
  5. Click Create Channel

CLI

# Configure the Slack integration (the webhook is tested automatically)
astroctl notifications integrations configure \
--channel slack \
--webhook-url https://hooks.slack.com/services/... \
--slack-channel "#alerts"

Add --skip-webhook-test to configure without sending a test message (not recommended). See the astroctl notifications integrations configure reference for every flag.

Nova

Ask Nova in plain language to connect Slack with your webhook URL. Nova configures the same integration the console and CLI produce and confirms the test message before it starts delivering.

"Add a Slack notification integration for #alerts using this webhook: https://hooks.slack.com/services/…"

Subscribe to events

Choose which topics reach Slack. Available topics include Cluster Pipeline (cluster provisioning, upgrades, deletions), Application Pipeline (deployments, updates, failures), and System Events (platform alerts).

Console

  1. Click Subscribe to Topic
  2. Choose the events you want
  3. Select Slack as the delivery channel

CLI

# Route a topic to Slack (add email to the list to deliver to both)
astroctl notifications subscriptions upsert --topic application-pipeline --channels slack

See the astroctl notifications subscriptions upsert reference for the full topic list and flags.

Nova

Ask Nova which events you want delivered to Slack and it creates the matching subscriptions.

"Send application pipeline failures to Slack."

Multiple channels

You can create multiple Slack integrations — one per channel — to route different events to different Slack channels:

ChannelEvents
#infra-alertsCluster Pipeline events
#deploymentsApplication Pipeline events
#platform-criticalSystem Events

For each channel, create a separate webhook in Slack and add it as a separate integration in the console.

Troubleshooting

IssueFix
Test failedVerify webhook URL is complete and unmodified
Messages not appearingCheck subscription is enabled and Slack is selected
"Enterprise only" shownUpgrade to Enterprise plan