Automations
Send Telegram Node
4 min readnode-telegram
Send a message to a Telegram chat or channel via a bot you control.
Send Telegram Node
Sends a message to any Telegram chat, group, or channel using a Telegram Bot. Supports HTML formatting and {{variables}} placeholders.
When to use it
- Get instant Telegram notifications when a high-priority lead comes in.
- Send automation alerts to a private Telegram channel your team monitors.
---
Required fields
| Field | Type | Required | Description |
|---|---|---|---|
| botToken | string | Yes | Bot token from @BotFather (format: 123456:ABCdef...) |
| chatId | string | Yes | Numeric chat ID (e.g. -100123456789) or @channelname |
| message | string | Yes | Message text — HTML formatting and {{variables}} supported |
---
How to get a bot token
- Open Telegram and search for @BotFather.
- Send
/newbotand follow the prompts to name your bot. - BotFather will reply with your token — copy it.
How to get a chat ID
- For a personal chat: Start a conversation with your bot and visit
https://api.telegram.org/bot<TOKEN>/getUpdates— find"chat":{"id":...in the response. - For a group: Add the bot to the group, send a message, check getUpdates — group IDs are negative numbers.
- For a channel: Add the bot as an admin, then use the
@channelnamehandle directly.
---
Variables available
This node does not produce output variables.
---
Step-by-step setup
- Create a bot via @BotFather and copy the token.
- Get the chat ID of your target chat/channel.
- Add a Send Telegram node to the canvas.
- Paste the bot token and chat ID.
- Write your message — HTML tags like
<b>bold</b>,<i>italic</i>, and<a href="url">link</a>are supported. - Save and test.
---
Example config
json
{
"botToken": "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ",
"chatId": "-1001234567890",
"message": "<b>New lead:</b> {{lead.firstName}} {{lead.lastName}}\n<b>Email:</b> {{lead.email}}\n<b>Score:</b> {{variables.score}}"
}
---
Tips & gotchas
- Bot tokens are sensitive — store them as credentials in /workspace/credentials rather than hard-coding them in the node.
- HTML mode: only use the tags Telegram supports (
<b>,<i>,<code>,<a>). Unsupported tags will cause the send to fail. - For a channel, the bot must be an admin with "Post Messages" permission.
- If getUpdates returns an empty array, send a message to the bot or group first to trigger an update.