How to Setup Discord Notifications
ZoneWatcher can send notifications to your Discord server when changes are detected with your domains. This guide will walk you through how to set up Discord notifications.
Creating a Discord Webhook
To receive notifications in Discord, you'll need to create a webhook for the channel where you want to receive alerts.
Follow these steps to create your webhook:
- Open Discord and navigate to the server where you want to receive notifications
- Right-click on the channel and select Edit Channel (or click the gear icon)
- Select Integrations from the left sidebar
- Click Webhooks
- Click New Webhook
- Give your webhook a name (e.g., "ZoneWatcher")
- Optionally customize the avatar for the webhook
- Click Copy Webhook URL
The webhook URL will look something like this: https://discord.com/api/webhooks/1234567890/abcdefghijklmnop...
Required Permissions
To create a webhook, you'll need one of the following:
- Server owner or administrator role
- A role with the Manage Webhooks permission for that channel
If you don't have the required permissions, ask your server administrator to create the webhook for you or grant you the necessary permissions.
Creating your Notification Channel
ZoneWatcher allows you to create unlimited Notification Channels, which can be customized to send notifications to different Discord servers or channels.
Once you have your Discord webhook URL, you can create a new Notification Channel by:
- Selecting "Discord" as the channel type
- Giving it a descriptive name (e.g., "Infrastructure Alerts")
- Pasting your webhook URL into the "Webhook URL" field
- Selecting which events you want to receive notifications for
Available Notification Events
You can customize which events trigger notifications to your Discord channel:
- Zone Changed
- New Zone Discovered
- Zone Expiring Soon
- Zone Expired
- Zone Renewed
- Zone Nameservers Changed
- Zone Certificate Issued
- Provider Auto-Disabled
Notification Format
ZoneWatcher sends notifications to Discord using rich embeds, which provide:
- Clear notification titles and descriptions
- Color-coded embeds based on the type of alert
- Direct links to view details in ZoneWatcher
- Timestamps for when the event occurred
Best Practices
- Create a dedicated channel for ZoneWatcher alerts to avoid cluttering general channels
- Consider setting up channel permissions so only relevant team members see the alerts
- Use Discord's notification settings to control how you're alerted (desktop, mobile, etc.)
- Never share your webhook URL publicly — anyone with the URL can post to your channel
Troubleshooting
If you're not receiving notifications in Discord, check the following:
- Verify the webhook URL is correct and complete
- Ensure the webhook hasn't been deleted from your Discord server
- Check that you've selected at least one notification event type in ZoneWatcher
- Confirm the channel still exists (webhooks break if the channel is deleted)
- Try creating a new webhook if the existing one isn't working