Telegram

Use Telegram's Bot API to send messages, photos, videos, audio, animations, documents, locations, contacts, or polls. Message actions also edit, forward, copy, pin, delete, and react; chat actions retrieve chat or member details and show status indicators.

Start workflows from Telegram messages

1. Send /newbot to BotFather in Telegram and copy the bot token.
2. Add a Telegram trigger to your workflow and enter Bot Token.
3. Deploy the workflow. Sim registers the generated webhook URL with Telegram.
4. Send a message to the bot and inspect the workflow run. The trigger returns message and sender data, including the source chat ID.

Telegram registers one webhook per bot. Registering it elsewhere redirects delivery, so use a separate bot when workflows need independent webhook destinations. See the Telegram bot tutorial.

The webhook setup video also demonstrates starting a run from an incoming message.

Send messages to a Telegram group

1. Add the bot to the group and grant the permissions needed by the action.
2. Obtain the group's numeric chat ID from a bot message update, such as the trigger's message.raw.chat.id. Group IDs can be negative.
3. Add a Telegram action block, select Send Message, and set Bot Token, Chat ID, and Message.
4. Run the workflow and verify the message in the group.

The group messaging video demonstrates the block configuration. Bot privacy settings affect which group messages Telegram delivers; receiving a command addressed to the bot can help verify the trigger before changing those settings.

Use the block

Send, edit, forward, copy, pin, or delete messages; send media, locations, contacts, and polls; set reactions and chat actions; and inspect chats and members. Bot messages and events can start workflows.

Actions

Telegram Send Message

Send a text message through the Telegram Bot API. Markdown is converted to Telegram HTML before sending; the response includes the sent message and recipient chat.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
text	string	Yes	Message text to send

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Sender information
↳ id	number	Sender user ID
↳ is_bot	boolean	Whether the sender is a bot
↳ first_name	string	Sender first name
↳ username	string	Sender username, when available
↳ chat	object	Recipient chat information
↳ id	number	Recipient chat ID
↳ first_name	string	Chat first name, for private chats
↳ username	string	Chat username, when available
↳ type	string	Chat type: private, group, supergroup, or channel
↳ date	number	Unix timestamp when message was sent
↳ text	string	Text content of the sent message

Telegram Delete Message

Delete messages in Telegram channels or chats through the Telegram Bot API. Requires the message ID of the message to delete.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
messageId	string	Yes	Telegram message ID (numeric identifier of the message to delete)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Delete operation result
↳ ok	boolean	API response success status
↳ deleted	boolean	Whether the message was successfully deleted

Telegram Send Photo

Send photos to Telegram channels or users through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
photo	string	Yes	Photo to send. Pass a file_id or HTTP URL
caption	string	No	Photo caption (optional)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data including optional photo(s)
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Chat information
↳ id	number	Chat ID
↳ is_bot	boolean	Whether the chat is a bot or not
↳ first_name	string	Chat username (if available)
↳ username	string	Chat title (for groups and channels)
↳ chat	object	Information about the bot that sent the message
↳ id	number	Bot user ID
↳ first_name	string	Bot first name
↳ username	string	Bot username
↳ type	string	Chat type (private, group, supergroup, channel)
↳ date	number	Unix timestamp when message was sent
↳ text	string	Text content of the sent message (if applicable)
↳ photo	array	List of photos included in the message
↳ file_id	string	Unique file ID of the photo
↳ file_unique_id	string	Unique identifier for this file across different bots
↳ file_size	number	Size of the photo file in bytes
↳ width	number	Photo width in pixels
↳ height	number	Photo height in pixels

Telegram Send Video

