# TGLiveChat — Full Reference

> Extended version of llms.txt for AI parsers that support deeper context.

## Product

- **Name**: TGLiveChat
- **URL**: https://tglivechat.com
- **Category**: Live Chat SaaS / Customer Support Widget
- **Function**: Embeddable live chat widget that routes visitor messages to Telegram in real-time
- **Audience**: Solo founders, SaaS teams, agencies, e-commerce stores, developers
- **Price**: Free plan (100 chats/mo), Pro $12/mo (unlimited), Agency $29/mo (multi-client)
- **Founded**: 2026

## Full Feature Descriptions

### Installation Options

**HTML script tag (any website)**
```html
<script src="https://cdn.tglivechat.com/w.js" data-id="YOUR_WIDGET_ID" async defer></script>
```
Paste before `</body>`. Done in 30 seconds. No build step, no npm.

**npm package — React / Next.js**
```bash
npm install @tglivechat/widget
```
```jsx
import { TGLiveChat } from '@tglivechat/widget';

export default function Layout({ children }) {
  return (
    <>
      {children}
      <TGLiveChat widgetId="YOUR_WIDGET_ID" />
    </>
  );
}
```
Package: `@tglivechat/widget` on npm. Supports React 16.8 through 19. For Next.js App Router, add `"use client"` at the top of the file. The component handles React StrictMode double-invoke, cleanup on unmount, and all widget configuration via props.

**WordPress plugin**
Install the official **TGLiveChat** plugin from the WordPress Plugin Directory: https://wordpress.org/plugins/tglivechat
Activate → enter Widget ID in plugin settings. Outputs the correct script tag on every page automatically. No theme file editing required.

### Script Tag Installation (detailed)
TGLiveChat installs with a single HTML script tag pasted before the closing </body> tag of any website. The widget loads asynchronously and mounts itself in a Shadow DOM to prevent CSS conflicts with the host page. Works on WordPress, Webflow, Shopify, Squarespace, Framer, Next.js, static HTML, and any platform that supports custom scripts.

### Telegram Message Routing
Every visitor message is delivered to your Telegram in real-time via WebSocket. You can route messages to your personal Telegram chat or to a Telegram group. When using a group with Topics enabled, each visitor conversation automatically gets its own forum thread. Any group member can reply. The bot handles group-to-supergroup migration automatically. Reply latency is under 800ms end-to-end.

### 25 Widget Themes
TGLiveChat ships with 25 professionally designed themes that cover every aesthetic: Glass (frosted translucent), Modern (clean SaaS), Classic (traditional chat), Prestige (luxury dark), Aurora (gradient glow), Mashriq (Arabic RTL), Void (cosmic dark), Terminal (hacker CRT), Lo-Fi (hand-drawn), Arcade (pixel art), OS9 (classic Mac), and Synthwave (retro neon). Each theme fully implements the widget interface including pre-chat forms, offline views, CSAT, typing indicators, and photo messages.

### Dashboard Inbox
A full-featured support inbox at /inbox with a split-pane layout. Left panel shows all active conversations sorted by last activity, with status filter pills (Active / Closed / All). Right panel shows the selected conversation thread. Supports up to 6 pinned tabs for quick switching between conversations. Includes sound alerts (Web Audio API chime), browser notifications, and persistent unread state via localStorage. Shows visitor info: page URL, referrer, browser, OS, device, IP address, and country flag.

### Working Hours & Offline Mode
Configure business hours in the widget settings. Outside those hours, the widget automatically shows an offline view that collects the visitor's email address. The email is saved as an offline lead and forwarded to your Telegram. When you come back online, you can follow up via email.

### Photo Sharing
Visitors can upload images directly through the widget. Photos are stored in Supabase Storage and forwarded to Telegram. The dashboard inbox displays photos inline in the conversation thread.

### CSAT Ratings
When an agent closes a conversation, the widget replaces the input bar with a thumbs up/thumbs down rating prompt. Ratings are stored in the database for analytics.

