Description
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
- 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 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.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://robot.chatgram.app
- Provider: brandID — https://brandid.app
- Terms of Service: https://chatgram.app/terms
- Privacy Policy: https://chatgram.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://robot.chatgram.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://robot.chatgram.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 inpublic/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-widgetnpm installnpm run build— producesdist/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?
No, but it’s the fastest way to answer on the go. You can reply from Telegram, from Slack, or from the Chatgram browser dashboard (we email you a sign-in link during setup) — or any mix of them; your whole team can join too. 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 (about 90 KB gzipped, including the live chat messenger) is loaded in the footer, 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 uses the chat: in live chat mode, the messages they send and the page / browser details listed under External services; in email mode, 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 (live chat remembers the visitor with a random ID in local storage so their conversation continues across pages). See the External services section above for full details, and the suggested text added to Settings → Privacy for your privacy policy.
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— returnfalseto suppress the widget on a specific page or post.chatgram_widget_user— filter (or empty) the logged-in user’s name and email that are prefilled in the live chat.
The Chatgram API endpoint is fixed (robot.chatgram.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.
Changelog
1.8.2
- Changed: Chatgram moved to its own domain. The plugin now talks to the Chatgram API at https://robot.chatgram.app (was chatgram-server.brandid.app), and its links point to https://chatgram.app. The old addresses keep working, so nothing breaks for sites that update later.
- Bundled chatgram-widget updated to 2.6.2 (same widget, new domains).
1.8.1
- Fixed: the Arc style packs your messenger buttons neatly around the chat button. The first ring now holds three buttons (above, diagonal and beside it) instead of leaving a gap.
- Fixed: in the Arc style the “Book a demo” label now shows when visitors hover the button, instead of always. It used to cover the next button and run off the edge of the screen.
- Bundled chatgram-widget updated to 2.6.1.
1.8.0
- New: keep your messenger buttons showing all the time. In your Chatgram dashboard under Messenger buttons, turn on “Always show the buttons” and they stay next to the chat button instead of only appearing when visitors hover it (or tap it on phones). They step aside while the chat window is open.
- Improved: the Arc style now sits right around the chat button. With many buttons they fill a second ring instead of spreading far away from it.
- Improved: when a visitor switches the chat to another language, the welcome title, welcome message, away message, AI assistant name and quick replies switch too (before, only the buttons and labels did). The default quick replies are now translated into every supported language.
- Improved: when your AI assistant can answer, the chat button and chat window show you as online with a green dot, even when no teammate is online.
- Bundled chatgram-widget updated to 2.6.0.
1.7.0
- Fixed: the “Update now” button now shows up within minutes of a new release, on the Plugins screen, Dashboard → Updates and the Chatgram screens. Before, WordPress could take up to 12 hours (or longer when WP-Cron was slow) to notice the new version.
- Fixed: with automatic updates on, Chatgram now installs new versions by itself, usually within an hour of release, using WordPress’s own automatic updater (same safety checks and rollback). Before, it could take a day or more, or not happen at all.
- New: when automatic updates are on but this site stops them (turned off by the host, a .git/.svn folder, FTP-only file access, WP-Cron not running, or Chatgram installed in the wrong folder), the Chatgram screens and Site Health say why and what to do. The last automatic update attempt is shown too.
- New: a setup spotlight on top of the Dashboard: the setup steps as cards, the one action that comes next, and a live preview of your chat button in your colors showing what visitors get right now.
- New: a “Chatgram · 2 steps left” reminder in the admin bar (also on your site’s pages), with the steps in its menu.
- New: an “Only you can see this” tip on your own site, next to the chat button, while setup isn’t finished. Visitors never see it. Hide it for a day with ×.
- New: Dashboard widget: your setup checklist while the spotlight is snoozed, and “Chatgram at a glance” once you’re live (status, inbox, language, AI assistant, version, updates).
- New: Site Health checks for Chatgram setup and Chatgram updates, and a “Setup isn’t finished” row under Chatgram on the Plugins screen.
- Improved: setup reminders come back after 3 days instead of 7. Finishing setup ends with a short confetti burst.
1.6.0
- New: choose how your messenger buttons appear. Side bar (a row beside the chat button), Stack (a column above it), Arc (fanned out around it) or Inside chat only. Pick one in your Chatgram dashboard under Messenger buttons. On phones they open in the same shape from the small button on the chat button.
- New: Book a demo. Connect your Bookme account in your Chatgram dashboard (Messenger buttons → Book a demo) and pick one of your booking pages. Visitors get a calendar button by the chat button and a “Book a demo” card in the chat window.
- Bundled chatgram-widget updated to 2.5.0.
1.5.7
- Improved: on computers and tablets the chat button now sits close to the bottom of the screen (20px), even if a larger distance was set. On phones your setting still applies, so the button stays clear of bottom menus.
- Bundled chatgram-widget updated to 2.4.2.
1.5.6
- New: the “Need help? We are online” card above the chat button now pops out with a small shake when a page loads, then hides again. Hovering the chat button still shows it. On the contact form, the “Need help?” label does the same.
- Bundled chatgram-widget updated to 2.4.1.
1.5.5
- New: your messenger and social links (WhatsApp, Instagram, Telegram and more) now also show as buttons on the chat home screen, under “Send us an email instead”.
- Bundled chatgram-widget updated to 2.4.0.
1.5.4
- Improved: messenger buttons no longer take up room on your pages. With a mouse they slide out when a visitor hovers the chat button.
- New: on phones and tablets the messenger buttons fold into a small button on the chat button. One tap opens them all; if you only have one link, that tap goes straight to it. First-time visitors see a short preview so they know where the buttons are.
- Bundled chatgram-widget updated to 2.3.0.
1.5.3
- New: messenger buttons. Let visitors reach you on WhatsApp, Instagram, Telegram, Messenger and more: round buttons sit right next to your chat button, in live chat and contact-form mode. Add them in your Chatgram dashboard; Chatgram → Settings links straight there.
- Improved: when the chat button’s “Contact us” card or a greeting pops up, the messenger buttons slide neatly beside it instead of being covered, and slide back when it closes.
- Bundled chatgram-widget updated to 2.2.1.
1.5.2
- Improved: the chat button now sits lower on the page by default (20px from the bottom instead of 88px). Sites still on the old default move automatically; a position you set yourself is kept.
- Improved: a more compact contact form — topic choices fit on one scrollable row and the email and name fields sit side by side (stacked on small phones).
- Improved: “Powered by Chatgram” is hidden on white-label plans.
- Fix: re-activating the plugin now reliably turns older sites back on in Chatgram.
1.5.1
- Fix: reinstalling or re-activating the plugin now turns your site back on in Chatgram automatically, so the chat widget works again right away.
1.5.0
- New: your chat and contact form speak your visitors’ language — 117 languages, including Persian, Arabic, Hebrew and Urdu. The Setup screen now asks for the language first (your WordPress language is preselected); every visitor text, the live chat and the emails visitors get use it.
- New: right-to-left languages mirror the whole widget, and mixed right-to-left / left-to-right text (names, emails, order numbers inside a sentence) stays in the right order.
- New: visitors can switch the language from the chat (you can turn this off in your Chatgram dashboard). Their choice is remembered on their device.
- New: change the language and edit any text — live chat included — in your Chatgram dashboard. Texts on the Settings → Text tab are now optional: leave a field empty to use the default wording in your language.
- New: one-click updates. When a new version is out, Chatgram shows “Update to x.y.z” under the plugin on the Plugins screen and an “Update now” button on its own screens — it updates in place with WordPress’s built-in updater (no deleting and reinstalling; your settings stay). “Check for updates” asks WordPress.org right away, and you can turn on automatic updates for Chatgram with one click.
- Bundled chatgram-widget updated to 2.1.0.
1.4.1
- Improved: connecting with the browser dashboard is now a clear, guided wait. After we email your sign-in link, the Setup screen shows “Waiting for you to open the link” with the address and time it was sent, what to do in the email, a shortcut to your mailbox, “Resend email” (with a short cooldown) and “Use a different email” — and it stays on this screen after a reload.
- Improved: if the email can’t be sent, the Setup screen offers your sign-in link directly.
- Improved: the moment you’re connected, the Setup screen takes you to the next step — matching the chat to your theme — and shows what your AI assistant is doing (new sites get AI answers on by default; it learns your website automatically).
- Fixed: asking for a sign-in link for a site that is already connected now shows the connected state instead of “check your inbox”.
- Only the newest sign-in link works; sending a new one (or using a different email) retires the old link.
1.4.0
- New: real-time live chat. Visitors chat with you live; you reply from Telegram (reply to the chat card, or tap “Chat now” to talk directly), Slack or the browser dashboard and they see it instantly — with typing indicators, delivered/seen double ticks, file sharing, chat history across pages and a rating when the chat ends.
- New: AI auto-response for live chat with flexible routing — always, only when no one is online, outside business hours, on a schedule, or after a wait — and “Talk to a person” / “Get an instant AI answer” options for visitors.
- New: if a visitor leaves before you reply, the reply is emailed to them; replying to that email continues the same chat.
- New: logged-in WordPress users don’t have to type their name and email in the chat (filter:
chatgram_widget_user). - Kept: the classic contact form (“Email mode”). Sites connected before this version stay in Email mode until you switch them to live chat; new sites start in live chat.
- Updated: the bundled chat widget (v2.0.0) and its source in
src/chatgram-widget, now built with esbuild. - Updated: the suggested privacy-policy text and the External services section describe the live chat data flows.
1.3.2
- Fixed: on sites whose WordPress Address / Site Address is still
http://but which are served over HTTPS (for example behind Cloudflare), the Setup screen could never detect the connection live — the browser blocked every status check as mixed content. Status checks now always use the page’s HTTPS address. - Improved: if status checks keep failing, the Setup screen now says so (instead of showing “Listening…” with a “Last checked” time that kept counting even though nothing was being checked).
1.3.1
- Fixed: after connecting Telegram (or the browser dashboard), the Setup screen could keep showing “not connected” until you reopened a connection panel. The Setup screen now confirms the live status with Chatgram every time it loads, so the stepper, progress bar, menu badge and notices are correct straight away.
- Fixed: a pressed “Start” in the Telegram bot is now recognised even when the server reports it only through the invite’s “used” flag.
- Improved: the Setup screen re-checks the connection the moment you switch back from the Telegram app or another tab.
- Improved: status checks also use the domain the site was registered under, use a shorter timeout, and can no longer be served stale by page-cache / REST-cache plugins or CDNs.
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 toheaders (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.txtthat 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/assetsfolder.
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
brandid2026to 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.