TriggerTelegramReal-timeUpdated June 2026

How do I trigger when my Telegram bot receives a message?

Short answer: Drop the "Telegram → New Telegram Update" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Telegram, not on a polling schedule.

Use this trigger All 1 Telegram triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

New Telegram Update

When the matching event happens

telegramtelegram botnew messageedited messagechannel postcallback querywatch telegram botbot update

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "raw": {
    "message": {
      "chat": {
        "id": 987654321,
        "type": "private"
      },
      "date": 1712835600,
      "from": {
        "id": 987654321,
        "is_bot": false,
        "username": "johndoe",
        "first_name": "John"
      },
      "text": "Hello, bot!",
      "message_id": 456
    },
    "update_id": 123456789
  },
  "text": "Hello, bot!",
  "chat_id": 987654321,
  "from_id": 987654321,
  "chat_type": "private",
  "from_name": "John",
  "update_id": 123456789,
  "message_id": 456,
  "from_username": "johndoe"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
raw	object	{ … }
raw.message	object	{ … }
raw.message.chat	object	{ … }
raw.message.chat.id	number	987654321
raw.message.chat.type	string	"private"
raw.message.date	number	1712835600
raw.message.from	object	{ … }
raw.message.from.id	number	987654321
raw.message.from.is_bot	boolean	false
text	string	"Hello, bot!"
chat_id	number	987654321
from_id	number	987654321
chat_type	string	"private"
from_name	string	"John"
update_id	number	123456789
message_id	number	456
from_username	string	"johndoe"

Pairs with

Drop these actions after New Telegram Update.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about New Telegram Update.

How does the New Telegram Update trigger work in Telegram?

Fires when your Telegram bot receives one of the selected update types: new message, edited message, channel post, callback query, etc. One Telegram webhook is registered per workflow via setWebhook and the bot's allowed_updates list is set from your selected events.

Is the New Telegram Update trigger real-time?

Yes. New Telegram Update uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Telegram.

What data does New Telegram Update return?

The full event payload from Telegram. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter New Telegram Update so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need Telegram admin permissions to use New Telegram Update?

For most Telegram accounts a standard user can authorize the trigger. Some Telegram plans require an admin to enable third-party webhooks. Check Telegram's docs if the trigger fails to register.