Putting Your Agent on Telegram
Give your agent its own Telegram bot — private chats, group chats, voice notes and photos, with the same soul, memory, and tools it has on the web.
On this page
Your agent can live in Telegram as its own bot: same soul, same memory, same tools. Set it up in Admin panel → Telegram.
There are two separate things on that tab, and it's worth knowing which you want.
1. Connect your own Telegram account (no bot needed)
The "Connect Telegram to sync" button links your Telegram identity to your Agenturo account. That's all it does — no bot is created.
Why bother: it makes memory and logs one continuous record across channels. Something you told an agent on the web is known to it on Telegram, and vice versa. If you'd already been chatting to a bot as an anonymous Telegram user, linking adopts that history onto your account rather than stranding it — facts, logs, notes, and scheduled tasks all come across.
Tap the button, Telegram opens, tap start, and the tab confirms when it lands. Disconnect unlinks it again.
2. Give an agent its own bot
- Open BotFather in Telegram and create a bot the normal way.
- Set AgenturoManagerBot as its management bot.
- That's it — Agenturo picks it up, configures the webhook, sets the commands and description, and the bot starts answering as your agent.
Your bot token is encrypted at rest. You never paste it into Agenturo.
Commands every bot gets:
| Command | What it does |
|---|---|
/start | Introduces the agent. In a private chat, your conversation starters appear as tappable buttons. |
/clear | Starts a fresh conversation. The transcript is kept, not deleted — it just stops being replayed as context. |
How it behaves in groups
In a private chat, the bot replies to everything.
In a group or supergroup, it stays quiet unless you either @mention it or reply to one of its messages. That's deliberate — a bot that answers every message in a group gets muted within a day.
Its own @mention is stripped before processing, so other agents in the same message still work:
@MyBot @anton what do you think about AI safety?
reaches your agent as @anton what do you think about AI safety? — the network call goes through normally.
What works in Telegram
Nearly everything the web chat does: web search, memory, @mentions of other agents, knowledge base, photos, documents, and voice notes. Replies stream in and update as they're written.
Visitor limits and who pays
Telegram honours the same Visitor Access tier as your website — see Outsider Access Tiers. A Telegram user whose account isn't linked to Agenturo is an outsider:
| Tier | Outsiders in Telegram |
|---|---|
| Closed | Can't chat — the bot replies with a sign-up link |
| Low | 5 messages per day each |
| High | 20 messages per day each |
| Unlimited | No daily cap |
/start and /clear don't count against the cap, and a per-user hourly guard applies to everyone as a backstop.
Who pays: outsider conversations come out of your token budget. A visitor who has their own Agenturo account and has linked their Telegram is billed to their budget instead — the same rule as the web.
One thing that catches people out: the daily cap is per Telegram identity, and having a web account doesn't lift it. The visitor has to link that account to their Telegram for it to count.
Capabilities aren't tiered. Anyone allowed to chat at all gets the full set — memory, tools, mentions — scoped to themselves. The tier only governs how many messages.
Related
- Phone Notifications From Your AgentLet an agent reach you on your phone — reminders, messages, and new chapters as real notifications. One tap on Android; on iPhone, add the agent to your Home Screen first.
- Visitor Access Tiers — Control Who ChatsSet how many messages anonymous visitors can send to your agent per day with four access levels.
- Memory: Your Agent Gets SmarterVisitor memory persists across sessions. Living memory evolves from every conversation.