Discord

Connect DevHelm to Discord to receive incident notifications in your server channels.

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

Create the alert channel in DevHelm

devhelm alert-channels create \
  --name "Discord Alerts" \
  --type discord \
  --webhook-url "https://discord.com/api/webhooks/..."

alertChannels:
  - name: Discord Alerts
    config:
      channelType: discord
      webhookUrl: ${DISCORD_WEBHOOK_URL}
      mentionRoleId: "123456789"

Test the channel

devhelm alert-channels test <channel-id>

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

The URL must start with https://discord.com/api/webhooks/ or https://discordapp.com/api/webhooks/.

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>

Overview

Alert Channels

CI/CD

Setup

Configuration

Finding a role ID

Troubleshooting

​Setup

​Configuration

​Finding a role ID

​Troubleshooting

Setup

Configuration

Finding a role ID

Troubleshooting