Discord
Send analysis results to a Discord channel using a webhook
Connect a Discord channel using a webhook URL. SigSentry posts formatted embeds.
This page is for outbound delivery. For inbound slash commands in Discord, see Discord chat triggers.
Prerequisites
| Need | Notes |
|---|---|
| Discord server | You need Manage Webhooks permission |
| A target channel | The text channel SigSentry should post to |
Setup walkthrough
Create a Discord webhook
Open the target channel in Discord. Hover over the channel name and click the gear icon (Edit Channel), then go to Integrations → Webhooks → New Webhook.
| Field | Value |
|---|---|
| Name | SigSentry |
| Avatar | (Optional) Upload a logo |
| Channel | Confirm it's the right one |
Click Save Changes, then Copy Webhook URL.
Add the channel in SigSentry
In the dashboard, Project → Channels → Add Channel.
| Field | Value |
|---|---|
| Type | Discord |
| Name | Descriptive label, e.g. #alerts-discord |
| Webhook URL | The Discord webhook URL |
| Severity threshold | Lowest severity that should trigger this channel |
Save and test
Click Save. Run a test analysis to verify the embed posts to Discord.
What gets posted
Each Discord message includes:
- The analysis summary, color-coded by severity (red for critical down through grey for info)
- The root cause and affected services
- A clickable link to the full analysis in the dashboard
Webhook security
Discord webhook URLs are unauthenticated public URLs. Treat them like secrets — don't paste into public repos. To revoke, delete the webhook in Discord under the channel's Integrations settings.
Troubleshooting
| Error | Fix |
|---|---|
404 Unknown Webhook | Webhook was deleted in Discord; recreate it and update the URL |
400 invalid embed | Usually transient — retry. If persistent, message length may exceed Discord's 6,000-char embed limit |
429 rate limited | Discord throttling; SigSentry retries with backoff |
| No messages arriving | Check that the channel still exists and you have Send Messages permission |