MxChat Telegram Integration

Connect your MxChat chatbot to Telegram for live agent support. When visitors request human help, conversations are routed to your Telegram supergroup where agents can respond in real-time.

Quick Setup

Follow these steps to connect MxChat to Telegram. The entire setup takes about 5 minutes.

1. Create a Telegram Bot

   Open Telegram and search for @BotFather. Send the command /newbot and follow the prompts to name your bot.

   BotFather will give you a Bot Token that looks like this:

   7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

   Save this token – you’ll need it in step 4.

2. Create a Supergroup with Topics

   Create a new Telegram group and convert it to a supergroup with topics enabled:

   • Create a new group in Telegram
   • Add your bot (the one you just created) to the group
   • Open group settings and enable “Topics”
   • Make your bot an administrator with permission to manage topics
   ✅ Tip

   When creating the group, add your bot immediately. This ensures the bot can see all messages from the start.

3. Get Your Group ID

   Add @raw_data_bot to your group temporarily. It will display your group’s chat ID, which looks like:

   -1001234567890

   Copy this ID, then remove @raw_data_bot from the group.

4. Configure MxChat Settings

   In your WordPress admin, go to MxChat → Settings → Integrations → Telegram and enter:

   Setting	Value
   Bot Token	Your token from BotFather
   Group Chat ID	Your supergroup ID (starts with -100)
   Webhook Secret	Any random string (auto-generated)

   Click Save Settings.

5. Set the Webhook

   Click the “Set Webhook” button in MxChat settings. This tells Telegram where to send messages from your agents.

   You should see a success message. Your integration is now active!

Core Features

How It Works

Here’s the flow when a visitor requests live agent support:

1. Visitor Requests Help

   A visitor clicks “Talk to a human” or types a request for live support in your chatbot.

2. Topic Created

   MxChat creates a new topic in your Telegram supergroup with the visitor’s session info, the current message, and the last 10 messages of the conversation.

3. Agent Responds

   Any team member in the Telegram group can reply to the topic. Their message is sent to the visitor.

4. Conversation Continues

   Messages flow bidirectionally until the conversation ends or the visitor switches back to AI.

5. Agent Ends the Conversation

   Type #close, #end, #disconnect, or #done in the topic to end the session. MxChat closes the topic and returns the visitor to the AI assistant. Closing the topic from Telegram itself does the same. If that visitor asks for an agent again, MxChat opens a fresh topic rather than reusing the closed one.

Telegram Setup Details

Bot Permissions

Your bot needs the following admin permissions in the supergroup:

• Manage Topics – Create new topics for each conversation
• Send Messages – Post visitor messages to topics
• Delete Messages – Optional, for cleanup

Converting to Supergroup

If your group isn’t already a supergroup, Telegram will automatically convert it when you enable topics. You can also manually convert by:

1. Opening group settings
2. Going to “Group Type”
3. Selecting “Supergroup”

MxChat Settings

Webhook Setup

The webhook allows Telegram to send agent messages to your website. MxChat handles this automatically when you click “Set Webhook”.

Manual Webhook Setup

If automatic setup fails, you can set the webhook manually using this URL in your browser:

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=https://yoursite.com/wp-json/mxchat/v1/telegram-webhook&secret_token=<YOUR_SECRET>

Replace:

• <YOUR_BOT_TOKEN> with your actual bot token
• yoursite.com with your domain
• <YOUR_SECRET> with your webhook secret

Verify Webhook Status

Check if your webhook is set correctly:

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getWebhookInfo

Troubleshooting

Frequently Asked Questions