Telegram

Connect a Telegram bot to your Xagent account so you can start and continue tasks directly from Telegram. The integration is user-owned: Xagent starts or reloads the bot automatically when the channel is saved and active.

What It Supports

  • Text conversations
  • Continuing an existing conversation in the same chat
  • Starting a fresh conversation with /new
  • Stopping or pausing the current run with /stop or /pause
  • Uploading documents, images, audio, or video into the task workspace

Quick Setup

1. Create a bot in BotFather

In Telegram, chat with @BotFather, run /newbot, follow the prompts, and save the bot token:

123456789:ABCdefGHIjklmNOPqrsTUVwxyz

2. Add the channel in Xagent

Open the Channels page and add a new Telegram Bot channel. The fields are:

FieldRequiredDescription
Bot tokenYesThe token from BotFather.
Allowed usersNoComma-separated Telegram user IDs. If empty, any user who can reach the bot is allowed.
ActiveWhether this bot should be running.

3. Save and activate

Saving an active channel starts the bot. Message the bot in Telegram to create a task; it runs in your Xagent workspace and streams the result back to the chat.

Restrict access

Leaving Allowed users empty lets anyone who finds the bot use it — and run tasks in your workspace. Set the allowed Telegram user IDs for anything beyond personal testing.

Next Steps