How to connect a Telegram bot to your agent

Step by step

1. Create and save the agent. Set a name, personality, rules and greeting — or describe the bot in words and the AI assistant fills the form. Save the agent so the "Telegram" section appears in the settings.

2. Get a token from @BotFather. In Telegram open @BotFather, send /newbot, set the name and @username. Copy the issued token like 1234567890:AA…

3. Paste the token on the "Telegram" tab. In the agent settings open the "Telegram" section, paste the token and press "Connect" — a t.me link and a "Connected" status appear.

4. Set up the bot. Fill in the profile, commands, menu button and quick-reply buttons. Any block can be assembled by AI by describing the bot in words.

5. Test in DMs and a group. Message the bot in a DM — it answers with the agent personality. In a group, add the bot and mention it: there it replies to a mention.

What you need before connecting

You can connect a Telegram bot only to an agent that already exists and has been saved — on the creation screen the "Telegram" tab is not there yet. First give the agent a name, personality, rules and greeting (or describe them in words to the AI assistant) and save it — then the "Telegram" section appears in the agent settings.

There is no separate "training" for the bot: in Telegram it answers with the same personality and from the same knowledge base as the agent does in the on-platform chat. Telegram is just one more surface of the same agent.

Get a token from @BotFather

In Telegram open @BotFather, send the /newbot command and set the name and @username of your future bot. In reply you get a token like 1234567890:AA… — this is the access key to your bot, keep it secret and do not share it.

Paste the token on the "Telegram" tab

In the agent settings open the "Telegram" section, paste the token into the field and press "Connect". The platform validates the token, brings the bot online and shows a t.me link to it and a "Connected" status badge. The token is no longer shown back — it is stored on the server. If you no longer need the bot, the same screen has a "Disconnect" button.

What you can set on the platform

Once connected, the bot is managed entirely from here — you never open @BotFather again. Each block is saved separately and pushed to Telegram right away:

• Bot profile: name, short description and description. The "Take from agent" and "Generate from role" buttons fill them in automatically.
• Commands: a list of /commands with descriptions. The "Suggest commands with AI" button builds them from the agent role.
• Menu button: a plain button or a command list next to the input field.
• Quick-reply buttons: rows of buttons under the input field — one line per row, buttons within a row separated by a vertical bar.
• AI assembly: describe the bot in words ("a food-delivery bot — add commands and buttons") and the assistant lays the draft out across the form fields.

How the bot works in DMs and groups

In direct messages the bot answers every message. In a group it replies by default only to a mention (@bot), a reply to its message or a command — so it does not flood the chat. The command menu adapts to the place: in DMs the full list, in groups without /start.

The request-contact and request-location buttons are shown by Telegram only in DMs. Once you add the bot to a group, you can enable games and moderation — these are separate sections of the agent settings.

FAQ

Related articles

• What a bot with a neural network is and how to make one
• A bot that runs games in your Telegram group
• Quick start: your first agent in 5 minutes