Telegram Integration
Connect your AI agent to Telegram groups
Telegram Integration#
Deploy your AI agent to Telegram groups to handle conversations automatically.
Setting Up#
Step 1: Add a Telegram Group#
- Go to your agent dashboard
- Navigate to Deploy > Telegram
- Click Add Telegram Group
- Give the group a label (e.g., "Customer Support Group")
Step 2: Get the Link Code#
After creating the group:
- A link code is generated
- Copy the link code
- Follow the on-screen instructions to add the AlonChat bot to your Telegram group
Step 3: Add the Bot to Your Group#
- Open your Telegram group
- Add @AlonChatBot as a member
- The bot will automatically detect the group and verify the link code
- Auto-polling checks every 5 seconds for verification
Step 4: Verify Connection#
Once the bot is added and detected:
- The group status changes to "Verified"
- The channel is auto-enabled
- Your agent starts responding to messages in the group
Features#
| Feature | Status |
|---|---|
| Text messages | Supported |
| Auto-reply | Supported |
| Human handoff | Supported |
| Conversation history | Tracked |
| Lead capture | Supported |
| Multiple groups | Supported |
Managing Groups#
Multiple Groups#
You can connect multiple Telegram groups to a single agent:
- Click Add Telegram Group for each new group
- Each group gets its own link code and settings
- Manage all groups from the Deploy page
Group Actions#
- Copy link code: Share with group admins
- Regenerate link code: If the code expires or is compromised
- Delete group: Remove with confirmation dialog
- Test message: Send a test message to verify the bot is working
Bot Behavior#
Shared Bot Token#
AlonChat uses a shared bot (@AlonChatBot) as the default. This means:
- No need to create your own bot with BotFather
- The shared bot handles message routing automatically
- If a dedicated bot token is configured, it takes priority over the shared bot
Commands#
Telegram bots support these commands:
| Command | Description |
|---|---|
/start | Start conversation |
/help | Get help information |
/human | Request human support |
Best Practices#
- Set a clear group description mentioning the AI assistant
- Test thoroughly before sharing the group link publicly
- Monitor conversations regularly via your AlonChat dashboard
- Use multiple groups for different topics or teams
- Regenerate link codes periodically for security