Description

Chatgram | Instant Livechat Support via Telegram / Browser drops a polished floating chat widget on every page of your WordPress site. When a visitor sends a message, the conversation lands instantly in your Telegram chat — no extra inbox, no extra app to learn. Reply right from Telegram, and your visitor receives your reply by email.

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

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.
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

The plugin registers your site’s domain with the Chatgram service the first time you open the setup screen.
You receive a personal Telegram invite link inside the WordPress dashboard.
Press “Start” in the Telegram bot — your account is now linked to your site.
New messages from the contact form arrive as Telegram chats. Reply normally; the visitor receives your reply by email.

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 three 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 submits the contact form

What is sent: the visitor’s name (optional), email address, subject, and message, together with your site’s domain.
Why: so the Chatgram service can deliver the message to your connected Telegram account.
When: only when a visitor explicitly submits the contact form.

3. 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.

The plugin does not call the Chatgram API on activation; the 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 (Rollup configuration, 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:

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

Installation

From inside WordPress

In your WordPress dashboard, go to Plugins Add New.
Search for “Chatgram”.
Click Install Now, then Activate.
Go to Chatgram Setup and follow the two on-screen steps.

Manually

Download the plugin ZIP from the WordPress.org plugin directory.
In your WordPress dashboard, go to Plugins Add New Upload Plugin and upload the ZIP.
Activate the plugin.
Go to Chatgram Setup.

Setup steps

Activating the plugin takes you straight to Chatgram Setup, a guided two-step screen. Until setup is finished, a small reminder (with the remaining steps and one-click actions) also appears on other WordPress admin screens, WooCommerce-style, and the Chatgram menu shows how many steps are left.

Turn on the chat button — one click; the floating chat button appears on every front-end page.
Connect where you receive messages — pick Telegram (open the bot from the button or scan the QR code with your phone, then press Start) or the browser dashboard (we email you a sign-in link). The Setup screen detects the connection automatically, no refresh needed, and then offers a one-click test message.

FAQ

Do I need a Telegram account?

Yes. The whole point of the plugin is to deliver messages straight to your Telegram. Telegram is free to install on iOS, Android, Windows, macOS, Linux, and the web.

Does the widget work on every theme?

The widget mounts itself on document.body inside a Shadow DOM, so theme styles cannot interfere with it (and vice versa). It has been tested with popular WordPress themes including Astra, GeneratePress, Twenty Twenty-Four, Kadence, OceanWP, and Storefront.

Where can I customize the colors and text?

Chatgram Settings Appearance for colors and corner radii, Chatgram Settings Text & labels for every visible string. All customizations are stored locally on your WordPress site — they are not sent to any external service.

Will the widget slow down my site?

The bundled widget is small (roughly 10 KB minified and gzipped) and loaded with defer, so it never blocks your page rendering. It does not load any third-party CDN scripts.

Can I temporarily hide the widget without uninstalling?

Yes. Go to Chatgram Settings General and uncheck “Show widget on site”.

Does it work with WooCommerce?

Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (HPOS) and the block-based Cart & Checkout, and it never touches order data. When WooCommerce is active, a WooCommerce section appears under Chatgram Settings General with two options:

Include store context in messages (on by default) — when a customer messages you from a product, shop, cart, or checkout page, the Telegram message ends with a short line telling you which page they were on (for product pages: product name, price, and link). Only information that is public on the page itself is included — never cart contents or customer data.
Hide widget on checkout (off by default) — removes the floating button from the checkout page only; it still shows on the order confirmation page.

The plugin also works perfectly without WooCommerce — these options simply don’t appear.

Is the plugin GDPR-friendly?

Yes. The plugin only sends data when:

You first open the Setup screen (site URL, site name, admin email, WordPress version, plugin version, locale).
A visitor explicitly submits the contact form (whatever they typed in the form fields).
You deactivate or uninstall the plugin (site domain only).

No tracking cookies, fingerprinting, or analytics are added to your site. See the External services section above for full details.

How do I uninstall completely?

Deactivate the plugin from Plugins, then click Delete. WordPress runs uninstall.php, which removes all plugin settings and notifies the Chatgram backend so your site is cleaned up on the service side as well.

I’m a developer — can I customize the integration?

Yes:

chatgram_widget_config — filter the widget config that ships to the browser (theme, texts, trigger, etc.) on a per-request basis.
chatgram_should_render — return false to suppress the widget on a specific page or post.

The Chatgram API endpoint is fixed (chatgram-server.brandid.app) and not user-configurable — this is by design so visitor messages are always delivered to the official Chatgram Telegram pipeline.

Is this an official Telegram product?

No. This plugin is developed and maintained by brandID and integrates with the Telegram messaging service using the public Telegram Bot API. It is not affiliated with, endorsed by, or sponsored by Telegram.

Reviews

nelaanderson2 September 1, 2026

Super helpful and easy to set up. I like that I can receive messages from my website directly in Telegram and reply without needing another dashboard. That makes everything a lot faster. The widget also looks clean and works smoothly. Definitely a handy plugin for customer support.

saeed0018 September 1, 2026

Setup took five minutes and now every live chat comes straight to Telegram. We answer from our phones instead of watching a dashboard all day. response times dropped massively. Simple, reliable, and free. Thank you!

mohamadsayar August 26, 2026

Simple dashboard with decent AI assist

Read all 3 reviews

Contributors & Developers

“Chatgram | Instant Livechat Support via Telegram / Browser” is open source software. The following people have contributed to this plugin.

Translate “Chatgram | Instant Livechat Support via Telegram / Browser” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.0

Redesigned onboarding. The Setup screen is now a guided stepper that always shows what is done, what is next and what is still locked, with a progress bar and a live “connected” state that appears without reloading the page.
New: WooCommerce-style guided notices on other wp-admin screens while setup is incomplete (“Your chat button is switched off”, “1 step to go — connect Telegram or the browser dashboard”), each with one-click actions, a mini checklist and a progress ring. Dismissing snoozes a notice for 7 days per user. A one-time “Chatgram is live” notice appears once the connection is detected.
New: the Chatgram admin menu shows a badge with the number of remaining setup steps; the Plugins list shows “Finish setup (N left)”.
New: after activating the plugin you are taken straight to the Setup screen (single activation only).
New: Telegram connection shows a scannable QR code (encoded locally, no external service) next to the “Open in Telegram” button, a copy-link field, numbered mini-steps, a live “listening…” status with last-check time, and a troubleshooting section with a fresh-link action that updates the link and QR code in place.
New: browser-dashboard connection has a clear “Check your inbox” state with a shortcut to Gmail / Outlook / Yahoo / iCloud / Proton when recognized, a resend cooldown, “use a different email”, and automatic detection once the sign-in link is opened.
New: “Send yourself a test message” opens your site with the chat window already open (#chatgram-open).
Improved: Settings screen restyled to match (pill tabs, cards, save bar) and the Appearance tab now includes a live preview of the chat button and window that updates as you pick colors and radii.
Improved: saving from the Settings screen keeps you on the same tab and shows a toast instead of a full-width notice.

1.2.0

WooCommerce compatibility release.
Declared compatibility with WooCommerce High-Performance Order Storage (HPOS) and the block-based Cart & Checkout.
Added WC requires at least / WC tested up to headers (tested with WooCommerce 11.0).
New: on WooCommerce stores, visitor messages now include store context — the product (name, price, link), shop, category, cart, or checkout page the customer was on when they wrote to you. Can be disabled under Chatgram Settings General.
New: optional “Hide widget on checkout” setting to keep the checkout page distraction-free (the widget still shows on the order confirmation page).
No behavior changes on sites without WooCommerce.

1.1.0

Added an email deliverability helper. After a visitor sends their first message, the widget can send them a one-time test email and show step-by-step guidance for moving support replies out of Spam or Promotions and into the inbox, with provider-specific tips for Gmail, Outlook, and Yahoo Mail.
Returning visitors continue to see the standard “message sent” confirmation screen.
The deliverability helper is on by default and requires no configuration; it can be disabled from the bundled widget if needed.
Refreshed the “Powered by Chatgram” footer with the Chatgram logo.
Updated the bundled chatgram-widget to version 1.1.0.

1.0.3

Bumped Tested up to: to 7.0 to track the current stable WordPress release.

1.0.2

Addressed feedback from the WordPress.org Plugin Review Team.
Removed external repository/npm URLs from readme.txt that were unreachable from public networks.
Bundled the unminified widget source code directly inside the plugin (src/ directory) so the build process is fully self-contained and reviewable.
Removed WordPress.org directory assets (assets/icon-*.png) from the plugin ZIP; these now belong only in the WordPress.org SVN /assets folder.

1.0.1

Renamed plugin to “Live Chat Reply by Telegram” for clarity about third-party integration.
Updated text domain to match new plugin slug.
Removed redundant load_plugin_textdomain() call (no longer needed on WordPress 4.6+).
Rewrote External services section in readme for full disclosure of all Chatgram API calls.
Added Source code section with public repository link and rebuild instructions for the bundled JS widget.
Added brandid2026 to contributors.
Bumped Tested up to: 6.9.

1.0.0

Initial release.
Two-step setup wizard (enable widget connect Telegram).
Theme and text customization.
REST API status polling so the dashboard updates automatically once Telegram is connected.

Super helpful for customer support

The simplest live chat solution I’ve used

Great for feedback

Description

Why use this plugin

How it works

Documentation and support

External services

Chatgram API

Source code and build process

Installation

From inside WordPress

Manually

Setup steps

FAQ

Do I need a Telegram account?

Does the widget work on every theme?

Where can I customize the colors and text?

Will the widget slow down my site?

Can I temporarily hide the widget without uninstalling?

Does it work with WooCommerce?

Is the plugin GDPR-friendly?

How do I uninstall completely?

I’m a developer — can I customize the integration?

Is this an official Telegram product?