Setup Guide

Connect Telegram to your site in about 15 minutes

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

~15 minone-time setup8 stepsrequired4optional, add anytime
1

Create your bot

Every Wisper site needs its own Telegram bot — this posts messages into your group and relays replies back to visitors.

  1. Open Telegram and message @BotFather, Telegram’s official bot for making bots.
  2. Send /newbot, then choose a display name and a username ending in bot.
  3. Copy the token from BotFather. You will paste it into the plugin in step 6.
7959758138:AAEcaicEHEReQ6qRVzmb5nrjiSTipgnT4
Treat this token like a password. If it leaks, use /revoke in BotFather.
2

Create the group

This is where your team will read and answer messages.

  1. In Telegram, create a new group, not a channel.
  2. Add at least one person, or just yourself for now.
  3. Give it a recognizable name, for example “Acme — Website Support”.
3

Turn on Topics

This makes each visitor land in their own thread instead of one shared stream.

  1. Open the group and tap the group name to open its info.
  2. Tap the edit (pencil) icon.
  3. Find Topics and switch it on.
💡 You can skip this step if you prefer one shared chat. Wisper falls back to that automatically.
4

Add the bot as admin

The bot needs admin rights to post messages, open topics, and close them.

  1. Open Administrators → Add Admin in the group.
  2. Search for the bot by the username from step 1.
  3. Turn on Manage Topics and standard message permissions.
5

Find your Chat ID

The plugin uses a numeric Chat ID, not the group name.

  1. Send any message in the group.
  2. Open this URL, replacing the token with your own.
  3. Copy the group id, including the minus sign.
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

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

Configure the plugin

In WordPress open Wisper → Settings.

  1. Paste the Bot Token from step 1.
  2. Paste the Chat ID from step 5.
  3. Turn Forum mode on if you enabled Topics.
  4. Click Save settings.
7

Connect the webhook

This is the step that links Telegram to your site.

  1. On the same settings page, click Set Webhook.
  2. The plugin registers your site address automatically.
  3. You will see a confirmation message if it worked.
⚠️ Your site needs a valid HTTPS address. Telegram will not deliver messages to plain HTTP.
8

Test it

The moment of truth.

  1. Open your site in a private/incognito window.
  2. Open the chat widget and click Invite a specialist.
  3. A new topic should appear in your Telegram group.
  4. Reply inside the topic and check that it appears in the widget.
✅ If the reply made it back to the widget, you are done.

Optional — Write your FAQ

Before a visitor reaches a human, Wisper can answer common questions. In Wisper → Settings → FAQ, add one question and answer per line, separated by a pipe.

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

Optional — Connect AI (Ollama)

Once your FAQ has a few entries, Wisper can answer questions that do not match the exact wording.

  1. Get an API key from ollama.com or run your own Ollama server.
  2. Open Wisper → Settings → AI and enable AI.
  3. Click Test AI to confirm the connection.

Optional — Quick reply buttons

Add phrases your team types often. They show up as tap-to-send buttons under every new topic.

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

Optional — Working hours

Outside configured hours the widget shows offline status and disables “Invite a specialist”, while FAQ and AI can keep answering.

Stuck on a step?

Most setup issues come down to the bot missing admin rights, or the webhook not being re-connected after a settings change.

Contact support →