Telegram

1 min read

Telegram connects an agent to private chats, groups, and channels through a bot. It is a good option for direct support, internal coordination, or alerts that need a conversational response.

Before creating the channel

A bot cannot start a private conversation on its own: the person must open it and select Start, or add it to a group. In groups, Telegram enables privacy mode by default; the bot receives only commands, mentions, replies to its messages, and other messages directed to it.

Private chat

Suitable for a one-to-one conversation. Authorize only the chats that should be able to write to the agent.

Group or channel

Add the bot to the relevant space. Keep privacy mode unless it needs to process the entire conversation.

Telegram bot documentation.

Create and connect the bot

Create the bot in BotFather

Open @BotFather, use /newbot, and save the token it returns. That token gives full control of the bot: treat it as a password.

Add Telegram to the agent

In the agent profile, open Channels, create a Telegram channel, and enter a name, the token, and its internal or external scope.

Define authorized chats

Add the identifiers of the chats, groups, or channels it can handle. For internal use, use the link available in the dashboard.

Activate and test

In a private chat, start the bot and send it a message. In a group, mention it or reply to one of its messages to check the intended flow.

Protect the bot token

Do not send it in messages or include it in screenshots or repositories. If you think it has been exposed, revoke it from BotFather and update it in Kujira.

Control what it receives

The allow list is the first input barrier: if it is empty, no incoming messages are accepted. The mention rule then reduces noise in groups; keep it enabled except in spaces specifically intended for the agent.

If the agent must read every group message, disable privacy mode in BotFather or make it an administrator only when essential. Both options expand what Telegram delivers to the bot and must be reviewed together with the authorized-chat list.

Resolve common issues

The bot does not reply privately

Check that the person has started the chat, the chat is authorized, and the channel is active.

The bot cannot see group messages

First try a mention. If it must read the full group, review privacy mode and add it to the group again if Telegram requests it.

The message arrives but is not handled

Review its internal or external scope, allow list, and channel instructions. External conversations are managed from [Agent Desk](/en/communication/agent-desk).