Telegram Trigger

Trigger your workflow when a Telegram message is received. Requires Secure Vault credential setup.

Written By pvdyck

Last updated 16 minutes ago

Telegram Trigger

The Telegram Trigger starts your workflow when a Telegram bot receives a message or event.

Authentication

Requires a Telegram Bot token via Secure Vault credential configuration. Set this up in the Credentials section when publishing or as a Producer configuring the agent.

Supported Events

Select which update types to listen for. The default (*) captures all updates except Chat Member, Message Reaction, and Message Reaction Count.

Core Messaging

EventDescription
MessageNew incoming message (text, photo, sticker, etc.)
Edited MessageA message was edited
Channel PostNew post in a channel
Edited Channel PostA channel post was edited

User Interactions

EventDescription
Callback QueryIncoming callback query from an inline keyboard button
Inline QueryNew inline query
Chosen Inline ResultUser selected an inline query result
Message ReactionA user changed their reaction to a message
Message Reaction CountAnonymous reaction count update
PollNew poll state update
Poll AnswerUser changed their poll vote
Pre-Checkout QueryIncoming pre-checkout query (payments)
Shipping QueryIncoming shipping query (payments)

Chat Management

EventDescription
Chat MemberChat member status changed (requires admin privileges)
My Chat MemberBot's own member status changed
Chat Join RequestUser requested to join a chat (requires invite permissions)
Chat BoostChat was boosted
Removed Chat BoostChat boost was removed

Business Features

EventDescription
Business ConnectionBot connected/disconnected from a business account
Business MessageMessage from a connected business account
Edited Business MessageBusiness account message was edited
Deleted Business MessagesBusiness account messages were deleted

Additional Options

ParameterDescription
Download Images/FilesAutomatically download media attachments
Image SizePreferred image size when downloading (if download is enabled)
Restrict to Chat IDsOnly trigger for messages from specific chat IDs (comma-separated)
Restrict to User IDsOnly trigger for messages from specific user IDs (comma-separated)

Tips

  • Use Restrict to Chat IDs or Restrict to User IDs to filter events to specific conversations or users.
  • The Callback Query event is essential for bots with inline keyboards — it fires when a user taps a button.
  • To handle payments, listen for Pre-Checkout Query and Shipping Query events.
  • The default * selection is a good starting point; narrow down to specific events once you know which ones your bot needs.

Limitations

  • Webhook-based only — uses Telegram's webhook API (not long-polling)
  • Requires valid Secure Vault Telegram credential
  • Bot must have permission to receive messages in the target chat
  • Chat Member events require bot to be an admin in the chat

Related