Discord Integration Guide
Overview
Integrating Discord with UptimeObserver allows you to receive real-time alerts and status updates directly in your Discord server channels. This ensures your team can quickly respond to downtime, latency issues, and other incidents.
Note
Discord integration requires a paid plan.
Prerequisites
- A Discord server where you have the Manage Webhooks permission
- A paid UptimeObserver account (Indie or Pro)
Step-by-Step Setup
1. Create a Webhook in Discord
- Open Discord and navigate to your server.
- Open Server Settings → Integrations → Webhooks.
- Click New Webhook (or Create Webhook).
- Give the webhook a name (e.g., "UptimeObserver Alerts").
- Select the channel where you want to receive alerts.
- Optionally upload an icon for the webhook.
- Click Copy Webhook URL — you'll need this in the next step.
Private Channels
If you want alerts in a private channel, create the webhook for that specific channel. The bot posts to the channel the webhook is configured for.
2. Add Integration in UptimeObserver
- Go to UptimeObserver and log in to your account.
- Navigate to the Integrations section from your dashboard.
- Choose Discord from the list of available integrations.
- Click Add Discord Configuration.
- Fill in the form fields:
| Field | Description | Required |
|---|---|---|
| Name | A label for this Discord configuration | Yes |
| Webhook URL | The webhook URL copied from Discord | Yes |
| TTS | Enable Text-to-Speech for alert messages | No |
TTS (Text-to-Speech)
When TTS is enabled, Discord will read alert messages aloud using text-to-speech. This can be useful for critical alerts that need immediate attention.
- Click Save to create the configuration.
- Use the test button to send a test message to your Discord channel and verify the connection.
Enabling Alerts on Monitors
Follow Add an alert to a monitor. Select Alert Type → Discord and choose the saved Discord configuration for the intended channel. Add separate Monitor Down and Monitor Up rules.
Troubleshooting
1. Not receiving alerts in Discord
- Webhook URL — Verify the webhook URL is correct and hasn't been regenerated or deleted in Discord
- Channel permissions — Ensure the webhook is configured for the correct channel and hasn't been removed
- Server permissions — Check that you still have Manage Webhooks permission in the server
- Test the integration — Use the test button in UptimeObserver to verify the connection
2. Webhook shows as invalid
- Webhooks can be deleted or regenerated in Discord. If the webhook was deleted, create a new one and update the configuration in UptimeObserver
- Webhook URLs are sensitive — treat them like passwords
3. TTS not working
- Ensure the TTS checkbox is enabled in your Discord configuration in UptimeObserver
- Discord users must have TTS notifications enabled in their personal settings (User Settings → Notifications → Text-to-Speech Notifications)
4. Alert format or content issues
- Discord webhooks send messages in a structured embed format. Alert content is automatically formatted by UptimeObserver
- If you need custom formatting beyond what's provided, consider using Webhooks to build a custom integration
How to Uninstall
In UptimeObserver:
- Go to UptimeObserver and log in to your account.
- Navigate to the Integrations section from your dashboard.
- Select Discord from the list.
- Click the delete button next to the Discord configuration you want to remove.
In Discord:
- Open your Discord server.
- Go to Server Settings → Integrations → Webhooks.
- Find the UptimeObserver webhook and click the ... menu.
- Select Delete Webhook to remove it permanently.
Note
Removing the integration from UptimeObserver will stop all Discord notifications immediately. Deleting the webhook in Discord ensures a clean uninstall.
Need Help?
If you need assistance setting up Discord notifications, reach out using the "Need Help?" button on the bottom right corner or email us at support@uptimeobserver.com.