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:
- Send
/newbot - Pick a name and a username ending in
bot - 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 launchBot replies:
✅ Agent task created!
Task ID: tsk_abc123Notes
- 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