=== RapidSales for WooCommerce ===
Contributors: rapidsales
Tags: whatsapp, woocommerce, abandoned cart, cod, order notifications
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WhatsApp order notifications, COD confirmation and abandoned-cart recovery for WooCommerce, powered by RapidSales.

== Description ==

RapidSales for WooCommerce sends your customers timely WhatsApp updates and recovers lost revenue — built for D2C and COD-heavy stores in India.

**Order notifications**
Automatic WhatsApp updates when an order is placed, shipped, out for delivery, delivered or cancelled. You control which WooCommerce status triggers which message.

**COD confirmation (reduce RTO)**
Cash-on-delivery orders get a WhatsApp confirmation with Confirm/Cancel buttons. Optionally auto-cancel (and restock) orders the customer declines. Set a minimum order value below which COD orders get a normal confirmation instead.

**Abandoned-cart recovery**
When a shopper leaves checkout after entering their phone number, they receive a WhatsApp reminder with a one-tap link that restores their cart. Built-in guardrails: one reminder per cart, at most one reminder per customer per 72 hours, and configurable quiet hours.

**Simple setup**
Install, enter your RapidSales account credentials, done. All settings — flows, COD rules, quiet hours, status mapping — live right in your WooCommerce admin, along with a 7-day health summary and a send-test-message button.

**Account required:** this plugin is a connector for the RapidSales platform (https://rapidsales.ai). You need a RapidSales account with an approved WhatsApp Business channel and message templates. Message delivery is handled by RapidSales via the WhatsApp Business API and may incur charges per your RapidSales plan.

== External services ==

This plugin connects to the RapidSales gateway service (https://woo.rapidsales.ai), operated by RapidSales (https://rapidsales.ai). It is required for every feature of the plugin — the plugin is a connector and does not send WhatsApp messages itself.

What is sent, and when:

* **On connect:** your store URL and the RapidSales account email/password you enter (the password is used once for validation and is never stored on your WordPress site).
* **On order events:** order id/number/status, amount, currency, payment method, customer name/email/phone, the first line items, and shipment-tracking details if a tracking plugin has stored them.
* **On checkout (if cart recovery is enabled):** the contact details the shopper types (name, email, phone) and the cart contents, so an abandoned-cart reminder can be sent.
* **From the settings page:** your messaging preferences, and the phone number you enter when sending a test message.

This data is used solely to deliver the plugin's functionality (sending WhatsApp messages on your behalf via your own RapidSales account). See the RapidSales terms and privacy policy: https://www.rapidsales.ai/terms-and-conditions and https://www.rapidsales.ai/privacy-policy

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. Go to **WooCommerce → RapidSales**.
3. Enter the API-user email and password from your RapidSales dashboard (Account → API User) and click **Connect**.
4. Make sure your RapidSales account has Active Template Configs for at least "Placed" and "COD".
5. Optionally adjust flows, COD rules, quiet hours and status mapping — then send yourself a test message.

== Frequently Asked Questions ==

= Do I need a RapidSales account? =
Yes. The plugin is a connector for the RapidSales platform, which provides the WhatsApp Business channel, message templates and delivery.

= Does the plugin store my RapidSales password? =
No. The password is sent once, over HTTPS, to validate your account and is never stored in WordPress.

= Which checkout types are supported? =
Both the classic shortcode checkout and the new block checkout.

= Why did a customer not receive a message? =
The most common reasons are a missing/inactive Template Config for that status on your RapidSales account, or a phone number that is not on WhatsApp. The health section on the settings page points out skipped messages.

= Does it work with order-tracking plugins? =
Yes — shipment tracking details saved by common tracking plugins (e.g. Shipment Tracking / AfterShip) are included in "shipped" messages automatically.

== Screenshots ==

1. Connect your RapidSales account in one step.
2. Messaging settings: flows, COD rules, quiet hours and status mapping.
3. Health summary and send-test-message.
4. A COD confirmation conversation on WhatsApp.

== Changelog ==

= 0.4.1 =
* Code-quality pass for the WordPress.org review (Plugin Check clean).

= 0.4.0 =
* Settings page: flow toggles, COD minimum order value, auto-cancel, quiet hours, per-status message mapping.
* 7-day health summary and send-test-message button.

= 0.3.0 =
* Abandoned-cart capture (classic + block checkout), WhatsApp reminder and one-tap cart recovery link.

= 0.2.0 =
* Self-service connect with RapidSales account credentials.

= 0.1.0 =
* Order status notifications, COD confirmation with Confirm/Cancel write-back.

== Upgrade Notice ==

= 0.4.1 =
First public release.
