Telegram

Connect a Telegram bot with its token, and let an agent answer the people who write to it, in private chats and in groups.

On Telegram, a business talks to people through a bot: an account you create in Telegram with a name and a username of its own. Connect the bot to Kilevel, and the private chats people have with it arrive in Chats, where the bot's agent answers them and your team can take over. The bot can also answer in groups once you switch that on.

Connect a bot

Create the bot in Telegram

Open @BotFather in Telegram and send /newbot. Give the bot a name and a username. @BotFather answers with the bot's token. For a bot you already have, send /mybots, choose the bot, then API Token.

Paste the token

In Kilevel, open Chats → Integrations → Telegram, paste the token into Bot token and click Connect bot. Kilevel tells Telegram to deliver the bot's messages to it.

Choose who answers

Under Who answers messages, choose an agent: its flow answers each new message. With Nobody: people answer, chats wait in Chats for your team.

You can connect several bots. Each shows its name, its @username and a link that opens it in Telegram; share that link (https://t.me/<username>) wherever people should find the bot.

Warning

The token is the key to the bot: anyone who has it controls the bot. Kilevel keeps it encrypted and never shows it again.

What people see

A person opens the bot in Telegram and presses Start, or writes to it. The agent greets them and the conversation runs on the agent's flow, like on any other messaging channel.

  • Text goes both ways. A long answer is sent as several messages.
  • Photos and files a person sends are attached to their message, and the agent can read them.
  • Voice notes are transcribed, and the agent answers the transcript in writing.
  • Choices the agent offers appear as buttons under its message; links appear as link buttons.
  • Stickers, locations, polls and similar messages reach the agent as a short note such as [Sticker].
  • Emoji reactions are off unless you switch on React with emojis in the flow (Advanced Settings - Chat). Then the agent may put one emoji on a person's message, beside its reply or instead of a few words such as "thanks" or "got it". It never reacts instead of answering a question.

In Chats, a person on your team can take a conversation over and reply by hand at any time, as on the other channels.

Using the bot in groups

A connected bot can also be added to a Telegram group or supergroup: in Telegram, open the group's name, choose Add members and pick the bot. Whether it answers there is your choice, per bot: under Chats → Integrations → Telegram, switch on Answer in groups. The switch is off at first, and while it is off the bot stays silent in every group and nothing from the group is kept.

With the switch on, the bot answers only a message that is addressed to it:

  • a message that mentions the bot (@botname),
  • a reply to one of the bot's messages,
  • a command to the bot, such as /help@botname, or a command that names no bot.

Everything else people write in the group is neither read nor kept. You do not need to change the bot's Group Privacy setting in @BotFather: it can stay as it is.

  • One conversation per group. Each group is one conversation in Chats, titled with the group's name, and every message shows the name of the person who wrote it.
  • Answers are replies. The agent answers as a reply to the message that addressed it, in the same topic when the group has topics. A reply your team types in Chats goes to the group.
  • Photos, files and voice notes are taken in only when they come with a message addressed to the bot.
  • Choices and links are written out as text in a group; buttons are for private chats.
  • Not answered: messages from anonymous group admins, from a linked channel and from other bots, and commands meant for another bot.
  • A busy group: the bot takes up to 10 addressed messages a minute and 200 an hour in one group. Messages beyond that are not answered.

Each bot lists the groups it is in, with who added it and when it was last addressed. A group that becomes a supergroup keeps its conversation. If the bot is removed from a group, Chats says so when you reply, and messages go through again once someone adds the bot back.

Messages addressed to the bot and its answers count like any other chat message, on the account that connected the bot. The rest of the group's conversation costs nothing.

Limits

Where the bot answersPrivate chats, and groups once Answer in groups is on, where it answers only messages addressed to it. It does not answer in channels.
Who it can write toPeople who have started the bot. A bot cannot write to someone first.
Reply windowNone. Unlike WhatsApp, a reply can go out at any time, and there are no templates.
Message length4,096 characters per message; longer answers are split.
Files from peopleUp to 20 MB each.
Voice notesTranscribed up to 10 minutes.

If a person blocks the bot in Telegram, messages no longer reach them, and Chats says so on the conversation. They go through again once the person unblocks the bot or writes to it.

When a bot needs reconnecting

A bot marked Needs reconnecting shows the reason. Click Paste the token again and enter the bot's current token; the bot keeps its chats and its settings.

  • The token was revoked or replaced in @BotFather, or the bot was deleted.
  • The bot was connected somewhere else afterwards. Telegram delivers a bot's messages to one place only, so connecting the same bot to another service or workspace moves it there. Use one bot per place.

Disconnect stops new messages from arriving. The bot's chats stay in Chats.

Your assistant on Telegram

Where your platform offers it, your personal assistant is on Telegram too. Link your own Telegram account under My assistant → Settings → Contact points → Your Telegram: the page shows a link and a QR code. Open it, press Start in Telegram, and the bot asks whether to link this Telegram account to your account, which it names with a masked email address. Press Link and the account is proved to be yours. Press Not me if you did not open the link from your own account. You can undo the link at any time by sending /unlink to the bot. From then on your assistant knows it is you there, and it can also write to you first, for example with a reminder or an approval that has Approve and Decline buttons.

Under My assistant → Settings → Connections you can give your assistant a bot of its own, with its own name and picture. A typed @username is not enough to link: a bot can only write to someone who has started it.

Telling your contacts on Telegram

Your assistant can send a track alert to one of your contacts on Telegram, but only after that contact has allowed it. A bot cannot write to someone who has never started it, so you invite them with a personal link.

  1. Give your assistant a bot of its own under My assistant → Settings → Connections. The bot that everyone on the platform shares is not used for contacts.
  2. Open the person under Your world → People, go to How to reach them → Telegram and choose Invite to Telegram. You get a personal link, with Copy and a QR code.
  3. Send the link to your contact yourself. They open it in Telegram, press Start, and the bot asks whether your assistant may send them updates there. Only Allow turns it on.
  4. In a track alert, pick Telegram under How. The list under the ways shows which contacts are on Telegram. Anyone who has not allowed it is told the other ways of the alert.

The link is for one person and one Telegram account, and it is valid for 30 days. New link replaces it and Remove takes everything back. Your contact can end the updates at any time by sending /stop to the bot or pressing Stop under an alert. After that nothing is sent to them on Telegram until you make a new link and they allow it again. Each alert has a Got it button, which shows as confirmed in the alert's history.

If you prefer that a person is never told on Telegram, choose Telegram under Don't contact them by on their page.

Ki in your own Telegram chats

Telegram lets you connect a bot to your own account so that it can help with your private chats. With a bot of Ki's own, Ki can read the chats you choose and, when you ask, answer someone there as you. Nothing is read until you have confirmed it in the app.

Set it up

  1. Give Ki a Telegram bot of its own and link your own Telegram to it (above).
  2. In Telegram, open @BotFather, choose the bot, open its settings and switch on Secretary Mode. Only the bot's owner can do this; the app shows whether it is on.
  3. In Telegram, open Settings → Chat Automation and add the bot. There you choose which chats it may access and what it may do, for example reply for you.
  4. In the app, under My assistant → Settings → Connections → Telegram, read What you agree to and confirm it. Then switch on the chats Ki reads.

What Ki does

  • Reads only what you chose. You choose twice: in Telegram, and in the app. A chat appears in the app once a new message comes in; Telegram hands over no list and no earlier messages.
  • Keeps it briefly. What Ki read is kept for 3 days unless you choose another period of up to 7 days, then deleted. Photos, files and voice messages are only noted, not opened.
  • Tells you what needs you. You choose whether Ki looks at new messages at once, counts them in your morning brief, or reads a chat only when you ask.
  • Answers as you, with your yes. Ki sends a message in a chat only when you ask it to, and each message waits for your approval. Telegram allows it only for 24 hours after the other person last wrote. Ki never deletes or edits messages and never changes your profile.
  • Treats other people's words as information. Whatever someone writes in a chat is never an instruction to Ki.

The other people in those chats are not told by Telegram that an assistant reads along; whether to tell them is up to you. To make sense of a message and draft answers, its content is sent to the AI providers Ki works with, which the consent text names.

Stop it at any time with Stop and delete what was read: Ki stops at once and everything it read is deleted. To take the bot out of your account as well, remove it in Telegram under Settings → Chat Automation.

Ki in Telegram groups

Ki, your assistant, can be in Telegram groups through a bot of its own, the one you gave it under My assistant → Settings → Connections → Telegram. The bot that everyone on the platform shares works in private chats only: added to a group, it says so and leaves.

  • Only your groups. Ki answers in groups that you added its bot to or that you are a member of, with the Telegram account you linked. In any other group it says once that it only works in groups its person is in, and then stays silent.
  • Only when addressed. As for any bot: a mention, a reply to one of its messages, or a command.
  • Nothing private. Everyone in a group reads the answers, so there Ki treats everyone, you included, as a visitor: it answers what is asked and shares only what you allow it to share with people it does not know. It decides no approvals, changes no settings and links no accounts in a group. For anything private it asks you to continue in the private chat with the bot.
  • Your updates stay private. Reminders, briefs and approvals reach you in the private chat, never in a group. Linking and /unlink work in the private chat only.
  • Files and voice notes sent in a group are only noted; Ki does not open them there.
  • Posting for you. In the app or in the private chat, you can ask Ki to post a message into a group its bot is in. Ki does not post anything there that you keep from people it does not know.

The Answer in groups switch under Chats → Integrations is for a business's bots; it does not apply to a bot you gave to Ki.