Telegram Send Message

Sends messages via the Telegram Bot API from a workflow. Use it for bot replies, notifications, confirmations, and any programmatic messaging in Telegram.

Requirements

This plugin requires a Telegram bot token:

Create a bot via @BotFather and copy the token
Add TELEGRAM_BOT_TOKEN on the Env Vars page

The same bot token used by Telegram Trigger works for sending messages.

Output

Handle	Type	Description
`result`	object	Telegram message send result

The result (accessed as {{ telegram_message.* }}) shape:

Field	Type	Description
`success`	boolean	Whether the message was sent successfully
`message_id`	number	ID of the sent message
`chat_id`	string	Chat ID the message was sent to
`error`	string	Error message if `success` is `false`

Settings

Setting	Type	Description
`chat_id`	string	Chat ID to send the message to. Supports `{{ }}` bindings.
`text`	string	Message text content. Supports `{{ }}` bindings.
`parse_mode`	enum	Text formatting mode: `Markdown`, `HTML`, or `MarkdownV2`. Default: `Markdown`.
`reply_to_message_id`	number	Message ID to reply to (threads the response). Supports `{{ }}` bindings.

Authentication

Env Var	Description
`TELEGRAM_BOT_TOKEN`	Bot token from @BotFather (format: `123456:ABC-DEF...`)

Example

Reply to a user after a Telegram Trigger:

Chat ID: {{ telegram.chat_id }}
Text: Hello {{ telegram.from.first_name }}! I received your message.
Reply To Message ID: {{ telegram.message_id }}

Send a formatted confirmation with Markdown:

Chat ID: {{ telegram.chat_id }}
Text: *Order confirmed*\nYour order \#12345` has been placed.`
Parse Mode: Markdown

Reply Threading

Set Reply To Message ID to thread your response under the user's original message. Use {{ telegram.message_id }} from a Telegram Trigger to reply directly to the incoming message.

AI Agent Tool

Connect this node to an AI Agent as a tool. The agent can send Telegram confirmations on your behalf — for example, "send the user a confirmation on Telegram" — using dynamic values from the conversation context.

Parse Modes

Mode	Usage
`Markdown`	Legacy Markdown: bold, italic, inline code
`HTML`	HTML tags: bold, italic, and code formatting
`MarkdownV2`	Strict MarkdownV2 — special characters must be escaped with a backslash

Common Gotchas

Parse mode errors: Invalid formatting for the selected parse mode causes Telegram to reject the message. Test formatting with simple messages first.
MarkdownV2 escaping: Characters like ., -, (, ) must be escaped in MarkdownV2 mode.
Chat must exist: The user must have started a conversation with your bot before you can send them messages.
Check telegram_message.success: Connect the On Error branch or add an If node to handle send failures.