Setting it up
1
Create a channel webhook
In your Discord server, open Channel settings → Integrations → Webhooks → New webhook, pick the channel that should receive incidents and click Copy webhook URL. The URL looks like
https://discord.com/api/webhooks/<id>/<token>.2
Add the integration in aciona.me
Under Integrations → Discord, paste the URL in Organization configuration. Optionally give it a display name (e.g.
#incidents-prod channel) so you can recognize the destination later. Owners and admins can do this.3
Test it
Click Test. A test message should show up in the channel within a few seconds.
One channel per team
The organization configuration is the default for every team. Under Team overrides, you can point a specific team to another channel (or disable it). Teams without an override keep using the organization webhook. Removing a team’s override makes it fall back to the organization configuration, if there is one.What lands in the channel
An embed in the organization’s language, colored by severity, with:- Incident title and severity.
- Affected service, alert source and current owner, when there is one.
- Event time, shown in the reader’s own time zone.
- Open incident, Acknowledge and Assign to me buttons, which open the authenticated dashboard.
Mentions such as
@everyone, @here or @user in the alert text never notify anyone. Alert content is shown as literal text.Like Slack and Teams, Discord receives the incident regardless of whether personal recipients were resolved. Even if the schedule points at nobody, the channel still sees the incident.
Good practices
Use a dedicated channel
Use a dedicated channel
A channel such as
#incidents keeps the history readable and lets you tune Discord’s own notifications for it alone.Discord does not replace push
Discord does not replace push
A channel message is visibility, not paging. Whoever is on call needs push on their phone.
Treat the webhook URL as a secret
Treat the webhook URL as a secret
Anyone with the URL can post to the channel. If it leaks, delete the webhook in Discord, create a new one and update the integration in aciona.me.