Telegram Integration

Deploy your AI agent as a Telegram bot for customer conversations

Telegram Integration#

Connect a Telegram bot so customers can chat with your agent on Telegram. Customer Telegram is configured under Deploy → Telegram Bot.

Team alerts are separate. Staff notifications, approvals, and scheduled reports go through Settings → Team Channels, not the customer Telegram bot page.

Setting Up Customer Telegram#

Step 1: Open Telegram Bot#

  1. Go to your agent dashboard
  2. Open Deploy
  3. Choose Telegram Bot

Step 2: Connect your bot#

  1. Create a bot in Telegram with BotFather if you do not already have one
  2. Copy the bot token BotFather gives you
  3. Paste it into AlonChat and connect

After a successful connection, the page shows the connected bot username (for example @YourBusinessBot).

Step 3: Configure content and AI behavior#

On the Telegram Bot page you can typically set:

  • Welcome and menu-style content customers see in Telegram
  • Shortcuts / commands for the bot menu
  • AI auto-reply on or off
  • Telegram-specific guidance on top of the agent’s base instructions
  • Formatting options such as parse mode

Use the preview panel to check how the bot will look before you share it widely.

Step 4: Test#

  1. Open a chat with your bot in Telegram
  2. Send a few common questions from your business
  3. Confirm replies appear in Activity → Messages
  4. Test Pause AI from Activity if a human needs to take over

How It Works#

Code
Customer messages your Telegram bot
          |
Telegram delivers the message to AlonChat
          |
Your agent answers from your sources, tools, and guidance
          |
Reply is sent back in the Telegram chat

Features#

FeatureStatus
Text messagesSupported
Auto-replySupported
Human handoffSupported
Conversation historyTracked in Activity
Lead captureSupported when enabled for the agent
Bot menu / shortcutsSupported

Exact options depend on your plan and Telegram connection status.

Team Alerts on Telegram#

If you want staff notifications on Telegram (payment approvals, escalations, scheduled reports):

  1. Open Settings → Team Channels
  2. Connect or manage a team Telegram channel following the on-screen steps
  3. Use that channel for internal alerts — keep it separate from customer chats when possible

Roles and alert types are managed from Team Channels, not from Deploy → Telegram Bot.

Best Practices#

  1. Train the agent first — add sources and test in Agent Studio before sharing the bot link.
  2. Write clear Telegram guidance — short replies work best in chat apps.
  3. Keep auto-reply intentional — turn AI replies off if you only want manual handling.
  4. Monitor Activity — review early conversations and fix missing Q&A or product data quickly.
  5. Separate customer and team chats — do not mix staff alerts into the public customer bot.

Troubleshooting#

Bot not responding#

  1. Deploy → Telegram Bot shows Connected with the correct @username
  2. AI auto-reply is enabled for Telegram
  3. The agent has trained sources and still has credits
  4. Try a fresh /start or first message in Telegram

Wrong bot connected#

  1. Disconnect the current connection on the Telegram Bot page
  2. Connect the correct BotFather token
  3. Retest with a new Telegram chat

Slow responses#

  1. Switch to a faster model in Agent Studio → Guidance
  2. Remove duplicate or outdated sources
  3. Retry — occasional Telegram network delays can happen

Privacy and Security#

  • Keep BotFather tokens private — treat them like passwords
  • Only your connected bot can send customer messages into AlonChat
  • You can disconnect Telegram at any time from Deploy
  • Customer conversations can be reviewed and cleaned up from Activity / project data tools

Related Pages#