< woml />
View on GitHub

<telegram>

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

Why use it

Use it to connect one Telegram bot to message-driven workflows, approvals, and lifecycle notifications without a public callback URL.

Common use cases

  • Start a workflow when the bot receives a message.
  • Send an approval to a private chat, group, or channel.
  • Deliver lifecycle notifications through a Telegram bot.

Syntax

WOML
<telegram
  id="agentMessage"
  events="message"
  bot-token="{{secrets.TELEGRAM_BOT_TOKEN}}"
/>

Rules and behavior

  • A trigger accepts only events="message" and requires a bot-token secret reference.
  • WOML receives trigger messages through shared long polling and ignores bot-authored messages.
  • Notification chats is a comma-separated list of positive or negative numeric chat IDs.
  • Approval notifications forbid message; lifecycle notifications require it.