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 requires a paid plan.

Prerequisites


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

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:

  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.