ProductReadyProductReady
Chat Channels

Telegram

Connect a Telegram bot to create Agent Tasks from chat messages.

Telegram

Create a Telegram bot via @BotFather, paste the token, and every message becomes an Agent Task.

📖 Official docs: Telegram Bot API

Create a Bot

Open @BotFather in Telegram:

  1. Send /newbot
  2. Pick a name and a username ending in bot
  3. Copy the Bot Token (looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Keep your bot token secret. Never commit it to version control.

Connect in ProductReady

Go to User Settings → Chat Channels → [+ Add] → Telegram, paste the Bot Token, and select a default space.

Or via API:

await trpc.channels.connect.mutate({
  provider: "telegram",
  credentials: { botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz" },
  defaultSpaceId: "space_abc123",
});

This verifies the token with Telegram, registers the webhook, and saves the channel.

Send a Task

Message your bot:

Write a blog post about our Q1 launch

Bot replies:

✅ Agent task created!
Task ID: tsk_abc123

Notes

  • Both plain text and /task <text> create tasks
  • The bot needs no special permissions — it only receives messages sent directly to it
  • Webhook requires HTTPS; use a tunnel (e.g. ngrok) for local development

On this page