Back to Agent Zero

Telegram Integration

plugins/_telegram_integration/webui/config.html

1.131.8 KB
Original Source

Telegram

Start with one bot

Most setups only need a bot token, one allowed user, and the default polling mode. Connect a bot

$store.telegramConfig.removeBot(idx))" title="Remove bot"> deleteexpand_more

Scan to open @BotFather !Scan to open @BotFather

Create your bot

  1. Open @BotFather
  2. Send /newbot and follow the prompts
  3. 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.

PollingWebhook

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.

No project

Group behavior

Choose whether the bot replies only when invited into the conversation or to everything in a group.

Reply when @mentioned or replied toReply to every group messageIgnore group messages

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

#Advancedkeyboard_arrow_down

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.

Connect another bot