Skip to content

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 is offered exclusively on paid plans.

Prerequisites

  • A Discord server where you have the Manage Webhooks permission
  • A paid UptimeObserver account (Indie or Pro plan)

Step-by-Step Setup

1. Create a Webhook in Discord

  1. Open Discord and navigate to your server.
  2. Open Server Settings → Integrations → Webhooks.
  3. Click New Webhook (or Create Webhook).
  4. Give the webhook a name (e.g., "UptimeObserver Alerts").
  5. Select the channel where you want to receive alerts.
  6. Optionally upload an icon for the webhook.
  7. 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

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Choose Discord from the list of available integrations.
  4. Click Add Discord Configuration.
  5. 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.

  1. Click Save to create the configuration.
  2. Use the test button to send a test message to your Discord channel and verify the connection.

Enabling Alerts on Monitors

After integrating Discord with UptimeObserver, assign alerts to monitors:

  1. Navigate to Monitors: From your dashboard, click on the specific monitor you wish to configure to enter its Monitor Detail page.
  2. Add Alert: Find the alerting section and click the Add Alert button.
  3. Select Alert Type: In the Alert Type dropdown menu, select Discord.
  4. Choose the Configuration: Select the Discord configuration from the dropdown.
  5. Choose the Event: Pick the relevant trigger from the Event dropdown (e.g., Monitor Down, Monitor Up, SSL Expiry 7 Days).

See all alert event types

  1. Save Changes: Click the Save Changes button to activate the alert.
  2. Repeat as Needed: You can assign different Discord channels to different monitors or event types.

Recommendation

We recommend setting up alerts for both "Down" and "Up" events. This ensures your team is notified immediately when an issue starts and, just as importantly, when it has been resolved.

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:

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Select Discord from the list.
  4. Click the delete button next to the Discord configuration you want to remove.

In Discord:

  1. Open your Discord server.
  2. Go to Server Settings → Integrations → Webhooks.
  3. Find the UptimeObserver webhook and click the ... menu.
  4. 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.