Send videos to Telegram channels or users through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
video	string	Yes	Video to send. Pass a file_id or HTTP URL
caption	string	No	Video caption (optional)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data including optional media
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Information about the sender
↳ id	number	Sender ID
↳ is_bot	boolean	Whether the chat is a bot or not
↳ first_name	string	Sender's first name (if available)
↳ username	string	Sender's username (if available)
↳ chat	object	Information about the chat where message was sent
↳ id	number	Chat ID
↳ first_name	string	Chat first name (if private chat)
↳ username	string	Chat username (for private or channels)
↳ type	string	Type of chat (private, group, supergroup, or channel)
↳ date	number	Unix timestamp when the message was sent
↳ text	string	Text content of the sent message (if applicable)
↳ format	object	Media format information (for videos, GIFs, etc.)
↳ file_name	string	Media file name
↳ mime_type	string	Media MIME type
↳ duration	number	Duration of media in seconds
↳ width	number	Media width in pixels
↳ height	number	Media height in pixels
↳ thumbnail	object	Thumbnail image details
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ thumb	object	Secondary thumbnail details (duplicate of thumbnail)
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ file_id	string	Media file ID
↳ file_unique_id	string	Unique media file identifier
↳ file_size	number	Size of media file in bytes
↳ document	object	Document file details if the message contains a document
↳ file_name	string	Document file name
↳ mime_type	string	Document MIME type
↳ thumbnail	object	Document thumbnail information
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ thumb	object	Duplicate thumbnail info (used for compatibility)
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ file_id	string	Document file ID
↳ file_unique_id	string	Unique document file identifier
↳ file_size	number	Size of document file in bytes

Telegram Send Audio

Send audio files to Telegram channels or users through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
audio	string	Yes	Audio file to send. Pass a file_id or HTTP URL
caption	string	No	Audio caption (optional)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data including voice/audio information
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Information about the sender
↳ id	number	Sender ID
↳ is_bot	boolean	Whether the chat is a bot or not
↳ first_name	string	Sender's first name (if available)
↳ username	string	Sender's username (if available)
↳ chat	object	Information about the chat where the message was sent
↳ id	number	Chat ID
↳ first_name	string	Chat first name (if private chat)
↳ username	string	Chat username (for private or channels)
↳ type	string	Type of chat (private, group, supergroup, or channel)
↳ date	number	Unix timestamp when the message was sent
↳ text	string	Text content of the sent message (if applicable)
↳ audio	object	Audio file details
↳ duration	number	Duration of the audio in seconds
↳ performer	string	Performer of the audio
↳ title	string	Title of the audio
↳ file_name	string	Original filename of the audio
↳ mime_type	string	MIME type of the audio file
↳ file_id	string	Unique file identifier for this audio
↳ file_unique_id	string	Unique identifier across different bots for this file
↳ file_size	number	Size of the audio file in bytes

Telegram Send Animation

Send animations (GIFs) to Telegram channels or users through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
animation	string	Yes	Animation to send. Pass a file_id or HTTP URL
caption	string	No	Animation caption (optional)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data including optional media
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Information about the sender
↳ id	number	Sender ID
↳ is_bot	boolean	Whether the chat is a bot or not
↳ first_name	string	Sender's first name (if available)
↳ username	string	Sender's username (if available)
↳ chat	object	Information about the chat where message was sent
↳ id	number	Chat ID
↳ first_name	string	Chat first name (if private chat)
↳ username	string	Chat username (for private or channels)
↳ type	string	Type of chat (private, group, supergroup, or channel)
↳ date	number	Unix timestamp when the message was sent
↳ text	string	Text content of the sent message (if applicable)
↳ format	object	Media format information (for videos, GIFs, etc.)
↳ file_name	string	Media file name
↳ mime_type	string	Media MIME type
↳ duration	number	Duration of media in seconds
↳ width	number	Media width in pixels
↳ height	number	Media height in pixels
↳ thumbnail	object	Thumbnail image details
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ thumb	object	Secondary thumbnail details (duplicate of thumbnail)
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ file_id	string	Media file ID
↳ file_unique_id	string	Unique media file identifier
↳ file_size	number	Size of media file in bytes
↳ document	object	Document file details if the message contains a document
↳ file_name	string	Document file name
↳ mime_type	string	Document MIME type
↳ thumbnail	object	Document thumbnail information
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ thumb	object	Duplicate thumbnail info (used for compatibility)
↳ file_id	string	Thumbnail file ID
↳ file_unique_id	string	Unique thumbnail file identifier
↳ file_size	number	Thumbnail file size in bytes
↳ width	number	Thumbnail width in pixels
↳ height	number	Thumbnail height in pixels
↳ file_id	string	Document file ID
↳ file_unique_id	string	Unique document file identifier
↳ file_size	number	Size of document file in bytes

