Summary
Connect a Telegram group so that, when a website visitor asks for a person, HolderChat posts the question to that group. An agent can answer by replying to the bot message in Telegram. The reply is saved in the conversation and appears in the website chat widget.
You do not create your own bot in BotFather for this integration, and you do not paste a bot token in the HolderChat dashboard. HolderChat sends group messages through the official HolderChat Telegram bot.
Prerequisites
- A Telegram group (or a place where your support team already talks).
- Permission to add members and bots to that group.
- The official HolderChat Telegram bot: @HolderchatBot (https://t.me/HolderchatBot).
- A HolderChat chatbot. You will configure the channel on the Support tab.
What you need
| Value | Where you get it | Example |
|---|---|---|
| Telegram Chat ID | Send /setup in the group after you add the HolderChat bot. The bot replies with the Chat ID. |
-1001234567890 |
| Thema | You choose this in the dashboard. It is the topic name the chatbot uses to pick this group. | Sales or Sales; Billing |
A bot token is not entered in the Support tab and is not required from you.
Step-by-step: Prepare the Telegram group
- Open Telegram and go to the group that should receive support requests. Create a group first if you do not have one.
- Add @HolderchatBot to the group. You can open https://t.me/HolderchatBot, then use Telegram’s “Add to Group or Channel”.
- For a group or supergroup, make sure the bot is allowed to read messages and is able to see replies. In many groups this means adding the bot as an administrator (with at least the right to post messages).
- In the group, send:
/setupThe bot replies with a short welcome message and a line similar to:
My Chat ID: -1001234567890Copy that number, including the minus sign if it is present.
The bot’s setup message also explains that agents should reply directly to the bot’s messages to send an answer back to the website visitor.
Step-by-step: Add the channel in HolderChat
- In the HolderChat dashboard, open the chatbot and go to the Support tab.
- Under Add Support Channel, select Telegram Group and click Add.
- Paste the Telegram Chat ID from the
/setupreply, for example-1001234567890. - Enter a Thema, for example
Technical Support. To route several topics to the same group, separate them with a semicolon:Technical Support; Billing. - Save the chatbot settings. You do not need to click Rebuild Bot.
Step-by-step: Send the first notification
- Open Test Chatbot (or the widget on your site).
- Ask to speak with a person. If you configured more than one topic, name the topic, for example: “I need to talk to someone in Billing.”
- The chatbot should confirm with a message similar to: “Your question has been sent! An agent will join the chat shortly.”
- In the Telegram group, you should see a new message from the HolderChat bot. The first line looks like this:
42:18:en The visitor wants to speak with Billing about an invoice for order 1001.Do not edit or delete that first line. HolderChat uses it to attach the agent’s reply to the correct conversation.
- In Telegram, reply to that bot message (use Telegram’s Reply action). Write the answer you want the visitor to see, for example: “Hello, I can help with your invoice.”
- The visitor should see that text in the website chat. If the visitor has already closed the chat, the message is still saved and will be there when they return to the same conversation.
How routing works
- If several Telegram or Teams channels exist, the chatbot picks one by matching the conversation topic to the Thema of a channel.
- If no topic matches, HolderChat may use another active channel for that chatbot. Use clear, distinct Thema values to avoid surprises.
What triggers a rebuild
| Action | Rebuild needed? |
|---|---|
| Add, edit, or remove a Telegram channel | No |
Limitations
- This is a handoff to a human in Telegram, not a second copy of the chatbot that answers inside Telegram on its own.
- Only a reply to the bot’s handoff message is delivered to the widget. A normal (non-reply) message in the group is not sent to the visitor.
- You cannot connect a private BotFather bot from the Support tab. The dashboard does not ask for a bot token.
- If
/setupdoes not answer, or group notifications arrive but replies never appear in the widget, contact HolderChat support.
Troubleshooting
Symptom: Escalation is not reaching Telegram
Cause: The Chat ID is wrong, the bot is not in the group, or the bot cannot post there.
Fix: Run /setup again in the same group, copy the Chat ID exactly, confirm the HolderChat bot is still a member (preferably an admin), save the Support tab, and test again.
Symptom: The visitor does not see the agent’s Telegram reply
Cause: The agent sent a new message instead of replying to the bot message, the first line of the bot message was changed, or the HolderChat reply service is not available.
Fix: Use Telegram’s Reply on the original handoff message. Leave the first line unchanged. If it still fails, contact HolderChat support.
Symptom: /setup does not answer
Cause: A different bot was added, or @HolderchatBot is not in the group.
Fix: Confirm you added @HolderchatBot, send /setup again, then contact HolderChat support if there is still no reply.