Set up a Telegram bot and connect it to your AI team.
Connecting Telegram
Telegram is one of the available messenger channels for communicating with your AI team. Connecting a Telegram bot lets you chat with your agents directly from the messenger.
Setting Up the Bot
1. Create a Bot with BotFather
- Open Telegram and search for @BotFather
- Send
/newbot - Choose a name (e.g. "My AI Team")
- Choose a username (must end in
bot, e.g.my_ai_team_bot) - Copy the API token you receive
2. Add a Telegram Channel in Workspace
- Open your team in the editor
- Click Add Block and select Channel
- Choose Telegram from the channel type dropdown
- Paste the bot token into Bot Token
- Configure the DM Policy (see below)
- Save and start (or restart) the team
3. Start Chatting
Open your bot in Telegram and send a message. Your team will respond through the assigned persona.
Access Control
The DM Policy setting controls who can message your bot:
| Policy | Behavior |
|---|---|
| Allowlist (default) | Only users listed in Allowed Users can message the bot |
| Open | Anyone who finds the bot can send messages |
When using the allowlist policy, enter comma-separated Telegram usernames (with @) or numeric IDs in the Allowed Users field:
@alice, @bob, 123456789
If DM policy is set to "Allowlist" but no users are listed, nobody will be able to message the bot.
Assigning a Persona
Each channel block can be assigned to a specific persona in your team. The assigned persona handles all incoming messages from that channel. If your team has multiple personas, the channel persona acts as the entry point and can delegate to others based on your instructions.