Telegram Send Document

Send documents (PDF, ZIP, DOC, etc.) to Telegram channels or users through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
files	file[]	No	Document file to send (PDF, ZIP, DOC, etc.). Max size: 50MB
caption	string	No	Document caption (optional)

Output

Parameter	Type	Description
message	string	Success or error message
files	file[]	Files attached to the message
data	object	Telegram message data including document
↳ message_id	number	Unique Telegram message identifier
↳ from	object	Information about the sender
↳ id	number	Sender ID
↳ is_bot	boolean	Whether the chat is a bot or not
↳ first_name	string	Sender's first name (if available)
↳ username	string	Sender's username (if available)
↳ chat	object	Information about the chat where message was sent
↳ id	number	Chat ID
↳ first_name	string	Chat first name (if private chat)
↳ username	string	Chat username (for private or channels)
↳ type	string	Type of chat (private, group, supergroup, or channel)
↳ date	number	Unix timestamp when the message was sent
↳ document	object	Document file details
↳ file_name	string	Document file name
↳ mime_type	string	Document MIME type
↳ file_id	string	Document file ID
↳ file_unique_id	string	Unique document file identifier
↳ file_size	number	Size of document file in bytes

Telegram Edit Message Text

Edit the text of an existing message in a Telegram chat or channel through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
messageId	number	Yes	Identifier of the message to edit
text	string	Yes	New text of the message

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Edited Telegram message data
↳ message_id	number	Unique Telegram message identifier
↳ date	number	Unix timestamp when message was sent
↳ text	string	Text content of the edited message

Telegram Forward Message

Forward a message from one Telegram chat to another through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Destination chat ID (numeric, can be negative for groups)
fromChatId	string	Yes	Source chat ID the original message belongs to
messageId	number	Yes	Identifier of the message to forward in the source chat

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Forwarded Telegram message data
↳ message_id	number	Identifier of the forwarded message
↳ date	number	Unix timestamp when message was sent
↳ text	string	Text content of the forwarded message

Telegram Copy Message

Copy a message to another Telegram chat without a forward header through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Destination chat ID (numeric, can be negative for groups)
fromChatId	string	Yes	Source chat ID the original message belongs to
messageId	number	Yes	Identifier of the message to copy in the source chat
caption	string	No	New caption for the copied media (keeps the original if omitted)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Copied message identifier
↳ message_id	number	Identifier of the new copied message

Telegram Send Location

Send a point on the map to a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
latitude	number	Yes	Latitude of the location
longitude	number	Yes	Longitude of the location

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data for the sent location
↳ message_id	number	Unique Telegram message identifier
↳ date	number	Unix timestamp when message was sent

Telegram Send Contact

Send a phone contact to a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
phoneNumber	string	Yes	Contact's phone number
firstName	string	Yes	Contact's first name
lastName	string	No	Contact's last name
vcard	string	No	Additional data about the contact in the form of a vCard

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data for the sent contact
↳ message_id	number	Unique Telegram message identifier
↳ date	number	Unix timestamp when message was sent

Telegram Send Poll

Send a native poll to a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
question	string	Yes	Poll question (1-300 characters)
options	json	Yes	List of 2-10 answer options as text strings
isAnonymous	boolean	No	Whether the poll needs to be anonymous (defaults to true)
allowsMultipleAnswers	boolean	No	Whether the poll allows multiple answers

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram message data for the sent poll
↳ message_id	number	Unique Telegram message identifier
↳ date	number	Unix timestamp when message was sent

Telegram Pin Message

Pin a message in a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
messageId	number	Yes	Identifier of the message to pin
disableNotification	boolean	No	Pass true to pin silently without notifying chat members

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Pin operation result
↳ ok	boolean	API response success status
↳ result	boolean	Whether the message was pinned

Telegram Unpin Message

