🇬🇧 EN

✈️ Telegram Message

Sends a message to a Telegram chat, group, or channel using the Telegram Bot API. Requires a bot token created via BotFather and the chat ID of the target conversation.

Category: Notifications & Messaging · Type identifier: telegram_message

Overview

The Telegram Message node calls the Telegram Bot API's sendMessage endpoint to deliver a text message to any chat, group, or channel that your bot has been added to. Messages can be plain text or formatted using HTML or Markdown syntax that Telegram supports natively.

You need two pieces of information before using this node: a bot token from BotFather, and the chat ID of the target conversation. The bot must be a member of the target group or channel before it can post there.

Configuration

Field	Status	Description
Bot Token	Required	The Telegram Bot API token from BotFather, e.g. `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.
Chat ID	Required	The ID of the chat, group, or channel to send the message to. For private chats, this is the user's numeric ID. For groups and channels, it's a negative number or `@username`.
Message	Required	The message text. Supports `{{ variable }}` references. Supports HTML or Markdown formatting depending on Parse Mode.
Parse Mode	Optional	`HTML`, `Markdown`, or `MarkdownV2`. Controls how formatting in the message is interpreted. Default: `HTML`.
Disable Notification	Optional	Toggle. When on, the message is sent silently — the recipient receives no sound or vibration alert. Default: off.
Disable Link Preview	Optional	Toggle. When on, suppresses the link preview card that Telegram normally shows for URLs in messages. Default: off.

Output Data

After the message is sent, the following fields are available on the step output:

Field	Type	Description
`message_id`	number	Telegram message ID of the sent message.
`chat_id`	string	Chat ID the message was sent to.
`success`	boolean	True if the message was accepted by the Telegram API.

Example Usage

Add a Schedule Trigger node set to run daily at 08:00.
Add an Agent node (step key: summarise) that queries your data sources and produces a daily summary text in output.text.
Add a Telegram Message node. Set Bot Token to your bot's token, Chat ID to the target group's ID, and Message to:
<b>Daily Summary</b> {{ summarise.output.text }}
Set Parse Mode to HTML.

Tips & Notes

Keep your bot token private. Anyone with the token can send messages as your bot and read updates it receives. Store it securely and never commit it to source control.
Bot membership. The bot must be a member of the target group or channel before it can send messages there. For channels, the bot must have the Post Messages permission.
HTML escaping. If you use HTML parse mode, dynamic variable values containing <, >, or & must be HTML-escaped, otherwise Telegram will reject the message or render it incorrectly.
Message length. The maximum message length is 4096 characters. Split longer content across multiple Telegram Message nodes or summarise before sending.
Finding the chat ID. Send a message to the target chat, then call https://api.telegram.org/bot<TOKEN>/getUpdates and look for the chat.id value in the response.

Related Nodes

Discord Message — post to a Discord channel via webhook.
Slack Message — post to a Slack channel.
Email Notification — send via email instead.