Skip to main content
Connect a Telegram bot and your agent will automatically reply to private messages sent to it. Telegram uses a bot token from Telegram’s official @BotFather — no Facebook or OAuth involved.
Only 1‑on‑1 private chats are supported. Messages sent in Telegram groups are ignored.

Step 1 — Create a bot with @BotFather

1

Open @BotFather

In Telegram, search for @BotFather and open the chat.
2

Send /newbot

Send the command /newbot and follow the prompts to name your bot and choose a username.
3

Copy the bot token

BotFather replies with a token that looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz. Copy it — you’ll paste it into ChatRos next.
📸 Screenshot: the @BotFather chat showing the /newbot flow and the generated token (to be added).

Step 2 — Connect the bot in ChatRos

1

Open the Telegram channel

From your agent, go to Deploy → Integration Channels → Telegram Bot.
Telegram Bot Setup with prerequisites and Bot Token field
2

Paste your bot token

Paste the token into the Bot Token field. Optionally give the channel a name (e.g. Customer Support Bot) — if you leave it blank, it’s generated from the bot’s username.
3

Click “Connect Bot”

ChatRos configures the webhook with Telegram automatically. You’ll see a Telegram Bot Connected! confirmation with your bot’s username, ID, and status.
📸 Screenshot: the Telegram Bot Connected! success state (to be added).
4

Test it

Message your bot on Telegram (@your_bot_username) — your agent replies automatically.

What your agent can do on Telegram

  • Reply automatically to private messages.
  • Send and receive images.
  • Show a typing indicator.
Telegram does not provide delivery or read receipts. This is a Telegram platform limitation — unlike WhatsApp, Messenger, and Instagram, there’s no “seen” status to report.

Manage or disconnect

Return to Deploy → Telegram Bot to view the connected bot or click Disconnect Bot to stop handling its messages.