Unpin a pinned message in a Telegram chat through the Telegram Bot API. Unpins the most recent pinned message when no message ID is given.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
messageId	number	No	Identifier of the message to unpin (omit to unpin the most recent one)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Unpin operation result
↳ ok	boolean	API response success status
↳ result	boolean	Whether the message was unpinned

Telegram Set Message Reaction

Set or remove an emoji reaction on a message in a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
messageId	number	Yes	Identifier of the target message
reaction	string	No	Emoji to react with (leave empty to remove the reaction)
isBig	boolean	No	Pass true to show the reaction with a big animation

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Reaction operation result
↳ ok	boolean	API response success status
↳ result	boolean	Whether the reaction was set

Telegram Send Chat Action

Show a status action such as a typing indicator in a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID (numeric, can be negative for groups)
action	string	Yes	Type of action to broadcast (e.g. typing, upload_photo, record_video, upload_document, find_location)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Chat action result
↳ ok	boolean	API response success status
↳ result	boolean	Whether the action was broadcast

Telegram Get Chat

Get up-to-date information about a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID or @username (numeric, can be negative for groups)

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram chat information
↳ id	number	Unique chat identifier
↳ type	string	Chat type (private, group, supergroup, channel)
↳ title	string	Chat title for groups and channels
↳ username	string	Chat username, if available
↳ first_name	string	First name for private chats
↳ last_name	string	Last name for private chats
↳ description	string	Chat description
↳ bio	string	Bio of the other party in a private chat
↳ invite_link	string	Primary invite link for the chat
↳ linked_chat_id	number	Linked discussion or channel chat ID

Telegram Get Chat Member

Get information about a member of a Telegram chat through the Telegram Bot API.

Inputs and outputs

Input

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot API Token
chatId	string	Yes	Telegram chat ID or @username (numeric, can be negative for groups)
userId	number	Yes	Unique identifier of the target user

Output

Parameter	Type	Description
message	string	Success or error message
data	object	Telegram chat member information
↳ status	string	Member's status (creator, administrator, member, restricted, left, kicked)
↳ user	object	Information about the user
↳ id	number	Unique user identifier
↳ is_bot	boolean	Whether the user is a bot
↳ first_name	string	User's first name
↳ last_name	string	User's last name
↳ username	string	User's username

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Telegram Webhook

Trigger workflow from Telegram bot messages and events

Configuration and outputs

Configuration

Parameter	Type	Required	Description
botToken	string	Yes	Your Telegram Bot Token from BotFather

Output

Parameter	Type	Description
message	object	Telegram message data
↳ id	number	Telegram message ID
↳ text	string	Message text content (if present)
↳ date	number	Date the message was sent (Unix timestamp)
↳ messageType	string	Detected content type: text, photo, document, audio, video, voice, sticker, location, contact, poll
↳ raw	object	Raw Telegram message object
↳ message_id	number	Original Telegram message_id
↳ date	number	Original Telegram message date (Unix timestamp)
↳ text	string	Original Telegram text (if present)
↳ caption	string	Original Telegram caption (if present)
↳ chat	object	Chat information
↳ id	number	Chat identifier
↳ username	string	Chat username (if available)
↳ first_name	string	First name (for private chats)
↳ last_name	string	Last name (for private chats)
↳ title	string	Chat title (for groups/channels)
↳ from	object	Sender information
↳ id	number	Sender user ID
↳ is_bot	boolean	Whether the sender is a bot
↳ first_name	string	Sender first name
↳ last_name	string	Sender last name
↳ username	string	Sender username
↳ language_code	string	Sender language code (if available)
↳ reply_to_message	object	Original message being replied to
↳ entities	array	Message entities (mentions, hashtags, URLs, etc.)
sender	object	Sender information
↳ id	number	Sender user ID
↳ username	string	Sender username (if available)
↳ firstName	string	Sender first name
↳ lastName	string	Sender last name
↳ languageCode	string	Sender language code (if available)
↳ isBot	boolean	Whether the sender is a bot
updateId	number	Update ID for this webhook delivery
updateType	string	Type of update: message, edited_message, channel_post, edited_channel_post, unknown