Setup
Create a Discord webhook
- In Discord, right-click a channel → Edit Channel → Integrations → Webhooks
- Click New Webhook and name it (e.g., “DevHelm Alerts”)
- Copy the webhook URL
Configuration
| Field | Description | Required |
|---|---|---|
webhookUrl | Discord webhook URL | Yes |
mentionRoleId | Discord role ID to mention in notifications | No |
Finding a role ID
To mention a role in notifications, you need the role ID:- Enable Developer Mode in Discord (User Settings → Advanced)
- Right-click the role in Server Settings → Roles → Copy Role ID
Troubleshooting
Webhook URL rejected
Webhook URL rejected
The URL must start with
https://discord.com/api/webhooks/ or https://discordapp.com/api/webhooks/.Messages not appearing
Messages not appearing
- Verify the webhook hasn’t been deleted in Discord channel settings
- Check that the bot has permission to post in the channel
- Run
devhelm alert-channels test <id>