Connect Telegram to AI agents

Connect Telegram to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

answer_callback_query

Answer Callback Query

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.

pin_message

Pin/Unpin Message

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.

manage_chat_member

Manage Chat Member

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.

send_poll

Send Poll

Create and send a poll or quiz to a chat. Supports regular polls with optional multiple-answer mode, and quiz-mode polls with a single correct answer and explanation.

answer_inline_query

Answer Inline Query

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_message

Send Message

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_message

Forward Message

Forward a message from one chat to another. The original sender attribution is preserved.

get_chat

Get Chat

Retrieve detailed information about a chat including its type, title, description, member count, and permissions. Works for private chats, groups, supergroups, and channels.

send_media

Send Media

Send a photo, document, audio, or video message to a chat. Provide a URL or file ID for the media. Supports captions with formatting.

update_chat

Update Chat

Update a chat's title, description, or create an invite link. The bot must be an admin with the appropriate permissions.

edit_message

Edit Message

Edit the text of a previously sent message. Works for messages sent by the bot in any chat, or inline messages. Provide either chatId + messageId, or inlineMessageId.

get_file

Get File

Retrieve file information and a download URL for a file shared in Telegram. Use the file_id from a received message to get the download link.

send_invoice

Send Invoice

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.

delete_message

Delete Message

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_poll

Stop Poll

Stop a live poll in a chat, freezing its current results. Once stopped, no more votes can be cast.

More integrations teams use with Telegram

Slack

Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis. Add or remove users, assign roles, kick or ban members, and receive supported message, guild, channel, member, and inbound webhook triggers.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs. Listen for webhooks on page, blog, comment, attachment, space, label, and user events.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Configure mail settings including forwarding rules, filters, vacation responders, signatures, aliases, and delegates. Import and insert messages for migration. Sync mailbox changes incrementally via history API. Subscribe to mailbox change notifications via push notifications.

Technical notes for Telegram

Send, edit, delete, forward, and pin messages in private chats, groups, supergroups, and channels. Support text, photo, video, audio, document, and sticker messages with rich formatting (HTML, Markdown) and interactive keyboards. Handle inline queries to provide rich search results directly in any chat. Manage chat members (kick, ban, unban), edit chat settings and permissions, create and manage invite links, and handle join requests. Process payments and invoices using Telegram Stars or third-party payment providers. Create, edit, and delete sticker and custom emoji packs. Serve HTML5 games with score tracking. Launch interactive Mini Apps (Web Apps) within chats. Integrate with business accounts to manage and reply to messages on behalf of businesses. Create and manage polls and quizzes. Upload and download files. Receive real-time webhook events for messages, reactions, chat membership changes, payment queries, poll updates, inline queries, business account events, and chat boosts.

Connect Telegram to production AI agents

See how Metorial gives Telegram access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Telegram to AI agents with Metorial.

  1. Can Metorial connect Telegram to AI agents?
    Yes. Metorial connects AI agents to Telegram through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.