Skip to main content
Connect your Telegram bot and give your agents the ability to send messages, share media and documents, manage chats and groups, and respond to user interactions through the Telegram Bot API.

What you unlock

Messaging

Send, edit, delete, and forward messages in any chat or group your bot has access to.

Rich media sharing

Share photos, documents, locations, and polls directly through the bot.

Chat management

View chat details, list administrators, check member counts, and create invite links.

Bot configuration

Manage bot commands, process updates, and handle callback queries from inline keyboards.

Connect Telegram

1

Open Settings → Integrations

In any workspace go to Settings → Integrations and select Telegram.
2

Get your bot token

Open Telegram and message @BotFather. Send /newbot (or use an existing bot), then copy the bot token — it looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.
3

Paste and connect

Paste the bot token into the connection form and click Connect.
4

Start using it

Once connected, tools are immediately available to any agent in that workspace. Add the bot to any Telegram group or start a direct chat with it.
Telegram integrations use a bot token instead of OAuth. The bot can only interact with chats and groups where it has been explicitly added as a member.

Agent tools

Messages

ToolDescription
Send messageSend a text message to a chat or group
Edit messageEdit an existing message sent by the bot
Delete messageDelete a message from a chat
Forward messageForward a message from one chat to another

Media and content

ToolDescription
Send photoSend an image to a chat
Send documentSend a file or document to a chat
Send locationShare a geographic location
Send pollCreate and send a poll in a chat

Chats

ToolDescription
Get chatRetrieve details about a specific chat or group
Get chat administratorsList administrators of a group or channel
Get chat historyRetrieve recent messages from a chat
Get chat memberLook up a specific member’s status in a chat
Get chat members countGet the total number of members in a chat
Create chat invite linkGenerate an invite link for a group or channel

Bot

ToolDescription
Get meRetrieve the bot’s own profile information
Get updatesFetch pending updates (messages, callbacks) for the bot
Answer callback queryRespond to an inline keyboard button press
Set my commandsDefine the bot’s command menu

Triggers

Triggers are not yet available for Telegram. When trigger support is added, you will be able to start agent tasks automatically based on incoming messages and bot events.

Example use cases

Set up an agent to compile a daily summary from your project management tool and post it to a Telegram group every morning.
Have your agent monitor bot updates, interpret incoming questions, search your knowledge base, and reply with helpful answers directly in the chat.
Configure an agent to forward critical alerts — server downtime, new signups, payment events — as Telegram messages to a dedicated ops group.

Troubleshooting

Make sure the token is copied exactly from BotFather, including the colon and all characters. Tokens look like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz. If the bot was deleted or regenerated, you need a fresh token.
The bot must be added as a member of the group. Open the group in Telegram, tap Add Members, and search for your bot’s username. Also ensure the group’s privacy settings allow bots to read messages if needed.
If another service is consuming updates via webhook, the bot’s getUpdates polling may be blocked. Only one consumer can receive updates at a time. Disconnect any competing webhook integrations.
The bot needs admin privileges in the group to delete other members’ messages. It can always delete its own messages without admin rights.

Back to Integrations

View all available integrations