Chatgram | Instant Livechat Support via Telegram / Browser

Chatgram | Instant Livechat Support via Telegram / Browser drops a polished floating chat widget on every page of your WordPress site. Visitors chat with you in real time — you answer from Telegram, Slack or the Chatgram browser dashboard, and they see your reply instantly in the chat window, with typing indicators and read receipts. An optional AI assistant can answer first (or only when you’re away) and hands the conversation to a human whenever the visitor asks. If the visitor has left, your reply follows them by email.

Prefer the original asynchronous flow? Switch the widget to Email mode at any time: visitors fill in a contact form and receive your reply by email — exactly how Chatgram worked before live chat.

This plugin is built and maintained by brandID. It is not affiliated with, endorsed by, or sponsored by Telegram FZ-LLC or Telegram Messenger Inc. Telegram is a trademark of its respective owners and is used here only to describe the messaging service this plugin integrates with.

Why use this plugin

• Real-time live chat. Typing indicators both ways, delivered/seen double ticks, file sharing, conversation history that follows the visitor across pages, and a rating at the end of each chat.
• AI + human, your rules. Let the AI answer always, only when nobody is online, outside business hours, on a schedule, or only if no one replied within a set time. Visitors can ask for a person (or an instant AI answer) at any time.
• One-tap install. Activate the plugin, click “Connect on Telegram”, and you’re live.
• Stay where you already are. Replies happen in Telegram — the messaging app you check every day.
• Beautiful out of the box. A floating button and accessible modal that respect reduced-motion and high-contrast preferences.
• Speaks your visitors’ language. 117 languages, right-to-left included (Persian, Arabic, Hebrew, Urdu…). Pick yours during setup; visitors can switch in the chat.
• Customizable. Colors, placement, button text, and form labels — all editable from the WordPress dashboard.
• Built for performance. A small, deferred JavaScript bundle on your front-end with no third-party CDN requests.
• Privacy-first. No tracking cookies, no analytics pixels. Form data only flows between the visitor’s browser, the Chatgram API, and your Telegram account.
• WooCommerce-ready. Fully compatible with High-Performance Order Storage (HPOS) and the block-based Cart & Checkout. On WooCommerce stores, messages sent from a product, shop, cart, or checkout page automatically include what the customer was looking at (product name, price, and link), and you can optionally hide the widget on checkout to keep the purchase funnel distraction-free.

How it works

1. The plugin registers your site’s domain with the Chatgram service the first time you open the setup screen.
2. You receive a personal Telegram invite link inside the WordPress dashboard.
3. Press “Start” in the Telegram bot — your account is now linked to your site.
4. New chats arrive in Telegram (and Slack or the browser dashboard if you connect them). Reply to the chat card — or tap “Chat now” to talk to the visitor directly — and they see your message instantly. If they have already left, they receive it by email.

New sites start in live chat mode. Sites that were connected before version 1.4.0 keep the classic email form until you switch them to live chat in the Chatgram dashboard (Live Chat → Settings) or with the /livechat command in the Telegram bot.

Documentation and support

• Plugin homepage: https://chatgram.brandid.app
• Support and contact: https://brandid.app

External services

This plugin connects to the Chatgram API, an external service operated by brandID, to deliver visitor messages from your contact form to your Telegram account. The plugin cannot function without this service because Telegram delivery is performed by the Chatgram backend.

Chatgram API

• Service URL: https://chatgram-server.brandid.app
• Provider: brandID — https://brandid.app
• Terms of Service: https://chatgram.brandid.app/terms
• Privacy Policy: https://chatgram.brandid.app/privacy

The plugin communicates with the Chatgram API in these situations:

1. When you first open Chatgram → Setup in the WordPress admin (one-time handshake)

• What is sent: site URL, site name, admin email address, WordPress version, plugin version, locale.
• Why: to register your site with the Chatgram service and generate a personalized Telegram invite link.
• When: only the first time you open the Setup screen. The invite link is cached and reused on subsequent visits.

2. When a visitor uses the chat widget

• Live chat (default for new sites): when a page with the widget loads, it asks the Chatgram API whether the site runs live chat or the email form and receives a random visitor ID (kept in the browser’s local storage, not a cookie). With it the widget sends the page address and title, the browser language and time zone, and — while the visitor chats — their messages, files they attach, optional name and email (prefilled for logged-in WordPress users), typing status with a short preview of the message being typed, and read receipts. While the page is open the widget sends a small heartbeat (about every 45 seconds, only while the tab is visible) so your team can see live visitors; this can be switched off in the Chatgram live chat settings (“visitor tracking”).
• Email mode: the visitor’s name (optional), email address, subject, and message, together with your site’s domain — only when they submit the contact form.
• Why: so the Chatgram service can deliver the conversation to you on Telegram, Slack or the browser dashboard, show your replies to the visitor in real time, let the optional AI assistant answer, and email replies the visitor missed.

3. While you connect your inbox (Setup screen)

• What is sent: your site’s domain, the email address you enter for the browser dashboard sign-in link (only if you choose the browser dashboard), and periodic status checks while the Setup screen is open.
• Why: to email you the sign-in link, and to show live whether the connection is done and what the AI assistant is doing.

The Chatgram service may also read your site’s public pages (for example the home, about, shipping, returns, contact and FAQ pages — never the admin or logged-in areas) once after you connect, to write the knowledge base its AI assistant answers from. You can edit, rebuild or clear that knowledge base, or turn the AI off, in the Chatgram dashboard.

4. When the plugin is deactivated or uninstalled

• What is sent: your site’s domain.
• Why: to mark your entry as inactive on the Chatgram side so it stops accepting new tickets.
• When: only on plugin deactivation or uninstall. The endpoint is https://chatgram-server.brandid.app/integrations/wordpress/uninstall.

5. When the plugin is activated

• What is sent: your site’s domain, site URL and plugin version.
• Why: to mark your entry as active again if it was disabled by an earlier deactivation or uninstall, so the chat widget works again right away. Nothing is created for sites that were never connected.
• When: on plugin activation (retried from the WordPress admin if the Chatgram API could not be reached). The endpoint is https://chatgram-server.brandid.app/integrations/wordpress/activate.

The registration handshake is deferred until you open the Setup screen so the invite link is generated only when needed. No analytics, tracking pixels, fingerprinting, or third-party CDN scripts are loaded.

By installing and activating this plugin, you agree to the Chatgram Terms of Service and Privacy Policy linked above. You should also disclose this third-party data transmission in your own website’s privacy policy.

Source code and build process

This plugin bundles a single compiled JavaScript file at public/js/chatgram-widget.umd.js. The unminified, human-readable source for this file is included inside the plugin in the src/ directory:

• src/chatgram-widget/ — full unminified source of the bundled widget.
• src/chatgram-widget/README.md — build instructions (esbuild build script, dependencies, and the exact command used to produce the UMD bundle that ships in public/js/).

All other plugin code (PHP, CSS, and admin-side JavaScript) is shipped in its original, human-readable form. No minified or compiled assets are loaded from third-party CDNs.

To rebuild the widget locally from the included source:

1. cd src/chatgram-widget
2. npm install
3. npm run build — produces dist/chatgram-widget.umd.js
4. Copy the file into the public/js/ folder of this plugin.