Purpose
This guide explains how to configure the Discord Response integration in Logsign USO, so that Incidents and Alarms can automatically, or an analyst can manually, post a message to a Discord channel directly from a Logsign Incident. This is a notification integration, configured under Settings > Integrations > Responses > +Device.
Prerequisites
- A Discord server (guild) and a channel you want Logsign to post notifications into, with permission to create a webhook for it.
Step 1: Create a Discord Webhook
- Open Discord and go to the target channel's settings.
- Go to Integrations > Webhooks and create a new webhook.
- Name it (for example "Logsign") and copy the webhook URL. Treat this URL as a secret: anyone with it can post messages into the channel.
Step 2: Configure the Integration in Logsign USO
In Logsign USO, go to Settings > Integrations > Responses, search for Discord, click Configure then +Device, and fill in:
| Field | Required | Description |
|---|---|---|
| Device Name | Yes | Free-text label identifying this Discord device in Logsign. |
| Web Hook Url | Yes | The webhook URL from Step 1. |
Click Create to save the device.
Available Methods
- send_message — posts a message to the configured Discord channel. Arg: content (required).
Troubleshooting
| Symptom | Likely cause | What to check |
|---|---|---|
| 404 error / message never appears | Wrong or deleted Web Hook Url. | Re-create the webhook in Discord and update the Web Hook Url field. |
| 429 Too Many Requests | Discord enforces a per-webhook rate limit. | Reduce the frequency of automated messages; Discord's response includes a Retry-After value indicating how long to wait. |
Notes and Limits
- This integration posts to a single, fixed channel per device (the one the webhook was created for); add a second device with a different webhook if you need to notify multiple channels.