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#

  1. Go to your agent dashboard
  2. Navigate to Deploy > Telegram
  3. Click Add Telegram Group
  4. Give the group a label (e.g., "Customer Support Group")

After creating the group:

  1. A link code is generated
  2. Copy the link code
  3. Follow the on-screen instructions to add the AlonChat bot to your Telegram group

Step 3: Add the Bot to Your Group#

  1. Open your Telegram group
  2. Add @AlonChatBot as a member
  3. The bot will automatically detect the group and verify the link code
  4. 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#

FeatureStatus
Text messagesSupported
Auto-replySupported
Human handoffSupported
Conversation historyTracked
Lead captureSupported
Multiple groupsSupported

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:

CommandDescription
/startStart conversation
/helpGet help information
/humanRequest human support

Best Practices#

  1. Set a clear group description mentioning the AI assistant
  2. Test thoroughly before sharing the group link publicly
  3. Monitor conversations regularly via your AlonChat dashboard
  4. Use multiple groups for different topics or teams
  5. Regenerate link codes periodically for security
Telegram Integration | AlonChat Docs