Skip to main content

Connect Discord

Use this guide when you want Alerta to deliver alerts into Discord.

What This Guide Covers​

  • connecting Discord in Alerta
  • sending and replying through the public V2 API
  • starting a Discord thread and posting into it with the public V2 API

Before You Begin​

You will need:

  • an active Alerta session
  • the correct organization selected
  • permission to manage integrations
  • access to the Discord server you want to use

Where To Start In Alerta​

Open the Integrations page and choose Discord.

Setup Flow​

Discord is usually the most detailed provider setup because the right server, channel, and bot access all need to line up.

  1. Click Discord.
  2. Alerta shows the Discord servers available to your account.
  3. Choose a server.
  4. Alerta loads the available channels for that server.
  5. Choose the destination channel.
  6. If the bot is not installed in that guild, Discord will require bot installation before setup can finish.
  7. Complete the Discord connection flow with the selected context.
  8. Alerta verifies access and saves the guild and channel binding.

Public V2 Endpoints​

Discord public endpoints are:

  • POST /v2/discord/send
  • POST /v2/discord/reply
  • POST /v2/discord/start-thread
  • POST /v2/discord/send-thread-message

Read the current API guidance in Alerta API, or review the older provider-specific reference in Legacy APIs.

Discord-Specific Notes​

  • Discord send, reply, start-thread, and send-thread-message all use channelRef.
  • channelRef is an internal Alerta binding reference like C_ALT_....
  • POST /v2/discord/send returns threadId and channelId, so you can reply immediately without a separate lookup.
  • Discord thread flows are separate from the main reply flow. Use start-thread to create a thread and send-thread-message to post into that thread.

API Reference​