StatusDrift integrates with Discord to deliver real-time monitoring alerts directly to your Discord server. This guide explains how to set up and configure the Discord integration for your StatusDrift monitors.
What This Integration Does
The Discord integration sends webhook notifications to your Discord channel when:
- A monitor detects downtime
- A monitor recovers from an outage
- SSL certificate problems are identified
- Response time exceeds configured thresholds
Prerequisites
Before setting up the Discord integration, you need:
- A Discord server where you have permission to manage webhooks
- A StatusDrift account with at least one monitor configured
Step 1: Create a Discord Webhook
First, create a webhook in your Discord server:
- Open Discord and navigate to your server
- Right-click on the channel where you want alerts to appear
- Select Edit Channel
- Go to the Integrations tab
- Click Create Webhook (or View Webhooks then New Webhook)
- Give your webhook a name (e.g., “StatusDrift Alerts”)
- Click Copy Webhook URL
- Click Save Changes
Step 2: Add the Discord Channel in StatusDrift
Now configure the integration in StatusDrift:
- Log in to your StatusDrift account at app.statusdrift.com
- Navigate to Notification Channels in the sidebar
- Click Add Channel
- Select Discord from the integration type dropdown
- Enter a descriptive name for this channel
- Paste the webhook URL you copied from Discord
- Optionally, customize the username that appears for messages
- Optionally, add a custom avatar URL for the bot
- Click Save
Step 3: Assign to Monitors
Connect the notification channel to your monitors:
- Go to Monitors in the sidebar
- Select the monitor you want to receive Discord notifications
- Find the Notification Channels section in monitor settings
- Enable the Discord channel you created
- Save your changes
Testing the Integration
Verify your Discord integration is working:
- Go to Notification Channels
- Find your Discord channel in the list
- Click the Test button
- Check your Discord channel for the test message
If the test message does not appear, verify that the webhook URL is correct and the webhook has not been deleted from Discord.
Configuration Options
The Discord integration supports these configuration options:
| Field | Required | Description |
|---|---|---|
| Webhook URL | Yes | The Discord webhook URL for your channel |
| Username | No | Custom display name for the bot in messages |
| Avatar URL | No | Custom avatar image URL for the bot |
Troubleshooting
Messages not appearing in Discord
- Verify the webhook URL is correct and complete
- Check that the webhook has not been deleted from Discord
- Ensure the channel still exists in your Discord server
Custom avatar not displaying
- Verify the avatar URL points to a valid, publicly accessible image
- Ensure the image URL uses HTTPS
- Check that the image format is supported (PNG, JPG, GIF)