< woml />
View on GitHub

<discord>

<discord> is a built-in communication tag used as a Gateway trigger or notification provider.

Why use it

Use it when a Discord bot should react to mentions or direct messages and carry approval or lifecycle notifications.

Common use cases

  • Start a workflow from a bot mention.
  • Start a workflow from a direct message.
  • Deliver an approval to a known channel ID.
  • Send lifecycle notifications to a server channel.

Syntax

WOML
<discord
  id="agentMessage"
  events="app-mention,direct-message"
  channels="200000000000000001"
  bot-token="{{secrets.DISCORD_BOT_TOKEN}}"
/>

Rules and behavior

  • Trigger events accepts app mentions, direct messages, or both.
  • Trigger channels is an optional comma-separated allowlist of 17–20 digit channel IDs.
  • Channel names and slash commands are unsupported.
  • WOML uses a shared resumable Gateway connection.
  • Approval notifications forbid message; lifecycle notifications require it.