Telegram

​

At a glance

• Availability: Experimental (how to enable).
• Authentication: API key.
• Connection: The key comes from TELEGRAM_BOT_TOKEN.
• Provider documentation: Authentication reference.

​

Credentials

Set these per environment. See Connect an integration.

​

Setup

1. Create a bot with @BotFather: In any Telegram client (a regular free Telegram account works), open a chat with @BotFather, send /newbot, and follow the prompts to pick a display name and a unique username ending in ‘bot’. BotFather replies with the bot token.
2. Store the token: Set the token from BotFather as TELEGRAM_BOT_TOKEN. You can regenerate it at any time with /revoke in @BotFather, which invalidates the old token.
3. Open a chat with the bot: Bots cannot message users first. Start a direct chat with your bot (or add it to a group) and send it a message; the chat then appears in getUpdates, where you can read the numeric chat_id used to address messages.

​

Provider notes

• The Telegram Bot API authenticates by embedding the bot token in the request URL path (https://api.telegram.org/bot<token>/<method>); it does not accept the token in an HTTP header.
• Keep the token secret: anyone who has it fully controls the bot.

Provider API reference.

​

Tools

​

Verify the connection

Call a read tool such as telegram__get_updates with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.