Telegram Bot

🔑 BYO Key — Messaging

Send messages and notifications via Telegram Bot. Create a bot with @BotFather, add the token, and send messages to any chat.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

telegram_bot_token

Bot Token

Bot token from @BotFather on Telegram. Format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz_1234567.

Get your API key at core.telegram.org →

Endpoints (4)

POST send-message

Send a text message to a Telegram chat or group. Supports Markdown and HTML formatting.

Field	Type	Required	Description
`chat_id`	string	✓ Yes	Chat ID, group ID, or @channel_username to send to.
`text`	string	✓ Yes	Message text (max 4096 chars). Supports Markdown or HTML.
`parse_mode`	string	No	Formatting mode: "Markdown", "MarkdownV2", or "HTML". Default: plain text.

POST send-photo

Send a photo to a Telegram chat. Provide a public URL to the image.

Field	Type	Required	Description
`chat_id`	string	✓ Yes	Chat ID or @channel_username to send to.
`photo`	string	✓ Yes	URL of the photo to send (JPEG, PNG, GIF).
`caption`	string	No	Photo caption (max 1024 chars).

GET get-me

Get info about the bot: name, username, and capabilities. Use to verify the token is valid.

No input parameters required.

GET get-updates

Get recent messages and events sent to the bot. Returns up to 100 updates. Useful for getting chat IDs.

No input parameters required.

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
send-message	`telegram_send_message`
send-photo	`telegram_send_photo`
get-me	`telegram_get_me`
get-updates	`telegram_get_updates`

← Back to all integrations