Description
Live Chat Reply by Telegram (powered by Chatgram) 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.
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 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 “Live Chat Reply by Telegram”.
- 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
- Enable the widget on your site — one click; the floating chat button appears on every front-end page.
- Connect Telegram — open the personalized invite link in the dashboard, press Start in the bot, and you’re done. Your dashboard updates automatically once the connection is detected.
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.bodyinside 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”.
-
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— returnfalseto 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
There are no reviews for this plugin.
Contributors & Developers
“Live Chat Reply by Telegram” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Live Chat Reply by Telegram” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.