=== Scinorx Lead Chat ===
Contributors: scinorxtechnologies
Tags: lead generation, contact form, enquiry form, small business, click to chat
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn WordPress enquiry forms into chat conversations while keeping every lead saved in your dashboard.

== Description ==

Scinorx Lead Chat helps small business websites turn form submissions into chat conversations.

When a visitor submits the enquiry form, the plugin first saves the lead inside WordPress. Then it can open a supported chat app with the visitor's enquiry message prepared, so the conversation can continue immediately.

This is useful for service businesses, consultants, clinics, salons, local shops, agencies, tutors, real estate agents, and other small businesses that prefer to follow up through chat.

= Core Features =

* Enquiry form shortcode for any page or post
* Chat handoff after form submission
* Saved lead inbox inside WordPress admin
* Floating chat and call buttons
* Lead notification emails
* Dashboard counters for leads, chat clicks, and call clicks
* Chat and call click tracking
* CSV export for leads
* Chat reply button from the lead inbox
* Custom chat handoff message template
* Custom chat reply message template
* Honeypot spam protection
* Simple submission rate limiting
* Optional data cleanup on uninstall

= Shortcode =

Add this shortcode to a page or post:

`[scxlc_lead_chat_form]`

= Trademark Notice =

Scinorx Lead Chat is not affiliated with, sponsored by, or endorsed by WhatsApp, Meta, or their affiliates. WhatsApp is a trademark of its respective owner.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the plugin zip from WordPress admin.
2. Activate `Scinorx Lead Chat`.
3. Go to `Lead Chat > Settings`.
4. Add your chat number, call number, and lead notification email.
5. Add `[scxlc_lead_chat_form]` to a page.
6. Submit a test enquiry and confirm the lead appears under `Lead Chat > Leads`.

== Frequently Asked Questions ==

= Does this send chat messages automatically? =

No. The plugin opens the chat app with the visitor's enquiry prepared. The visitor still reviews and sends the message.

= Does this use the WhatsApp Business API? =

No. This plugin uses standard WhatsApp links to open a prepared conversation. It does not connect to the WhatsApp Business API.

= Are leads saved in WordPress? =

Yes. Leads are saved before the chat handoff, so the business still has a record in `Lead Chat > Leads`.

= Can I export leads? =

Yes. Go to `Lead Chat > Leads` and click `Export CSV`.

= Can I customize the chat message? =

Yes. Go to `Lead Chat > Settings` and edit the chat handoff message.

Supported tokens:

* `{name}`
* `{phone}`
* `{email}`
* `{service}`
* `{message}`
* `{source_url}`

= Can I reply to leads from the inbox? =

Yes. The lead inbox includes a chat reply button. The button uses the phone number submitted by the visitor, so the best experience requires visitors to enter a number with country code.

= What number format should I use? =

Use country code plus number without spaces or symbols. For example: `919999999999`.

= Does the plugin track visitors? =

The plugin stores form submissions in your WordPress database and records simple local click events for the floating chat and call buttons. It does not send analytics data to Scinorx.

= Does this plugin connect to external services? =

The plugin creates standard external chat links when a visitor chooses to continue the conversation. The plugin does not send lead data to Scinorx. Email notifications use your WordPress site's normal email delivery.

= Does uninstalling delete leads? =

Only if you enable `Delete plugin settings and stored leads when the plugin is uninstalled` in settings before uninstalling. By default, stored leads remain in the database to prevent accidental data loss.

== Privacy ==

This plugin stores submitted lead details in the WordPress database. Stored fields may include name, phone, email, service, message, source URL, status, and submission date.

The plugin also records simple local click events for floating chat and call buttons. These events are stored in the WordPress database and are used only for dashboard counts.

Site owners should make sure their privacy policy explains how enquiry data is collected, stored, and used.

== Screenshots ==

1. Dashboard with lead totals, chat click counts, and call click counts.
2. Settings page for chat number, call number, email notifications, message templates, and uninstall behavior.
3. Lead inbox with status updates, CSV export, source page links, and chat reply action.
4. Frontend enquiry form using the `[scxlc_lead_chat_form]` shortcode.
5. Floating chat and call buttons on the frontend.
6. Browser handoff prompt for opening the external chat link.
7. Chat screen with the visitor's enquiry message prepared.

== Upgrade Notice ==

= 1.0.0 =
Initial free release.

== Changelog ==

= 1.0.0 =
* Initial free release.
* Added chat form handoff.
* Added saved lead inbox.
* Added floating chat and call buttons.
* Added lead notification emails.
* Added CSV export.
* Added chat and call click tracking.
* Added customizable chat handoff and reply templates.
* Added privacy and trademark documentation.
