Telegram integrationTelegram logo

Telegram integration for AI agents.

Telegram integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Telegram tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.

What your agents can do

Real Telegram actions, managed and audited.

Your user connects Telegram once; your agent can then use the Telegram Bot API to inspect bots, receive updates, send messages and media, manage chats, handle payments, and work with stickers — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.

  1. 1

    Your user grants Telegram access once (OAuth) — the token lands in the vault.

  2. 2

    Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.

  3. 3

    Every routed call appends a hash-chained audit record — nothing leaves your infra.

Tools & triggers

Supported Telegram tools.

50 tools are generated from the published Telegram catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.

Showing 50 tools. All published catalog entries are included in this page's server-rendered HTML.

Add Sticker to Set
Add a new sticker to a set created by the bot.
Stickers
Answer Callback Query
Send answers to callback queries sent from inline keyboards.
Messaging
Answer Pre-Checkout Query
Respond to pre-checkout queries.
Payments
Answer Shipping Query
Reply to shipping queries.
Payments
Approve Chat Join Request
Approve a chat join request.
Member Management
Ban Chat Member
Ban a user in a group, a supergroup or a channel.
Member Management
Copy Message
Copy messages of any kind without the forward marker.
Messaging
Create Chat Invite Link
Create an additional invite link for a chat.
Invites
Create New Sticker Set
Create a new sticker set owned by a user.
Stickers
Decline Chat Join Request
Decline a chat join request.
Member Management
Delete Chat Photo
Delete a chat photo.
Chat Management
Delete Message
Delete a message, including service messages.
Message Editing
Delete Webhook
Remove webhook integration.
Getting Updates
Edit Message Caption
Edit captions of messages.
Message Editing
Edit Message Text
Edit text and game messages.
Message Editing
Export Chat Invite Link
Generate a new primary invite link for a chat.
Invites
Forward Message
Forward messages of any kind.
Messaging
Get Chat
Get up-to-date information about the chat.
Chat Management
Get Chat Administrators
Get a list of administrators in a chat.
Chat Management
Get Chat Member
Get information about a member of a chat.
Chat Management
Get Chat Member Count
Get the number of members in a chat.
Chat Management
Get File
Get basic info about a file and prepare it for downloading.
Bot Info
Get Bot Info
A simple method for testing your bot authentication token. Returns basic information about the bot in the form of a User object.
Bot Info
Get My Commands
Get the current list of the bot commands.
Bot Info
Get Updates
Receive incoming updates using long polling. Returns an array of Update objects. Notes: this method will not work if an outgoing webhook is set up.
Getting Updates
Get User Profile Photos
Get a list of profile pictures for a user.
Bot Info
Get Webhook Info
Get current webhook status.
Getting Updates
Leave Chat
Use this method for your bot to leave a group, supergroup or channel.
Chat Management
Pin Chat Message
Add a message to the list of pinned messages in a chat.
Chat Management
Promote Chat Member
Promote or demote a user in a supergroup or a channel.
Member Management
Restrict Chat Member
Restrict a user in a supergroup.
Member Management
Revoke Chat Invite Link
Revoke an invite link created by the bot.
Invites
Send Audio
Send audio files as a playable music track.
Messaging
Send Contact
Send phone contacts.
Messaging
Send Dice
Send an animated emoji that will display a random value.
Messaging
Send Document
Send general files.
Messaging
Send Invoice
Send invoices.
Payments
Send Location
Send a point on the map.
Messaging
Send Message
Send text messages.
Messaging
Send Photo
Send photos.
Messaging
Send Poll
Send a native poll.
Messaging
Send Video
Send video files.
Messaging
Send Voice
Send audio files as a voice message.
Messaging
Set Chat Administrator Custom Title
Set a custom title for an administrator in a supergroup promoted by the bot.
Member Management
Set Chat Description
Change the description of a group, a supergroup or a channel.
Chat Management
Set Chat Title
Change the title of a chat.
Chat Management
Set My Commands
Change the list of the bot commands.
Bot Info
Set Webhook
Specify a URL and receive incoming updates via an outgoing webhook.
Getting Updates
Unban Chat Member
Unban a previously banned user in a supergroup or channel.
Member Management
Unpin Chat Message
Remove a message from the list of pinned messages in a chat.
Chat Management
FAQ

Telegram integration, answered

How do AI agents use Telegram through Open Connector?
Your user connects Telegram once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Telegram tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
Is this a Telegram MCP server?
Yes. Open Connector can serve Telegram as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Telegram actions with credentials injected server-side.
Where do Telegram credentials live?
In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Give your agents Telegram — keep the keys.

Open source, self-hostable, with Telegram credentials that never leave your infrastructure. Run it from source today.