Telegram

April 27, 2026 · View on GitHub

The Telegram node sends a message through the Telegram Bot API. Use it for chat replies, operational alerts, workflow status updates, or any downstream step that should message a Telegram user, group, or channel.

Overview

Property	Value
Inputs	1
Outputs	1
Output	`$nodeLabel.status`, `$nodeLabel.ok`, `$nodeLabel.result`

Parameters

Parameter	Type	Description
`credentialId`	UUID	`telegram` credential containing the bot token
`chatId`	expression	Destination chat, group, or channel ID
`message`	expression	Outgoing message text. Supports expressions.

Setup

Create a Telegram Bot credential
Add the Telegram node to your workflow
Select the credential
Set chatId to a static chat ID or an expression such as $telegramEvent.message.chat.id
Set message to the outgoing text or a template built from upstream data

Example

{
  "type": "telegram",
  "data": {
    "label": "telegramReply",
    "credentialId": "telegram-credential-uuid",
    "chatId": "$telegramEvent.message.chat.id",
    "message": "Received: $telegramEvent.message.text"
  }
}

Output Fields

Expression	Description
`$nodeLabel.status`	`"sent"` on success
`$nodeLabel.ok`	Telegram API success flag
`$nodeLabel.result`	Raw `sendMessage` result object from Telegram
`$nodeLabel.result.message_id`	Telegram message ID
`$nodeLabel.result.chat.id`	Destination chat ID returned by Telegram

Common Patterns

Pair it with Telegram Trigger for conversational bots
Send error notices from Error Handler
Post summaries generated by LLM or Agent

Telegram Trigger – Start a workflow from incoming bot messages
Third-Party Integrations – Telegram credential setup
Credentials Tab – Add and manage telegram credentials
Node Types – Overview of all node types