Telegram Connector
Connect your agent to Telegram so users can interact with it from groups and direct chats
The Telegram connector lets users interact with your deployed agent directly from Telegram groups and direct chats. The webhook is auto-configured on deploy — no manual setup needed.
Prerequisites
You need a Telegram bot:
- Open Telegram and message @BotFather
- Send
/newbotand follow the prompts to create a new bot - Copy the Bot Token provided by BotFather (format:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz) - Optionally, use
/setdescriptionand/setabouttextto configure your bot's profile
Setup
Step 1: Create the Connector
- Open your agent in Agent Studio
- In the Connectors panel, click Add Connector
- Select Telegram as the provider
- Enter a Connector Name (lowercase with underscores, e.g.,
production_telegram_bot) - Fill in the connector parameters:
- Bot Token — The token from BotFather
- Configure access:
- Toggle Onboarding on to require approval for new users, or leave it off for open access
- If onboarding is enabled, set an Onboarding Message
- Use the Test button to validate your credentials
Step 2: Configure the Inbound Route
The inbound route filters which Telegram messages reach your agent. All parameters are optional — leave them empty to accept all messages.
| Parameter | Description |
|---|---|
| Chat ID | Limit to a specific chat or group |
| User ID | Limit to messages from a specific Telegram user |
| Reply To Message | Limit to replies to a specific message |
Step 3: Configure the Outbound Route
The outbound route controls where your agent sends responses.
- Enable use sender as receiver to reply in the same chat that triggered the message (recommended)
- If disabled, specify a Chat ID as the explicit response target
Step 4: Save
Save the agent revision to persist the connector configuration.
Deploy and Activate
- Click Deploy to publish the agent revision
- The webhook is automatically registered with Telegram during deployment
- The connector status should show Connected once activation completes
Unlike Slack and Microsoft Teams, Telegram does not require manual webhook configuration. The platform registers the webhook automatically using your bot token.
How Users Interact
Once the connector is connected, Telegram users can interact with your agent:
- Direct message — Send a message directly to the bot
- Group chat — Add the bot to a group and mention it or configure it to receive all messages (via BotFather's
/setprivacycommand) - Commands — Users can use Telegram bot commands (e.g.,
/start) to initiate interactions
The agent processes each message and responds in the same chat.
Viewing Conversations
All Telegram conversations are tracked in your agent's Conversations tab:
- Filter by Telegram provider to see only Telegram conversations
- View full message history including user messages and agent responses
- Each message links back to its execution record for debugging
Next Steps
- Access Control — Manage who can interact with your agent
- Slack Connector — Connect to another platform
- Conversations — Browse all conversations