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
FieldTypeRequiredDescription
botTokenstringYesBot token from @BotFather (format: 123456:ABCdef...)
chatIdstringYesNumeric chat ID (e.g. -100123456789) or @channelname
messagestringYesMessage text — HTML formatting and {{variables}} supported

---

How to get a bot token
  1. Open Telegram and search for @BotFather.
  2. Send /newbot and follow the prompts to name your bot.
  3. 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 @channelname handle directly.

---

Variables available

This node does not produce output variables.

---

Step-by-step setup
  1. Create a bot via @BotFather and copy the token.
  2. Get the chat ID of your target chat/channel.
  3. Add a Send Telegram node to the canvas.
  4. Paste the bot token and chat ID.
  5. Write your message — HTML tags like <b>bold</b>, <i>italic</i>, and <a href="url">link</a> are supported.
  6. 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.