Telegram Action

Sends to Telegram from a flow: text, photos, documents, voice notes and polls. One of its eleven operations is unlike the rest — send and wait for response pauses the pipeline until a human answers, which turns a chat into an approval step.

Setup

A Telegram bot token, from BotFather. The bot has to have been started by the user, or be a member of the group, before it can message them — Telegram does not let bots open conversations.

Mode — action or AI toolkit

The Mode selector decides who drives the node. In Action mode you pick one operation and fill its fields, and the node does that every time it runs. In AI toolkit mode the operations become tools an AI Node can call, and the model chooses which one and with what arguments.

ℹToolkit mode is opt-in per node, and it is what makes this node show up in an AI Node's tool picker. A node left in Action mode is invisible to agents.

Operations

The Operation dropdown decides what the node does and which fields appear under it. These are the exact values the API validates against:

Value	In the dropdown	What it does
sendMessage	Send message	Text reply with optional inline keyboard
replyToMessage	Reply to message	Quote-reply with the threaded indicator above the bot's message
sendPhoto	Send photo	Image by URL or _file ref
sendDocument	Send document	File of any type by URL
sendVoice	Send voice	Send a voice bubble — pass a URL / file_id (or chain from the AI Node synthesize_voice tool)
sendAndWaitForResponse	Send & wait for response	Sends a message with Approve / Disapprove buttons (and optional free-text reply) — pipeline pauses until the user responds
editMessageText	Edit message	Replace text of a previously-sent message
deleteMessage	Delete message	Remove a message from a chat
answerCallbackQuery	Answer callback	Acknowledge an inline-button press (REQUIRED after callback_query)
forwardMessage	Forward message	Forward an existing message to another chat
sendPoll	Send poll	Multi-option poll (regular or quiz)

Send and wait for response

Posts a message with Approve and Disapprove buttons — and, optionally, a free-text reply — and then stops the pipeline until someone presses one. The answer arrives as the node's payload, so the branch after it can act on the decision.

ℹThis is the same shape as the Approval Gate, with Telegram as the surface instead of a dashboard page. Use it when the person deciding lives in a chat and will not open the dashboard.

Inline keyboard and chat action

The Advanced tab carries two extras: an inline keyboard — the buttons under a message, which you define as rows — and a pre-send chat action, the “typing…” indicator shown briefly before the message lands. The second is cosmetic, and it is what makes a bot feel less abrupt.

Gotchas

answerCallbackQuery is required after an inline-button press. Skip it and the user's client keeps showing a spinner on the button.
Bots cannot start conversations. The user must have messaged the bot first, or the bot must be in the group.
Voice notes want a URL or a file_id — the natural source is the AI Node's voice synthesis tool, chained into this node.
Editing only works on the bot's own messages, and only while Telegram still allows it.