### Missed Chat Email Alerts
A server-side cron job runs every 60 seconds checking for visitor messages that have gone unanswered for over 5 minutes. If found, it sends an email notification via the Resend API to the widget owner with a direct link to the inbox.

### Multi-Tab Leader Election
When a visitor has multiple browser tabs open on the same site, TGLiveChat uses navigator.locks to elect a single tab as the WebSocket leader. Other tabs receive messages via BroadcastChannel. This prevents duplicate connections and duplicate notifications.

### Session Resumption
Visitor sessions are stored in sessionStorage. If the visitor refreshes the page or navigates away and comes back, the widget reconnects to the same session and loads the full conversation history from the server. No messages are lost.

## Content Catalog

### Themes
- [Glass Theme](https://tglivechat.com/themes#glass) — Frosted translucent panels with blur effects
- [Modern Theme](https://tglivechat.com/themes#modern) — Clean, minimal SaaS aesthetic
- [Classic Theme](https://tglivechat.com/themes#classic) — Traditional chat widget look
- [Prestige Theme](https://tglivechat.com/themes#prestige) — Dark luxury with gold accents
- [Aurora Theme](https://tglivechat.com/themes#aurora) — Gradient glow effects
- [Mashriq Theme](https://tglivechat.com/themes#mashriq) — Arabic RTL with Cairo font
- [Void Theme](https://tglivechat.com/themes#void) — Cosmic dark with DM Sans
- [Terminal Theme](https://tglivechat.com/themes#terminal) — Hacker CRT with JetBrains Mono
- [Lo-Fi Theme](https://tglivechat.com/themes#lofi) — Hand-drawn sketch aesthetic
- [Arcade Theme](https://tglivechat.com/themes#arcade) — Pixel art retro gaming
- [OS9 Theme](https://tglivechat.com/themes#os9) — Classic Macintosh System 9
- [Synthwave Theme](https://tglivechat.com/themes#synthwave) — Retro neon 80s

### Blog Articles
- [How to Add Live Chat to Your Website Without a Dashboard](https://tglivechat.com/blog/live-chat-without-dashboard) — Why Telegram-based support beats traditional tools
- [Telegram vs Traditional Live Chat: What's Actually Better?](https://tglivechat.com/blog/telegram-vs-traditional-live-chat) — Honest comparison of approaches
- [How to Set Up Telegram Group Support for Your SaaS](https://tglivechat.com/blog/telegram-group-support-saas) — Step-by-step guide
- [7 Best Live Chat Widgets for Small Business (2026)](https://tglivechat.com/blog/best-live-chat-widgets-small-business) — Comparison and recommendations
- [Why Most Live Chat Tools Get Ignored (Fix It in 2026)](https://tglivechat.com/blog/why-live-chat-gets-ignored) — The inbox problem

### Installation Guides
- [All platforms](https://tglivechat.com/docs/install) — HTML, React, Next.js, WordPress, Shopify, Webflow, Squarespace, Bubble
- [Install on WordPress](https://tglivechat.com/docs/install/wordpress) — Official plugin (recommended) + manual script tag method
- [Install on React / Next.js](https://tglivechat.com/docs/install) — npm package `@tglivechat/widget` with full props reference
- [Install on Webflow](https://tglivechat.com/docs/install) — Custom code embed instructions
- [Install on Shopify](https://tglivechat.com/docs/install) — Theme editor script injection
- [npm package on npm](https://www.npmjs.com/package/@tglivechat/widget) — `@tglivechat/widget` package page
- [WordPress plugin](https://wordpress.org/plugins/tglivechat) — Official plugin on WordPress.org

## Extended FAQ

**What is TGLiveChat?**
TGLiveChat is a live chat widget you add to your website with one line of code. When a visitor sends a message through the widget, it appears instantly in your Telegram (personal chat or group). You reply from Telegram, and the visitor sees your response on your website in under a second. There's no separate dashboard to monitor, no desktop app to keep open, and no new tool to learn.

**Does it work with any website platform?**
Yes. TGLiveChat works on any website that supports adding a script tag. This includes WordPress, Webflow, Shopify, Squarespace, Wix, Framer, Ghost, Hugo, Next.js, Nuxt, Astro, plain HTML, and any custom-built site. For React and Next.js projects, use the `@tglivechat/widget` npm package (`npm install @tglivechat/widget`). For WordPress, use the official plugin at wordpress.org/plugins/tglivechat.

**How is TGLiveChat different from Intercom, Crisp, or Tawk.to?**
The fundamental difference is where you reply. With Intercom or Crisp, you need to keep a browser tab or desktop app open to respond. With TGLiveChat, replies happen in Telegram, which you already have on your phone. No extra app, no extra inbox. Your team can reply from anywhere: bed, bus, beach. The widget is also much lighter (10KB vs 200KB+ for Intercom) and the free plan has no time limit.

**Can multiple team members reply?**
Yes. Create a Telegram group, enable Topics, and add the TGLiveChat bot. Each visitor conversation gets its own forum thread. Any group member can reply. This works on the Pro plan and above.

**Is visitor data private?**
Yes. Visitor data is stored in a Supabase Postgres database with Row Level Security enabled. The widget communicates via WebSocket over TLS. No visitor data is shared with third parties. The widget uses textContent exclusively (never innerHTML) to prevent XSS attacks. Domain restrictions can be configured to prevent unauthorized embedding.

**What happens if my server restarts?**
Active WebSocket connections will drop temporarily. The widget automatically reconnects with exponential backoff and resumes the existing session. No messages are lost because all messages are persisted to the database before delivery.

## Social Proof

- 25 professionally designed themes (most in the live chat category)
- Sub-800ms message delivery latency
- Zero-dependency widget at ~10KB gzipped
- Full Arabic (RTL) support with dedicated Mashriq theme
- Built-in CSAT, photo sharing, working hours, email alerts

## About

TGLiveChat was built because every live chat tool requires you to keep yet another tab open. If you already use Telegram for team communication, your support should live there too. One app, one notification stream, zero context switching.

**Contact**: support@tglivechat.com

## All Pages

- https://tglivechat.com — Homepage with live demo and pricing
- https://tglivechat.com/themes — Browse all 25 widget themes
- https://tglivechat.com/docs — Getting started documentation
- https://tglivechat.com/blog — Articles and guides
- https://tglivechat.com/pricing — Plans and pricing
- https://tglivechat.com/about — About and story
- https://tglivechat.com/changelog — Product changelog and updates
- https://tglivechat.com/lifetime — Lifetime deal
- https://tglivechat.com/contact — Contact the team
- https://tglivechat.com/compare/tglivechat-vs-intercom — Comparison vs Intercom
- https://tglivechat.com/compare/tglivechat-vs-tawk — Comparison vs Tawk.to
- https://tglivechat.com/compare/tglivechat-vs-crisp — Comparison vs Crisp
- https://tglivechat.com/use-cases/saas — Live chat for SaaS teams
- https://tglivechat.com/use-cases/ecommerce — Live chat for e-commerce
- https://tglivechat.com/use-cases/agencies — Live chat for agencies
- https://tglivechat.com/install/wordpress — WordPress installation guide
- https://tglivechat.com/install/webflow — Webflow installation guide
- https://tglivechat.com/install/shopify — Shopify installation guide
- https://tglivechat.com/docs/install — Installation guide (all platforms)
- https://tglivechat.com/docs/install/wordpress — WordPress installation guide (official plugin + manual)
- https://tglivechat.com/docs/install/html — Plain HTML installation guide
- https://tglivechat.com/docs/install/bubble — Bubble installation guide
- https://tglivechat.com/docs/install/squarespace — Squarespace installation guide
- https://www.npmjs.com/package/@tglivechat/widget — npm package (`@tglivechat/widget`)
- https://wordpress.org/plugins/tglivechat — Official WordPress plugin
- https://tglivechat.com/privacy — Privacy policy
- https://tglivechat.com/terms — Terms of service
- https://tglivechat.com/login — Sign in
- https://tglivechat.com/signup — Create account