What you need
A Telegram account, and two minutes. There is nothing to host and nothing to install.Set it up
1
Add the channel
In the dashboard, go to Channels and pick Telegram.
2
Say whether you already have a bot
The steps differ, so the dialog asks first. Creating one uses
/newbot;
using one you already have uses /mybots.3
Get the token
Message @BotFather in Telegram and follow the
steps the dialog shows you. It ends with a token that looks like
123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw.4
Paste it and press Connect bot
We check the token with Telegram before saving it. If Telegram does not
recognise it, nothing is stored and the dialog tells you.
Making a bot
If you do not have one yet:- Open Telegram and message @BotFather.
- Send
/newbot. It asks for a display name, then a username ending inbot. - It replies with your token.
Using a bot you already have
- Message @BotFather.
- Send
/mybotsand choose the bot. - Tap API Token and copy it.
What we do with your token
We store it encrypted, and we never show it back to you. The dashboard displays the last four characters so you can tell two bots apart, and nothing more. There is no API that returns it. With it we do exactly one thing you did not do yourself: we ask Telegram to deliver your bot’s messages to us, and we send your replies back. Disconnecting undoes that. If you ever want to be certain, revoke the token in @BotFather. That invalidates our copy along with every other.Direct messages only
One-to-one chats become conversations. Group chats are ignored. A group has one chat id and many people in it, so there is no single customer to attach the conversation to, and everyone in the room would share one record. Telegram also hides most group messages from bots by default.What arrives
Text, and photos, files, voice notes, audio and video. Attachments are stored alongside the message with the same 10MB limit as everywhere else in the product. Anything larger, or a type we do not accept, is named in an internal note so your agent knows something was sent. A message with no words, like a photo on its own, still becomes a conversation. It gets a short placeholder line so the thread is not blank.Which conversation a message joins
Telegram has no threads. A chat is one continuous stream, so a new message joins your most recent conversation with that person unless it is already resolved or closed, in which case it starts a new one. That means a customer coming back a month later opens a fresh conversation rather than reviving a finished one.The Start button
Every new Telegram chat begins with the customer pressing Start, which sends the text/start to your bot.
That does not become a conversation. The bot replies with a short line inviting
them to ask their question, and waits. A ticket whose entire content is
/start is one your team would have to close on every first contact.
Customising the Start reply
By default the bot answers Start with a short line inviting them to ask their question, in the customer’s language. To say something else, open Channels → Telegram and fill in Reply to Start. Up to 300 characters.A custom greeting is one string, sent to everyone. Our default is translated
per customer; yours cannot be. Clear the field to go back to it.
Their profile picture
Where a customer has a Telegram profile photo, we fetch it once when their record is created and show it beside their name in the conversation. People with no photo keep the initials circle. The image is stored privately and shown through a short-lived signed link, not a public URL. Erasing a customer deletes the file along with the record.Automated replies
If you have AI auto-reply switched on, Telegram follows it like any other channel. There is a per-channel toggle under AI, so you can leave it on for email and off for Telegram, or the reverse.The states
The Channels screen shows which one you are in:
Reconnect needed is the one worth understanding. Because a bot has only one
webhook, connecting the same bot to another tool silently takes it away from
us. Telegram reports no error and neither does the other tool; your messages
just stop arriving. We check on every load of the Channels screen so the row
can tell you. Paste the token again to point it back here.