Integration

Discord

Send alerts to a Discord channel using webhooks.

Prerequisites

  • A Discord server where you have "Manage Webhooks" permission
  • A Talarius account with a project created
1

Create a Webhook

In your Discord server:

  1. Right-click the channel where you want alerts
  2. Click Edit Channel
  3. Go to Integrations tab
  4. Click Webhooks
  5. Click New Webhook

Tip

Give your webhook a recognizable name like "Talarius Alerts" and optionally set an avatar.

2

Copy the Webhook URL

Click Copy Webhook URL. It will look like:

https://discord.com/api/webhooks/123456789/abcdefghijklmnop...

Keep this URL secret

Anyone with this URL can post messages to your channel. Don't share it publicly.

3

Configure in Talarius

In your Talarius dashboard:

  1. Go to your project settings
  2. Select Discord as destination type
  3. Paste your Webhook URL
  4. Click Test Connection
  5. Save the configuration

Send a Test Alert

Test your integration:

curl
curl -X POST https://v1.talarius.io/alerts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Test Alert", "body": "Discord integration is working!"}'

How alerts appear

Alerts are sent as Discord embeds with color-coded priority:

T

Talarius Alerts

BOT

Server Alert

CPU usage exceeded 90% on production-web-1

Priority: high Today at 2:34 PM

High priority alerts have an amber border, normal alerts have a blue border.

Troubleshooting

Webhook URL invalid?

Make sure you copied the full URL. It should start with https://discord.com/api/webhooks/

Alerts not appearing?

Check that the webhook hasn't been deleted. You can test it directly in the Discord settings.

Rate limited by Discord?

Discord limits webhooks to about 30 messages per minute. Talarius buffers messages to respect these limits.