Setup
Create a Slack Incoming Webhook
- Go to api.slack.com/apps and create a new app (or select an existing one)
- Navigate to Incoming Webhooks and toggle it on
- Click Add New Webhook and select a channel
- Copy the webhook URL (starts with
https://hooks.slack.com/services/...)
Configuration
| Field | Description | Required |
|---|---|---|
webhookUrl | Slack incoming webhook URL | Yes |
mentionText | Text to include for mentions (e.g., @channel, @here, <@U123>) | No |
Notification format
DevHelm sends rich Slack messages with:- Incident severity and status (color-coded)
- Monitor name and type
- Affected regions
- Direct link to the incident in the Dashboard
Troubleshooting
Webhook URL rejected
Webhook URL rejected
The URL must start with
https://hooks.slack.com/. If you’re using a Slack Workflow webhook, it won’t work — you need an Incoming Webhook.Messages not appearing
Messages not appearing
- Check that the webhook isn’t revoked in your Slack app settings
- Verify the channel still exists
- Run
devhelm alert-channels test <id>to see the delivery result