Connect your Telegram bot

1. Create your bot in BotFather

The bot is yours, not ours. Talk to @BotFather on Telegram, send `/newbot`, give it a name and username, and keep the token it returns.

Ownership matters: if one day you leave, the bot and its conversations stay with you.

2. Paste the token

In Channels → Telegram, paste the token and save. We register the webhook for you and check that it answers.

The token is stored encrypted and never shown again. If you lose it, regenerate it in BotFather —which is also what to do if it leaked.

3. Watch the health

The screen always shows the status, even when it is fine. A dead channel does not announce itself: messages stop arriving, and messages that never arrive are not missed.

  • Working: the webhook points here and Telegram confirms it.
  • Diverted: someone registered another webhook for the same bot. Saving again fixes it.
  • Down: the token is no longer valid. Regenerate in BotFather and paste it again.

4. Tie each chat to a customer

A Telegram message does not say who that person is in your system. From the customer record you generate a linking link that expires in five minutes and is used once.

Whoever opens it gets linked, but only if they also share their contact and the contact is their own: someone can forward another person card, and that verifies nothing.

Until that step happens, the agent answers with what it knows and touches nobody account.