Telegram for AI agents
Agents read Telegram at once. Changes and sends are held for a person's approval by default.
About Telegram
Telegram is a cloud-based messaging app with a focus on security and speed. Build bots to send messages, manage chats, and interact with users.
What an agent can do in Telegram
Every Telegram action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Telegram without asking first. 7 actions.
- Get Chat MemberGet a chat member's status/role (including the bot itself) to preflight permissions and troubleshoot 403/empty-history issues. Use before sending messages to verify bot membership and permissions.
- Get Chat InfoGet up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). The bot must be a member of or have access to the
- Get Chat AdministratorsGet a list of administrators in a chat. On success, returns an Array of ChatMember objects containing information about all chat administrators except other bots. Only meaningful for supergroups and c
- Get Chat HistoryGet chat history messages via the getUpdates polling method, filtered by chat_id. Returns only updates from the specified chat. Bot can only retrieve messages sent after it joined the chat; missing ol
- Get Chat Members CountGet the number of members in a chat. The bot must be an administrator in the chat for this to work. Insufficient admin permissions surface as authorization errors, not as a zero or empty count.
- Get Bot InfoGet basic information about the bot using the Bot API getMe method. Returns fields like id, username, first_name, and capabilities. If the response returns ok=false, the bot token is invalid or revoke
- Get UpdatesUse this method to receive incoming updates using long polling. An Array of Update objects is returned. IMPORTANT: This method will not work if an outgoing webhook is set up. Webhooks and getUpdates a
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 11 actions.
- Send MessageSend a text message to a Telegram chat using the Bot API. Bots must be members of target groups/channels with post rights. Rate limit: ~1 msg/sec per chat, ~30 msg/sec globally; exceeding returns 429
- Answer Callback QueryUse this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert.
- Export Chat Invite LinkGenerate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrat
- Delete MessageDelete a message, including service messages. Limitations: cannot delete messages older than 48 hours in groups, forwarded messages, or content in protected chats (returns 400 'message can’t be delete
- Edit MessageEdit text messages sent by the bot. Only bot-authored messages can be edited; editing messages from other users will fail. In groups, the bot must have edit permissions.
- Forward MessageForward messages of any kind. Service messages can't be forwarded.
- Send DocumentSend general files (documents) to a Telegram chat using the Bot API. Prefer over TELEGRAM_SEND_PHOTO when original file format or image resolution must be preserved. Rapid sends trigger flood control
- Send LocationSend point on the map location to a Telegram chat using the Bot API.
- Send PhotoSend photos to a Telegram chat using the Bot API. Telegram compresses and re-encodes images; use TELEGRAM_SEND_DOCUMENT to preserve original resolution/format. Each call produces a separate post; no m
- Send PollSend a native poll to a Telegram chat using the Bot API.
- Set Bot CommandsUse this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands.
Changes wait in Needs you
Changes and sends in Telegram are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Telegram questions
Can an agent change data in Telegram on its own?
Not by default. Changes and sends in Telegram are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Telegram?
This connector lists 7 read actions. Reads run at once, without waiting for approval.
How does Telegram connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.