Skip to content

Connect Telegram Support

HolderChat user guide

Documentation

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

  1. Open Telegram and go to the group that should receive support requests. Create a group first if you do not have one.
  2. Add @HolderchatBot to the group. You can open https://t.me/HolderchatBot, then use Telegram’s “Add to Group or Channel”.
  3. 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).
  4. In the group, send:
    /setup

    The bot replies with a short welcome message and a line similar to:

    My Chat ID: -1001234567890

    Copy that number, including the minus sign if it is present.

[Screenshot: Telegram group: /setup reply showing My Chat ID]

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

  1. In the HolderChat dashboard, open the chatbot and go to the Support tab.
  2. Under Add Support Channel, select Telegram Group and click Add.
  3. Paste the Telegram Chat ID from the /setup reply, for example -1001234567890.
  4. Enter a Thema, for example Technical Support. To route several topics to the same group, separate them with a semicolon: Technical Support; Billing.
  5. Save the chatbot settings. You do not need to click Rebuild Bot.
[Screenshot: Support tab: Telegram Group card with Chat ID and Thema filled in]

Step-by-step: Send the first notification

  1. Open Test Chatbot (or the widget on your site).
  2. 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.”
  3. The chatbot should confirm with a message similar to: “Your question has been sent! An agent will join the chat shortly.”
  4. 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.

  5. 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.”
  6. 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.
[Screenshot: Telegram group message with first-line conversation id, and an agent reply]

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 /setup does 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.

Related topics