Wisper β€” Live Chat via Telegram

Description

Wisper is a lightweight, modern live customer chat plugin for WordPress with seamless Telegram integration.

Connect your website directly to your Telegram team. Reply to your website visitors directly from the Telegram app on your smartphone or desktop computer using native Telegram supergroup topics.

Key Features:

  • Telegram Forum Topics (Supergroup Threads): Each new visitor dialogue automatically creates a dedicated topic in your Telegram supergroup with the visitor’s name/ID and referer page URL.
  • Status Indicators: Topics are tagged with status indicators (🟒 for active conversations and πŸ›‘ when closed) so your team can easily track dialogues.
  • Instant Real-Time Messaging: Streamlined delivery pipeline transmits messages between the site visitor and Telegram operators with sub-second synchronization.
  • Read Delivery Feedback: Telegram displays an πŸ‘€ reaction when the visitor actually views the specialist’s reply in the open chat widget.
  • Photo & Screenshot Attachments: Visitors can attach and upload images directly into the chat widget, which are forwarded straight to the Telegram topic.
  • Quick Reply Buttons: Save frequently typed phrases in settings; they appear as tap-to-send inline buttons under each new visitor topic in Telegram.
  • Working Hours Schedule: Configure your support hours; outside schedule, the widget displays an offline indicator.
  • Client Local Time & Persistence: Message timestamps adapt to the visitor’s device local time, and session history survives page reloads.
  • Daily 20:00 Chat Cleanup: Dialogues on the site automatically reset daily at 20:00 local time to protect visitor privacy and maintain fresh daily queues.
  • Spam & Bot Protection: Built-in cryptographic Time-gate and Honeypot mechanisms block automated spam bots silently.
  • Zero-Dependency Widget: Built with clean, vanilla CSS and JavaScript for lightning-fast site performance.
  • Audio Notifications: Gentle browser audio chime on incoming specialist replies powered by Web Audio API without downloading external audio files.

Wisper PRO

Looking for AI and automated FAQ self-service? Check out Wisper PRO to unlock:
* Grounded AI Assistant (Ollama): AI assistant that answers customer questions 24/7 strictly based on your FAQ knowledge base.
* FAQ Knowledge Base: In-depth question-and-answer library with instant semantic matching.
* “Invite a Specialist” Handoff: Intelligent self-service first, with human operator routing on demand.
* Unanswered Questions Collection: Automatically capture queries missing from your FAQ so you can expand answers in one click.
* CSV & Excel Bulk Management: Import and export your knowledge base easily.

External Services

This plugin relies on external services to deliver live chat messages between your website and your support team:

  • Telegram Bot API (https://api.telegram.org)
    • Service Provider: Telegram Messenger Inc.
    • Terms of Service: https://telegram.org/tos
    • Privacy Policy: https://telegram.org/privacy
    • What it does: Wisper connects your website’s live chat widget with your Telegram supergroup using the official Telegram Bot API. When a website visitor sends a live chat message or optional image attachment, the plugin sends this data via secure HTTPS request to https://api.telegram.org to create or update a dedicated topic thread in your Telegram supergroup. When an operator replies within that Telegram topic, Telegram sends a secure webhook back to your site to display the message in the visitor’s chat widget.
    • Data Transmitted: Visitor message text, visitor session identifier, current page URL, and optional customer image attachments. Data is sent only upon user action (sending a chat message or attachment). No visitor data is sent to any other third party.

Installation

  1. Upload the plugin archive via your WordPress admin (Plugins β†’ Add New β†’ Upload Plugin) or extract the wisper folder into /wp-content/plugins/.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Open Telegram, search for @BotFather, send /newbot, and copy your bot API token.
  4. Create a Telegram supergroup, enable Topics (Forum mode) in group settings, and add your bot as an Administrator with the Manage Topics permission enabled.
  5. In your WordPress admin, go to Wisper Settings, enter your Bot Token and group Chat ID, and click Set Webhook.
  6. Open your site in an incognito window and test sending a live chat message!

FAQ

How do I find my group’s Chat ID?

Send any test message into your Telegram group, then open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates in your browser. Look for "chat": {"id": -100xxxxxxxxxx}. Copy the entire number, including the leading minus sign.

Does the bot require admin privileges in Telegram?

Yes. The bot must be an Administrator in your Telegram group with the “Manage Topics” permission enabled so it can create topic threads for incoming customer sessions.

Why is clicking “Set Webhook” mandatory?

The “Set Webhook” button registers your website address with Telegram’s servers. Without completing this step, Telegram has no address to forward operator replies back to your site.

Does the plugin work on mobile devices?

Yes, the live chat widget is responsive and optimized for smartphones, tablets, and desktops.

Where are uploaded visitor images stored?

Images sent by visitors are forwarded directly to your Telegram topic thread. The temporary upload file on your server is immediately removed to keep your hosting storage clean.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Wisper β€” Live Chat via Telegram” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.3

  • Resolved all WordPress.org plugin review items.
  • Removed inline styles in favor of wp_add_inline_style.
  • Standardized option and transient prefixes to wisper_ (minimum 4 characters).
  • Secured client IP extraction against HTTP_X_FORWARDED_FOR header spoofing.
  • Fully separated Pro AI implementation code from free distribution repository.
  • Documented Telegram Bot API under External Services in readme.

1.0.2

  • Initial public release candidate for WordPress.org directory.