Setup Guide

Connect Telegram to your site in about 15 minutes

A bot, a group, one settings page. No complex dashboards — by the end of this page, a message from your site will show up as a dedicated topic in Telegram, and a reply there will show up on your site in real time.

~15 minone-time setup8 stepsrequired5optional, add anytime
1

Create your bot with @BotFather

Every Wisper site requires its own dedicated Telegram bot. The bot receives questions from your website visitors and posts replies from your support specialists.

  1. Open Telegram and message @BotFather, Telegram’s official verified bot for creating bots.
  2. Send the command /newbot.
  3. Enter a friendly display name for your bot (for example, Acme Support or Client Assistant).
  4. Enter a username ending in bot (for example, acme_support_bot).
  5. BotFather will reply with your HTTP API token. Copy this token — you will paste it into Wisper settings in Step 6.
7959758138:AAEcaicEHEReQ6qRVzmb5nrjiSTipgnT4
Security notice: Treat this token like a password. If it is ever compromised, send /revoke to @BotFather to immediately generate a new token.
2

Create your Telegram support group

This group is your support team’s workspace where all incoming customer conversations will arrive.

  1. In Telegram, create a New Group (not a channel).
  2. Add your support team members (or just yourself for initial testing).
  3. Give the group a clear name, for example “Acme — Website Support”.
3

Turn on Topics (Forum mode)

Enabling Topics transforms your group into a forum where every visitor gets their own dedicated thread, keeping chats clean and organized.

  1. Open the group and click or tap the group header to open Group Info.
  2. Click the Edit (pencil) icon.
  3. Find Topics and switch it ON.
💡 If you prefer a single shared chat stream instead of separate threads, you can leave Topics off. Wisper automatically supports single-group fallback mode.
4

Add the bot and grant Admin rights

The bot must be an Administrator in the group with permission to manage forum topics, post messages, and sync status.

  1. In your group info, open Administrators → Add Administrator.
  2. Search for your bot by the username created in Step 1 and select it.
  3. Mandatory: Ensure the «Manage Topics» (Управление темами) permission is toggled ON, along with standard messaging permissions.
  4. Click Done / Save to confirm administrator rights.
⚠️ Crucial requirement: If «Manage Topics» is disabled or the bot is only a regular member, Telegram will refuse to create visitor threads and chats cannot start.
5

Find your Chat ID

Wisper connects to your group using its unique numeric Chat ID, not the group title.

  1. Send any test message into your Telegram group (e.g. test).
  2. Open the URL below in your browser, replacing <YOUR_TOKEN> with your bot token from Step 1.
  3. In the returned JSON text, locate the "chat": { "id": ... } value. Copy this entire number, including the leading minus sign (-) (e.g. -1001234567890).
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

"chat": { "id": -1001234567890, "title": "Acme Support", "type": "supergroup" }
6

Configure Wisper in WordPress

Enter your credentials in the WordPress admin panel.

  1. In your WordPress dashboard, navigate to Wisper → Settings.
  2. Paste the Bot Token from Step 1.
  3. Paste the Chat ID (including the minus sign) from Step 5.
  4. Turn Forum Mode ON if you enabled Topics in Step 3.
  5. Click Save Settings.
7

Connect the webhook (MANDATORY)

The webhook establishes the bi-directional bridge between Telegram servers and your WordPress website.

  1. On the same Wisper → Settings screen, locate the «Set Webhook» button.
  2. Click «Set Webhook». The plugin registers your website address automatically with Telegram.
  3. Verify that a confirmation notice appears: Webhook set successfully.
🚨 MANDATORY STEP: You MUST click «Set Webhook». Without registering the webhook, Telegram will not deliver messages back to your website! Your site must also have a valid HTTPS SSL address.
8

Test live chat & delivery

Confirm that messages route smoothly between your site and Telegram.

  1. Open your website in an Incognito / Private browsing window.
  2. Open the chat widget in the corner and send a test message (or click «Invite a specialist» in Wisper Pro).
  3. A new topic thread should instantly appear in your Telegram group.
  4. Type a reply inside the Telegram topic and check that it appears in the website chat widget in real time.
  5. Notice read status: when the visitor has the chat panel open on screen, Telegram automatically marks the specialist’s message with an 👀 reaction.
✅ Success! If your reply made it back to the widget, your live support desk is fully connected.

Wisper Free vs Pro — What’s the difference?

Wisper Free: Direct live bridge to Telegram specialists. Visitors write immediately to your support team without intermediate menus or FAQ.

Wisper Pro: Adds an automated FAQ knowledge base, Ollama AI integration, quick-reply canned buttons in Telegram, and an interactive «Invite a specialist» handoff button.

Pro — Write your FAQ knowledge base

Before escalating to a human, Wisper Pro can automatically answer common questions. In Wisper → Settings → FAQ, add questions and answers separated by a pipe (or import CSV):

how much does it cost | Starting at $250, depends on quantity
do you ship internationally | Yes, 5-7 business days

Pro — Connect AI (Ollama)

Enable natural language AI answers grounded strictly in your FAQ content with zero hallucinations.

  1. Get an API key from ollama.com or run your own self-hosted Ollama server.
  2. Open Wisper → Settings → AI and enable AI.
  3. Click Test AI to confirm the connection with a live sample question.

Working hours & daily 20:00 cleanup

Working hours: Define your support schedule in settings. Outside configured hours, the widget displays an offline indicator.

Daily 20:00 cleanup: To protect visitor privacy and keep browser storage lightweight, chat history on the website automatically resets daily at 20:00 local time.

Pro — Quick reply buttons for specialists

Add phrases your support team types often. They show up as convenient tap-to-send inline buttons directly under every new visitor topic in Telegram.

Hi! How can I help you today?
Could you tell me which model you are interested in?
One moment, checking on that for you.

Stuck on a step?

Most setup issues come down to the bot missing Manage Topics admin rights, or forgetting to click «Set Webhook» in settings.
Our team is ready to assist if you have any questions.

Contact Support →
Alina
Alina
Online