Telegram is a secure, cloud-based messaging platform that enables fast and reliable communication across devices. With its powerful Bot API, Telegram provides a robust framework for automated messaging and integration.
With the Telegram integration in AACFlow.io, you can:
Send messages : Send text messages to Telegram chats, groups, or channelsDelete messages : Remove previously sent messages from a chatSend photos : Share images with optional captionsSend videos : Share video files with optional captionsSend audio : Share audio files with optional captionsSend animations : Share GIF animations with optional captionsSend documents : Share files of any type with optional captions
In AACFlow.io, the Telegram integration enables your agents to send messages and rich media to Telegram chats as part of automated workflows. This is ideal for automated notifications, alerts, content distribution, and interactive bot experiences.
Learn how to create a webhook trigger in AACFlow.io that seamlessly initiates workflows from Telegram messages. This tutorial walks you through setting up a webhook, configuring it with Telegram's bot API, and triggering automated actions in real-time.
VIDEO
Learn how to use the Telegram Tool in AACFlow.io to seamlessly automate message delivery to any Telegram group. This tutorial walks you through integrating the tool into your workflow, configuring group messaging, and triggering automated updates in real-time.
VIDEO
Integrate Telegram into the workflow. Send, edit, forward, copy, pin, and delete messages; send media, locations, contacts, and polls; react to messages; show chat actions; and look up chat and member info. Can be used in trigger mode to start a workflow when a message is sent to a chat.
Send messages to Telegram channels or users through the Telegram Bot API. Enables direct communication and notifications with message tracking and chat confirmation.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) textstring Yes Message text to send
Parameter Type Description messagestring Success or error message dataobject Telegram message data ↳ 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 or channel ↳ date number Unix timestamp when message was sent ↳ text string Text content of the sent message
Delete messages in Telegram channels or chats through the Telegram Bot API. Requires the message ID of the message to delete.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) messageIdstring Yes Telegram message ID (numeric identifier of the message to delete)
Parameter Type Description messagestring Success or error message dataobject Delete operation result ↳ ok boolean API response success status ↳ deleted boolean Whether the message was successfully deleted
Send photos to Telegram channels or users through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) photostring Yes Photo to send. Pass a file_id or HTTP URL captionstring No Photo caption (optional)
Parameter Type Description messagestring Success or error message dataobject 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
Send videos to Telegram channels or users through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) videostring Yes Video to send. Pass a file_id or HTTP URL captionstring No Video caption (optional)
Parameter Type Description messagestring Success or error message dataobject 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
Send audio files to Telegram channels or users through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) audiostring Yes Audio file to send. Pass a file_id or HTTP URL captionstring No Audio caption (optional)
Parameter Type Description messagestring Success or error message dataobject 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
Send animations (GIFs) to Telegram channels or users through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) animationstring Yes Animation to send. Pass a file_id or HTTP URL captionstring No Animation caption (optional)
Parameter Type Description messagestring Success or error message dataobject 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
Send documents (PDF, ZIP, DOC, etc.) to Telegram channels or users through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) filesfile[] No Document file to send (PDF, ZIP, DOC, etc.). Max size: 50MB captionstring No Document caption (optional)
Parameter Type Description messagestring Success or error message filesfile[] Files attached to the message dataobject 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
Edit the text of an existing message in a Telegram chat or channel through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) messageIdnumber Yes Identifier of the message to edit textstring Yes New text of the message
Parameter Type Description messagestring Success or error message dataobject 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
Forward a message from one Telegram chat to another through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Destination chat ID (numeric, can be negative for groups) fromChatIdstring Yes Source chat ID the original message belongs to messageIdnumber Yes Identifier of the message to forward in the source chat
Parameter Type Description messagestring Success or error message dataobject 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
Copy a message to another Telegram chat without a forward header through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Destination chat ID (numeric, can be negative for groups) fromChatIdstring Yes Source chat ID the original message belongs to messageIdnumber Yes Identifier of the message to copy in the source chat captionstring No New caption for the copied media (keeps the original if omitted)
Parameter Type Description messagestring Success or error message dataobject Copied message identifier ↳ message_id number Identifier of the new copied message
Send a point on the map to a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) latitudenumber Yes Latitude of the location longitudenumber Yes Longitude of the location
Parameter Type Description messagestring Success or error message dataobject Telegram message data for the sent location ↳ message_id number Unique Telegram message identifier ↳ date number Unix timestamp when message was sent
Send a phone contact to a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) phoneNumberstring Yes Contact's phone number firstNamestring Yes Contact's first name lastNamestring No Contact's last name vcardstring No Additional data about the contact in the form of a vCard
Parameter Type Description messagestring Success or error message dataobject Telegram message data for the sent contact ↳ message_id number Unique Telegram message identifier ↳ date number Unix timestamp when message was sent
Send a native poll to a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) questionstring Yes Poll question (1-300 characters) optionsjson Yes List of 2-10 answer options as text strings isAnonymousboolean No Whether the poll needs to be anonymous (defaults to true) allowsMultipleAnswersboolean No Whether the poll allows multiple answers
Parameter Type Description messagestring Success or error message dataobject Telegram message data for the sent poll ↳ message_id number Unique Telegram message identifier ↳ date number Unix timestamp when message was sent
Pin a message in a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) messageIdnumber Yes Identifier of the message to pin disableNotificationboolean No Pass true to pin silently without notifying chat members
Parameter Type Description messagestring Success or error message dataobject Pin operation result ↳ ok boolean API response success status ↳ result boolean Whether the message was pinned
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.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) messageIdnumber No Identifier of the message to unpin (omit to unpin the most recent one)
Parameter Type Description messagestring Success or error message dataobject Unpin operation result ↳ ok boolean API response success status ↳ result boolean Whether the message was unpinned
Set or remove an emoji reaction on a message in a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) messageIdnumber Yes Identifier of the target message reactionstring No Emoji to react with (leave empty to remove the reaction) isBigboolean No Pass true to show the reaction with a big animation
Parameter Type Description messagestring Success or error message dataobject Reaction operation result ↳ ok boolean API response success status ↳ result boolean Whether the reaction was set
Show a status action such as a typing indicator in a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID (numeric, can be negative for groups) actionstring Yes Type of action to broadcast (e.g. typing, upload_photo, record_video, upload_document, find_location)
Parameter Type Description messagestring Success or error message dataobject Chat action result ↳ ok boolean API response success status ↳ result boolean Whether the action was broadcast
Get up-to-date information about a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID or @username (numeric, can be negative for groups)
Parameter Type Description messagestring Success or error message dataobject 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
Get information about a member of a Telegram chat through the Telegram Bot API.
Parameter Type Required Description botTokenstring Yes Your Telegram Bot API Token chatIdstring Yes Telegram chat ID or @username (numeric, can be negative for groups) userIdnumber Yes Unique identifier of the target user
Parameter Type Description messagestring Success or error message dataobject 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
A Trigger is a block that starts a workflow when an event happens in this service.
Trigger workflow from Telegram bot messages and events
Parameter Type Required Description botTokenstring Yes Your Telegram Bot Token from BotFather
Parameter Type Description messageobject 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.) senderobject 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 updateIdnumber Update ID for this webhook delivery updateTypestring Type of update: message, edited_message, channel_post, edited_channel_post, unknown