Discord

Overview

The Discord integration sends a notification to a Discord channel whenever a monitor’s status changes. Messages are sent via a Discord webhook and include rich embeds with the incident details.

Setup

Step 1: Create a Discord webhook

1. Open the settings of the Discord channel you want.
2. Go to Integrations → Webhooks.
3. Click New Webhook.
4. Name it (e.g. “OKStatus”).
5. Copy the webhook URL.

Step 2: Add the webhook in OKStatus

1. In OKStatus, go to Alerting → Channels.
2. Click Add a channel → Discord.
3. Paste the webhook URL.
4. Test the connection with the Test button.
5. Attach the channel to the monitors you want.

Notification format

Discord notifications arrive as a rich embed:

• Title — Monitor name and the new state: 🔴 Down, 🟡 Degraded, 🟢 Recovered, ⏸️ Paused.
• Details — Service URL, HTTP status code, response time, and the region that observed it. A recovery also carries the total downtime.
• Colour — Red for an outage, amber for degraded, green for a recovery, grey for a pause (a pause is a deliberate action, not a severity).
• Timestamp — Date and time of detection.

Escalation levels reuse the same embed, stamped with the level that fired.