Built by Metorial, the integration platform for agentic AI.
Delete a message from a chat. The bot can delete its own messages in any chat, and can delete other users' messages in groups/supergroups if it has the appropriate admin permissions.
Stop a live poll in a chat, freezing its current results. Once stopped, no more votes can be cast.
Retrieve detailed information about a chat including its type, title, description, member count, and permissions. Works for private chats, groups, supergroups, and channels.
Retrieve file information for a file shared in Telegram and provide it as a downloadable file. Use the file_id from a received message.
Edit the text of a previously sent message, or the caption of a photo, video, audio, or document message. Works for messages sent by the bot in any chat, or inline messages. Provide either chatId + messageId, or inlineMessageId.
Pin or unpin a message in a chat. Can pin a specific message, unpin a specific message, or unpin all messages. The bot must be an admin with the appropriate pin permission.
Send a photo, document, audio, or video message to a chat. Provide a URL or file ID for the media. Supports captions with formatting.
Respond to an inline query with a list of results. When a user types "@botname query" in any chat, the bot receives an inline query and should respond with results the user can select and send.
Send a payment invoice to a user or chat. Supports Telegram Stars and third-party payment providers. Can also generate a shareable invoice link instead of sending directly.
Respond to a callback query from an inline keyboard button press. Can show a notification or alert to the user, or open a URL. Must be called within 30 seconds of receiving the callback.
Send a text message to a Telegram chat, group, supergroup, or channel. Supports HTML and Markdown formatting, inline keyboards with callback buttons or URLs, and replying to specific messages.
Forward a message from one chat to another. The original sender attribution is preserved.
Update a chat's title, description, or create an invite link. The bot must be an admin with the appropriate permissions.
Manage a chat member by banning, unbanning, restricting, or promoting them. Can also retrieve a member's current status and permissions. The bot must be an admin with appropriate rights.
Create and send a poll or quiz to a chat. Supports regular polls with optional multiple-answer mode, and quiz-mode polls with one or more correct answers and an explanation.
Get the connected Telegram bot's identity and settings: its user ID, name, username, and whether it can join groups, read all group messages, and answer inline queries.
Fetch recent incoming updates for the bot, such as messages, button presses, inline queries, and membership changes. Use it to find chat IDs, read messages sent to the bot, and get callback or inline query IDs to answer.