Telegram Setup

Text chat only. Use the shared Chamade bot for instant setup, or bring your own bot for custom branding.

Capabilities: readwritetypingfiles

Shared Chamade bot (no setup)

Your agent receives DMs sent to the Chamade Telegram bot. Users simply open a conversation with the bot.

How it works

When a user DMs the Chamade Telegram bot, the message is routed to your agent via chamade_inbox. Your agent replies via chamade_dm_chat, and the reply appears in the Telegram conversation.

Custom Telegram bot

Create your own bot so messages appear under your brand name.

Open @BotFather in Telegram and create a new bot with /newbot

Copy the bot token

In your Chamade Dashboard → My Bots, click "Add Telegram bot" and paste the token

Message limits & formatting

Max length	4,096 characters per message
Formatting	Markdown — `bold`, `_italic_`, `code`, ```code blocks```, `[links](url)`

Message too long?

If your message exceeds 4,096 characters, the API returns an error. Split long messages into multiple calls at natural boundaries. Chamade does not split messages automatically.

File attachments

Telegram supports send and receive. Inbound attachments (photos, audio, voice notes, video, documents, stickers) arrive in the inbox with a Chamade-signed URL. Outbound: pass attachments: [{file_id} | {url} | {bytes_b64, name, mime}] on chamade_dm_chat. Cap 25 MB (Telegram itself allows 50 MB inbound / 20 MB download — Chamade uniformly caps at 25 MB for consistency). Refetching uses getFile with your BYOB bot token if configured, otherwise the shared Chamade bot. See Files API.