Telegram
Start with one bot
Most setups only need a bot token, one allowed user, and the default polling mode.
expand_more
Scan to open @BotFather
Create your bot
- Open @BotFather
- Send /newbot and follow the prompts
- Paste the token here
Bot token
Paste the token you got from @BotFather.
Turn on this bot
Enable message polling when you are ready for the bot to go live.
Bot name
A friendly internal label so you can tell bots apart.
Delivery mode
Polling is the simplest option. Webhook is for public HTTPS
setups.
Webhook URL
Your public Agent Zero base URL, for example
https://yourdomain.com.
Allowed users
Comma-separated @usernames or numeric IDs. Leave empty only if
you truly want open access.
Default project
Optional fallback project for conversations from this bot.
Group behavior
Choose whether the bot replies only when invited into the
conversation or to everything in a group.
Welcome new members
Send a greeting when someone joins the group.
Welcome message
Use {name} for the new member's name.
Agent instructions
Extra guidance for how the agent should reply in Telegram chats.
Check the connection
Advanced
Webhook secret
Optional shared secret for webhook verification.
Message notifications
Show a WebUI notification for each incoming Telegram message.
User project mapping
Map specific Telegram user IDs to projects with user_id=project
entries.
Attachment max age
How long to keep downloaded attachments. Use 0 to keep them
forever.