=== Cnvrse ===
Contributors: rnzo, cnvrse
Tags: live chat, telegram, chat widget, support, messaging
Requires at least: 6.1
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 025.12.24.01
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add live chat to WordPress in seconds. Reply from your dashboard or Telegram. No external accounts, no monthly fees, 100% privacy-focused.

== Description ==

**The fastest way to add live chat to WordPress** — Cnvrse Lite lets you chat with visitors directly from your WordPress admin or via Telegram on your phone. No signup required, no external services, no monthly fees.

### Why Cnvrse?

Most live chat plugins require external accounts, charge monthly fees, or slow down your site with heavy scripts. Cnvrse is different:

* **100% Native WordPress** — Uses WordPress REST API and custom post types. Your data stays in your database.
* **Reply from Anywhere** — Answer chats from wp-admin or connect Telegram for mobile notifications and replies.
* **Privacy-First** — No visitor tracking, no external servers, no cookies beyond session identification. GDPR-friendly by design.
* **Lightweight** — Under 50KB total. No jQuery dependency. Loads asynchronously.
* **Setup in Seconds** — Install, activate, done. Chat widget appears automatically.

### Key Features

**Live Chat Widget**
A clean, modern chat bubble that matches any theme. Customize colors and greeting text from Settings.

**Real-Time Dashboard**
See active visitors, ongoing conversations, and message history. Reply instantly without leaving WordPress.

**Telegram Integration** (Optional)
Connect your Telegram bot to receive instant notifications and reply to visitors from your phone. Perfect for on-the-go support.

**Visitor Intelligence**
See visitor location, browser, current page, and browsing journey. Know context before you reply.

**Conversation Management**
Organize chats with Open/Pending/Closed status. Auto-close inactive conversations. Never lose a lead.

### Perfect For

* Small business websites needing simple customer support
* WooCommerce stores wanting pre-sale chat
* Freelancers and agencies managing client sites
* Anyone who wants live chat without the bloat

### How It Works

1. Install and activate Cnvrse Lite
2. Chat widget appears on your site immediately
3. Visitors send messages → You get notified
4. Reply from WordPress dashboard or Telegram
5. That's it. No configuration required.

### Telegram Setup (Optional)

Want to reply from your phone? Connect Telegram in 2 minutes:

1. Create a bot via @BotFather on Telegram
2. Paste your bot token in Cnvrse Settings
3. Send a test message to verify connection
4. Receive notifications and reply from anywhere

[Detailed Telegram setup guide →](https://cnvrse.com/docs/telegram-setup/)

### Built for Performance

Cnvrse loads only what's needed:
* No external API calls on page load
* Vanilla JavaScript (no jQuery)
* CSS loaded only on pages with widget
* REST API endpoints cached where possible

Your PageSpeed score stays intact.

### Privacy & Compliance

* No third-party tracking scripts
* No data sent to external servers
* Conversations stored in your WordPress database
* Visitor IP used only for geolocation (optional)
* Compatible with GDPR, CCPA, and cookie consent plugins

### Coming in Pro

* Permanent conversation history (Lite: 24-hour storage)
* Multiple chat agents
* Canned responses
* Business hours & offline mode
* File sharing
* Chat transcripts via email
* Priority support

[Learn about Cnvrse Pro →](https://cnvrse.com/pro/)

== Installation ==

### Automatic Installation (Recommended)

1. Go to **Plugins → Add New** in your WordPress admin
2. Search for "Cnvrse"
3. Click **Install Now**, then **Activate**
4. Done! The chat widget is now live on your site

### Manual Installation

1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Activate the plugin

### After Installation

* Visit **Cnvrse → Settings** to customize colors and greeting text
* (Optional) Connect Telegram for mobile notifications
* Start chatting with your visitors!

== Frequently Asked Questions ==

= Does the live chat work without Telegram? =

Yes! Telegram is completely optional. You can reply to all chats directly from your WordPress dashboard. Telegram just adds mobile notifications and the ability to reply from your phone.

= Will this chat plugin slow down my website? =

No. Cnvrse is built for performance — under 50KB total, vanilla JavaScript, no jQuery dependency. Scripts load asynchronously and won't affect your PageSpeed score. We've tested on sites with 100k+ monthly visitors.

= Is visitor data sent to external servers? =

Never. All conversations are stored in your WordPress database. The only external call is to Telegram (if you enable it) to deliver your replies. No analytics, no tracking, no third-party scripts.

= Can I customize the chat widget colors? =

Yes. Go to **Cnvrse → Settings** to change the primary color, widget title, subtitle, and welcome message. The widget automatically adapts to look great on any theme.

= Does it work with WooCommerce? =

Absolutely. Cnvrse works with any WordPress theme or plugin, including WooCommerce, Elementor, Divi, and all major page builders. It's built on native WordPress APIs.

= How long are conversations stored? =

In the free Lite version, conversations are stored for 24 hours — perfect for real-time support. Cnvrse Pro offers permanent conversation storage with full history and search.

= Is it GDPR compliant? =

Yes. Cnvrse doesn't use tracking cookies, doesn't send data to third parties, and stores everything in your database. You control the data. Add a chat consent notice if required in your jurisdiction.

= Can multiple team members use it? =

The Lite version supports single-agent use. Cnvrse Pro (coming soon) adds multi-agent support with conversation assignment and team collaboration.

= What's the difference between Lite and Pro? =

**Lite (Free):** 24-hour conversation storage, single agent, core chat features, Telegram integration.

**Pro:** Permanent storage, multiple agents, canned responses, business hours, file sharing, email transcripts, priority support.

= How do I get support? =

For free support, use the [WordPress.org support forum](https://wordpress.org/support/plugin/cnvrse/). For faster response, Pro users get priority email support.

== Screenshots ==

1. **Chat Widget** — Clean, modern design that works with any theme
2. **Admin Dashboard** — See all conversations and visitor details at a glance
3. **Live Conversation** — Real-time messaging with visitor context
4. **Telegram Integration** — Reply to visitors from your phone
5. **Settings Page** — Customize colors, text, and Telegram connection
6. **Visitor Profile** — Browser, location, page journey, and more

== Changelog ==

= 025.12.16.01 =
* Enhanced Telegram message formatting

= 025.11.28.01 =
* Improved real-time dashboard updates
* Fixed timezone display for visitor activity
* Enhanced Telegram message formatting
* Performance optimizations for REST API endpoints
* Better handling of conversation status changes

= 025.11.28.00 =
* Added visitor activity tracking
* Improved conversation auto-close logic
* Fixed page view counter
* Enhanced mobile widget responsiveness

= 025.11.27.01 =
* New dashboard design with better UX
* Added conversation search
* Telegram webhook improvements
* Fixed Safari compatibility issue

= 025.11.26.01 =
* Initial public release
* Core live chat functionality
* Telegram integration
* Real-time dashboard
* Visitor geolocation

== Additional Info ==

**Documentation:** [cnvrse.com/docs](https://cnvrse.com/docs/)
**Support:** [WordPress.org Forum](https://wordpress.org/support/plugin/cnvrse/)
**Pro Version:** [cnvrse.com/pro](https://cnvrse.com/pro/)
**GitHub:** [github.com/renzojohnson/cnvrse](https://github.com/renzojohnson/cnvrse)

**Languages:** English (more coming soon — [help translate](https://translate.wordpress.org/projects/wp-plugins/cnvrse/))

Built with ❤️ for the WordPress community.
