Skip to content

Discord Integration

Overview

The Discord integration allows you to receive Onagre alert notifications directly in a Discord channel. When a sensor triggers an alert, Onagre sends a message to the configured Discord webhook, keeping your team informed in real time.

Prerequisites

Before configuring this integration, you need to create a webhook in your Discord server:

  1. Open your Discord server and navigate to the target channel.
  2. Go to Channel Settings > Integrations > Webhooks.
  3. Click New Webhook and give it a name (e.g. "Onagre Alerts").
  4. Copy the Webhook URL — you will need it in the next step.

For more details, see the Discord webhook documentation.

Configuration Options

  • Name (required): A unique name to identify this integration, e.g. Discord #monitoring.
  • Webhook URL (required): The Discord webhook URL. It must start with https://discord.com/api/webhooks/.

How It Works

When an alert fires, Onagre sends an HTTP POST request to the Discord webhook URL with a formatted message containing the alert details. The message appears in the linked Discord channel as a regular bot message.

Summary

The Discord integration is a simple way to route Onagre alerts into your team's Discord channels. Create a webhook, paste the URL into Onagre, and you are ready to receive notifications.