Telegram

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
TELEGRAM_BOT_TOKENYesTelegram bot token issued by @BotFather, in the form 123456789:ABC-DEF.... Docs.

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

Provider API reference.

Tools

ToolAccessDescription
Send Message<br /><code className="reference-identifier">telegram__send_message</code>WriteSend message
Get Updates<br /><code className="reference-identifier">telegram__get_updates</code>ReadGet updates
Get Me<br /><code className="reference-identifier">telegram__get_me</code>ReadGet bot profile
Send Photo<br /><code className="reference-identifier">telegram__send_photo</code>WriteSend photo
Edit Message Text<br /><code className="reference-identifier">telegram__edit_message_text</code>WriteEdit message text

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.