Run chat, message and inline query actions through a connected bot.
Explore 37 workflow actions for Telegram, including account permissions and operation limits.
8 read actions29 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Answer callback query
Write
Acknowledge one inline-keyboard callback and optionally show a notification.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
The callback query ID must come from a Telegram update for this bot. Acknowledgment does not send a chat message.
A lost write receipt remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Answer inline query
Write
Return up to 50 typed Telegram inline results, including public media, cached media, places, contacts and games.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Inline mode must be enabled for the bot in BotFather. All 20 result types have bounded core fields, but optional provider fields such as rich content blocks and caption entities are not exposed. Media URLs must be public and reachable by Telegram; they are visible to end users. NodeHub does not inspect remote bytes or verify media format.
A lost acknowledgement is uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete message
Write
Delete a message in a chat where the selected bot has permission.
Permissions and limits
Account permissions
Bot deletion rights in the selected chat
Operation limits
Telegram normally allows deletion only within 48 hours and applies additional message and chat restrictions. Deletion is irreversible. A lost receipt is uncertain and not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Download file
Read
Download a Telegram bot file into this workflow's protected file store.
Permissions and limits
Account permissions
Bot access to the selected file
Operation limits
Files are limited to NodeHub's 16 MB workflow file limit, below Telegram's 20 MB hosted Bot API limit.
The original filename and MIME type may not survive Telegram's file API; NodeHub uses the returned path name and content type when available.
Edit message buttons
Write
Replace or remove the inline keyboard on an existing chat message.
Permissions and limits
Account permissions
Bot permission to edit the selected message
Operation limits
Chat messages only; inline message IDs are not supported. Omit the keyboard to remove buttons.
A lost receipt remains uncertain and is never automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit text message
Write
Edit a message in a specific Telegram chat and return the updated message receipt.
Permissions and limits
Account permissions
Bot permission to edit the selected message
Operation limits
Requires chat and message IDs. Inline-message editing is not supported. Telegram enforces message ownership and edit restrictions.
An unchanged message may be rejected by Telegram. A lost receipt remains uncertain and is never automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get bot profile
Read
Read the bot identity associated with the selected connection.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Get chat
Read
Read details of a Telegram chat accessible to the selected bot.
Permissions and limits
Account permissions
Bot access to the selected chat
Get chat administrators
Read
Read administrators of a chat accessible to the bot.
Permissions and limits
Account permissions
Bot access to the selected chat
Operation limits
Other bot administrators are omitted unless returnBots is true.
Get chat member
Read
Read one user's status in a chat.
Permissions and limits
Account permissions
Bot administrator rights are needed for a guaranteed result about another user
Get file metadata
Read
Get a Telegram file identifier and temporary file path without downloading its contents.
Permissions and limits
Account permissions
Access to a file received or sent by this bot
Operation limits
Returns metadata only, not file bytes. Telegram file paths are temporary; request fresh metadata before downloading.
Get pending updates
Read
Read pending bot updates using Telegram's short polling API. A higher offset confirms older updates.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
This API competes with other getUpdates consumers and cannot be used while the bot has a webhook. An offset above an update ID confirms that update with Telegram.
Get webhook status
Read
Check whether this bot currently delivers updates to a webhook.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Leave chat
Write
Remove the bot from a group, supergroup or channel.
Permissions and limits
Account permissions
Bot membership in the selected chat
Operation limits
Channel direct-message chats are not supported. The bot must be reinvited to act here again.
A lost write receipt remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Pin message
Write
Pin a message in a chat where the selected bot has permission.
Permissions and limits
Account permissions
Bot pin or edit administrator rights for the selected chat
Operation limits
Groups and channels require the matching administrator permission. A lost receipt is uncertain and not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send animation
Write
Resend an existing Telegram animation by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send audio
Write
Resend an existing Telegram audio by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send document
Write
Resend an existing Telegram document by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send location
Write
Send a geographic point to a Telegram chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Static location only. Live-location updates are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send media album
Write
Send 2 to 10 existing Telegram photos or videos as one album.
Permissions and limits
Account permissions
Bot permission to send media in the selected chat
Operation limits
Existing Telegram file IDs for photos and videos only. New uploads and external URLs are not supported.
A lost album receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send message and wait for response
Write
Send a Telegram message with a link to a NodeHub response page, then wait for approval, text or form answers.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
The recipient follows a link to NodeHub's response page. Replies inside Telegram are not captured. The page must be reachable from the recipient's device.
A lost message receipt remains uncertain and is never resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send photo
Write
Resend an existing Telegram photo by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send sticker
Write
Resend an existing Telegram sticker by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send text message
Write
Send a text message through the selected bot and return Telegram's message receipt.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Text messages only. Inline messages, media, paid messages and direct-message topics are not included.
A message receipt confirms Telegram acceptance, not recipient delivery or reading. A lost receipt remains uncertain and is never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send video
Write
Resend an existing Telegram video by file ID to a chat.
Permissions and limits
Account permissions
Bot permission to send messages in the selected chat
Operation limits
Resends an existing Telegram file ID only. Uploading new files and URL-based media are not supported.
A receipt confirms Telegram accepted the message, not delivery or reading. A lost receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set chat description
Write
Replace a group or channel description.
Permissions and limits
Account permissions
Chat administrator rights to change information
Operation limits
The bot must be an administrator with the matching rights in the selected group or channel.
A lost write receipt remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set chat title
Write
Replace a group or channel title.
Permissions and limits
Account permissions
Chat administrator rights to change information
Operation limits
The bot must be an administrator with the matching rights in the selected group or channel.
A lost write receipt remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Show chat action
Write
Show a typing indicator briefly in a chat.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
This is a brief client indicator, not a delivered message or lasting state.
A lost write receipt remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unpin message
Write
Unpin a specific message in a chat where the selected bot has permission.
Permissions and limits
Account permissions
Bot pin or edit administrator rights for the selected chat
Operation limits
Requires an explicit message ID so workflows do not unpin an unintended latest message. A lost receipt is uncertain and not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send animation
Write
Send a protected GIF or MP4 workflow file as Telegram animation.
Permissions and limits
Account permissions
Bot permission to send animations in the selected chat
Operation limits
Reads a protected GIF or MP4 file of at most 16 MB. File signature is checked, but animated frames or silent video are not decoded.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send audio
Write
Send a protected MP3 or M4A workflow file as Telegram music.
Permissions and limits
Account permissions
Bot permission to send audio in the selected chat
Operation limits
Reads a protected MP3 or M4A file of at most 16 MB. Format is checked by file signature, but codecs are not decoded.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send document
Write
Send a protected workflow file as a Telegram document.
Permissions and limits
Account permissions
Bot permission to send documents in the selected chat
Operation limits
Reads a protected file of at most 16 MB from this business, below Telegram's 50 MB document limit. Telegram's receipt confirms acceptance, not delivery.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send media album
Write
Send 2 to 10 protected photos or videos as one Telegram album.
Permissions and limits
Account permissions
Bot permission to send media in the selected chat
Operation limits
Reads 2 to 10 protected JPEG, PNG or MP4 files from this business, with a 16 MB total request limit. Photo bytes and video container signatures are checked, but video codecs are not decoded.
A lost album receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send photo
Write
Send a protected JPEG or PNG workflow file to a Telegram chat.
Permissions and limits
Account permissions
Bot permission to send photos in the selected chat
Operation limits
Reads a protected photo of at most 10 MB from this business. Telegram accepts the upload and returns a message receipt; delivery is not proven.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send static sticker
Write
Send a protected 512-pixel WEBP workflow file as a Telegram sticker.
Permissions and limits
Account permissions
Bot permission to send stickers in the selected chat
Operation limits
Only static WEBP stickers with one 512-pixel side and the other no larger than 512 pixels are accepted. Animated TGS and video WEBM are not supported.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send video
Write
Send a protected MP4 workflow file as Telegram video.
Permissions and limits
Account permissions
Bot permission to send video in the selected chat
Operation limits
Reads a protected MP4 file of at most 16 MB. MP4 signature is checked, but codecs and streaming suitability are not decoded.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload and send voice note
Write
Send a protected OGG/Opus, MP3 or M4A workflow file as a Telegram voice note.
Permissions and limits
Account permissions
Bot permission to send voice messages in the selected chat
Operation limits
Reads a protected OGG/Opus, MP3 or M4A file of at most 16 MB. Container signatures are checked, but playback and codecs are not fully decoded.
A lost upload receipt is uncertain and never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Telegram. A saved workflow is not a completed provider action.
