Discord Integration#

Assert posts alerts to a Discord channel through an incoming webhook. There is no bot to install and no permissions to grant.

Each alert names the assertion that failed, the expected value, the value your API returned, the regions that agreed, and the time. A failure re-runs across regions before anything is sent, so a single bad check never reaches the server. Assert sends one alert per incident and closes the incident when the assertion passes again.

Routing is per monitor, so production and staging can post to different servers. Discord is on every paid plan.

Setup Guide#

Step 1: Create a Discord Webhook#

1. Open your Discord server
2. Go to Server Settings → Integrations → Webhooks
3. Click New Webhook
4. Name the webhook "Assert Alerts"
5. Select the channel for notifications
6. Click Copy Webhook URL

Step 2: Add Discord in Assert#

1. Go to Alerts → Channels in your Assert dashboard
2. Click Add Channel → Discord
3. Paste your webhook URL
4. Name the channel, for example "Discord - API Alerts"
5. Click Save

Step 3: Test the Connection#

Click Send Test. Assert posts a test message to your Discord channel.

Step 4: Assign to Monitors#

Open each monitor. Add the Discord channel under Alert Channels.

Alert Format#

Assert sends a Discord embed. The color shows the state: red for a failure, green for a recovery, yellow for a slow response.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 Monitor Failed: Production API
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Status Code: 500
Response Time: 2,340ms
Region: US East

Assertion Failed:
$.status expected "success", got "error"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration Options#

Best Practices#

Create separate channels for different alert types:

• #api-alerts for general API monitoring
• #critical-alerts for production failures only
• #bot-status for Discord bot APIs

Add Discord roles and @mentions in the webhook settings to reach specific people.

Group the channels under a Monitoring category:

📊 MONITORING
├── #api-alerts
├── #uptime-status
└── #incident-log

Multiple Servers#

Assert can post to more than one Discord server:

1. Create a webhook in each server
2. Add each webhook as a separate channel in Assert
3. Assign monitors to the channels you want

Troubleshooting#

Not receiving alerts?

• Check the webhook URL
• Check that the webhook still exists in Discord
• Check that the target channel still exists

Webhook rate limited?

• Discord allows a webhook 30 requests per minute
• Reduce the check frequency, or point fewer monitors at the same webhook

Embeds not showing?

• Turn on the "Embeds and Links" permission for the webhook

Next Steps#

• Set up Slack for additional team notifications
• Configure webhooks for custom integrations
• Explore alerting features