Help / Alerts
Discord
A Discord channel posts alerts into a text channel on your Discord server. It uses a Discord webhook: a web address that lets HonkWatch post to that one channel.
What you need first
- A Discord server where you have the Manage Webhooks permission. Server owners and admins have it.
- The text channel the alerts should go to.
Make a webhook in Discord
If these steps do not match what you see, follow Discord's own guide, Intro to Webhooks.
- Open your server's settings and go to Integrations.
- Open Webhooks and make a new webhook.
- Give it a name, such as "Uptime alerts", and choose the channel.
- Copy the webhook URL. It starts with
https://discord.com/api/webhooks/.
Treat the webhook URL like a password. Anyone who has it can post into that channel.
Add it in HonkWatch
- Open Alerts and go to Add a channel.
- Under Where should alerts go?, choose Discord.
- Paste the webhook URL into Send to.
- If you like, type the server and channel name in Label (optional).
- Tick the events to post: Down, Back up, Certificate expiring and Slow.
- Press Add channel.
Send a test
- In the channel list on Alerts, press Send test on the Discord row.
- A message about "Test monitor" should appear in the Discord channel shortly.
What an alert looks like
Each alert is a plain text message, posted under the name you gave the webhook. The first line is the service name in square brackets, then the monitor and what happened, for example "Shop is DOWN". Below it are the monitor's address, the reason and a link to the monitor's page. Very long messages are cut at 1,900 characters to fit Discord's limit.
If it does not work
- You see "That needs an https:// address". Paste the whole webhook URL, starting with
https://. - Recently sent shows failed. Discord refused the message. The webhook may have been deleted, or the channel removed. Make a new webhook, add it as a new channel here, test it, then remove the old channel.
- Recently sent shows sent, but you see nothing. Check the channel the webhook points to in Discord's webhook settings. You can change the channel there without changing the URL.
- No notification on your phone. Discord decides that from your notification settings for the server and channel.
See also Setting up alerts for which events go where.
Still stuck? Email [email protected] and say which guide you were following.