Telegram Bot API connector. Send text, photos and documents to chats, groups and channels, edit, forward and delete messages, download files a user sent, inspect chats and administrators, and react in real time to incoming messages and inline-keyboard button presses.
Changelog
4 versions
v1.1.1
Latest
- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.
v1.1.0
- New Telegram User module (appmixer.telegram.user) that reads public channels as a user account through the official client API (MTProto), so channels the bot is not a member of can be read too. It connects with an API ID and API Hash from my.telegram.org and a pre-generated session string, and never joins the channels it reads.
- New Channel Post trigger: new posts in one or more public channels, polled by message ID so posts published while the connection to Telegram was down are delivered once it is back, in order and without duplicates. Only posts published after the flow starts are delivered.
- Find Channel Messages: channel history, newest first, with a limit, an after-message-ID filter and a before-date filter for backfill.
- Get Channel: title, description, subscriber count, and whether the channel is public, verified or restricted.
- Telegram flood control (FLOOD_WAIT) up to 60 seconds is waited out; longer waits are retried later instead of failing the flow. A private, misspelled or non-channel username is reported as an error.
- List Chat Administrators labels the nested user fields with the parent name ("User.Username") in the variable picker, like the other components.
- Store to CSV file output: the component no longer fails after the file is saved, values with a comma, a quote or a line break are quoted, and empty values stay empty instead of the word null.
v1.0.1
- Output labels of nested fields now carry the parent name ("From.Username", "Chat.Username") so the variable picker can tell them apart; schemas mark which fields Telegram guarantees (required) and declare the real chat flags.
- DeleteMessage explains Telegram's default permission model (own messages only unless the bot is an admin with the Delete messages right) in the tooltip and in the error.
- NewMessage tooltip explains the default privacy mode in groups.
- Triggers no longer fail to start when two flows of the same bot start at once: the webhook registration is read first and only written when it differs, and a Telegram 429 on setWebhook is retried after the requested delay.
v1.0.0
- Initial release.
Authentication
| Type | Details |
|---|---|
| API Key |
API ID (text)
Log in at https://my.telegram.org, open API development tools, create an
API Hash (password)
The App api_hash shown next to the API ID on my.telegram.org.
Session String (password)
A pre-generated user session for the API ID above. Create it once on your own machine
|
Triggers
3
New Callback Query
Triggers when a user presses an inline-keyboard button attached to one of the bot's messages. Answer it with the Answer Callback Query action, otherwise the button keeps showing a loading indicator. Shares the single per-bot webhook registration with the other Telegram triggers.
New Message
Triggers when the bot receives a message. Telegram allows only one webhook per bot, so every Telegram trigger of the same bot shares one registration created on flow start; stopping a flow leaves it in place because sibling flows may still need it. In groups the bot only sees messages addressed to it unless privacy mode is turned off in @BotFather.
New Channel Post
Triggers when a new post is published in one or more public Telegram channels. The channels are polled by message ID without joining them, so posts published while the connection to Telegram was down are delivered once it is back, in order and without duplicates. Starting the flow sets the starting point: only posts published after the start are delivered. Channels restricted in the account's region return no posts.
Actions
13
Answer Callback Query
Acknowledges an inline-keyboard button press, optionally showing a toast or an alert to the user who pressed it. Telegram shows a loading indicator on the button until the query is answered, so pair this with the New Callback Query trigger. Answers are accepted for a short window after the press.
Delete Message
Deletes a message from a chat. A bot can delete its own messages for up to 48 hours, and any message in a group only when it has the "Delete messages" admin right. This cannot be undone.
Edit Message
Replaces the text of a message the bot sent earlier. Telegram allows editing a bot message for up to 48 hours after it was sent, and returns the edited message.
Forward Message
Forwards a message from one chat to another, keeping the original author attribution. The bot must be a member of both chats.
Get Chat
Retrieves up-to-date information about a chat: title, type, description, invite link, default member permissions and photo.
List Chat Administrators
Returns the administrators of a group, supergroup or channel, including the creator and each administrator's rights. Bots in the administrator list are omitted by Telegram. Returns the full list in one call - Telegram does not paginate this endpoint.
Get File
Downloads a file a user sent to the bot and stores it for later steps. Takes the Telegram file ID emitted by the New Message trigger. Telegram only serves files up to 20 MB through this endpoint, and the download link it issues is valid for at least one hour.
Make API Call
Performs an arbitrary authorized call against the Telegram Bot API. The path is the Bot API method name, so
/sendMessage is enough - the bot token is added automatically. Use this to reach methods this connector does not expose as their own component.
Send Document
Sends a file to a Telegram chat. Provide either a public file URL or a Telegram file ID, or pick a stored file to upload. Bot uploads are capped at 50 MB by Telegram.
Send Message
Sends a text message to a Telegram chat, group or channel. Telegram caps a single message at 4096 characters; longer text is rejected with a 400.
Find Channel Messages
Returns messages from a public Telegram channel, newest first, without joining it. Use it to backfill history: limit the number of messages, read only messages newer than a known message ID, or only messages published before a date. Channels restricted in the account's region return no messages.
Get Channel
Retrieves details of a public Telegram channel without joining it: title, description, subscriber count, and whether the channel is public, verified, or restricted.
Send Photo
Sends a photo to a Telegram chat. Provide either a public image URL or a Telegram file ID, or pick a stored file to upload. Uploads are capped at 10 MB by Telegram; photos must be at most 10000 pixels in total width plus height.