Telegram In

Description

Trigger the workflow when someone messages your Telegram bot (official Bot API). One run per update with a fully normalized payload: chatId and userId, username and name, text or caption, media file_id references (photo at max resolution, document, voice, video, sticker), location, reply context, and inline-button clicks (callback_query) extracted as interactive {id, title}. Create the bot in 2 minutes with @BotFather — no business verification, no cost, no pre-approved templates: the fastest channel for a conversational bot or a live demo. Fail-closed security: every POST is accepted only when the X-Telegram-Bot-Api-Secret-Token header matches your configured secret (timing-safe). Automatic per-update_id dedup. Pair with the Telegram send node for a full bot: reply to the received chatId.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

⬆️ Node output

Fields available to downstream nodes via $node.<alias>.json.<field>:

• updateId
• kind
• messageId
• chatId
• chatType
• userId
• username
• firstName
• text
• interactive
• media
• location
• replyToMessageId
• timestamp
• raw

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-trigger_telegram-1",
  "defId": "trigger_telegram",
  "label": "Telegram In",
  "config": {
    "secretToken": "<secretToken>",
    "includeEdited": false
  }
}

🔗 Related nodes in the same category