=== DataFlows SMS for WooCommerce ===
Contributors: dataflows, hamzabutaleb
Tags: sms, woocommerce, notifications, order, abandoned cart
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automated SMS notifications for WooCommerce orders using your DataFlows account.

== Description ==

**DataFlows SMS for WooCommerce** connects your WooCommerce store to your [DataFlows](https://dataflows.com.au) SMS account, enabling automated text message notifications for your customers.

**This plugin is a connector for the DataFlows SaaS platform.** An active DataFlows account is required to use this plugin. Sending SMS messages is handled by DataFlows' servers — customer phone numbers and message content are transmitted to DataFlows' API (sms.dataflows.com.au) solely for the purpose of sending the requested SMS. Please review the [DataFlows Privacy Policy](https://dataflows.com.au/privacy-policy) and [Terms of Service](https://dataflows.com.au/terms) before use.

**Features:**

* Order confirmation SMS — sent instantly when a new order is placed
* Order shipped SMS — sent when order status changes to Completed
* Order cancelled SMS — sent when an order is cancelled
* Refund notification SMS — sent when a refund is processed
* Welcome SMS — sent when a new customer account is created
* Abandoned cart SMS — sent to logged-in customers who leave without checking out
* Custom message templates with dynamic variables
* Sender ID selection from your DataFlows account
* Automatic phone number formatting (local and international formats supported)
* One-click API connection test

**Requirements:**

* An active DataFlows account — [sign up at dataflows.com.au](https://dataflows.com.au)
* WooCommerce 6.0 or higher
* WordPress 5.8 or higher

== External Services ==

This plugin connects to the DataFlows SMS platform to send text messages to your customers.

* **Service:** DataFlows SMS API
* **URL:** https://sms.dataflows.com.au
* **Data sent:** Customer phone number, order details, and message content — only when a notification is triggered
* **Purpose:** Delivering SMS notifications on your behalf
* **Privacy Policy:** https://dataflows.com.au/privacy-policy
* **Terms of Service:** https://dataflows.com.au/terms

No data is sent to DataFlows' servers unless you have entered a valid API token and enabled at least one notification type.

== Installation ==

1. Upload the `dataflows-sms` folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins → Installed Plugins**
3. Go to **DataFlows SMS → Settings**
4. Paste your API token (found in DataFlows → Developers → Settings)
5. Click **Test Connection** to verify
6. Set your default country code (e.g. 61 for Australia)
7. Enable the notifications you want and click **Save Settings**
8. Optionally customise message templates under **DataFlows SMS → Templates**

== Frequently Asked Questions ==

= Where do I find my API token? =
Log into your DataFlows account at sms.dataflows.com.au, then go to **Developers → Settings**. Your API token is displayed there.

= Which phone number format should customers use? =
Any format works — the plugin automatically converts local numbers to international format using the country code you set in the plugin settings. Australian numbers entered as 0412345678 are automatically converted to +61412345678.

= Does abandoned cart work for guest customers? =
No — abandoned cart SMS only works for logged-in customers who have a billing phone number saved in their profile.

= Can I use a custom sender name (alphanumeric sender ID)? =
Yes — once your sender ID is registered and approved in your DataFlows account, it will appear in the Sender ID dropdown in the plugin settings.

= Is customer data stored by this plugin? =
No — the plugin does not store any customer data locally beyond standard WooCommerce order data. Phone numbers are transmitted directly to DataFlows' API only at the moment an SMS is triggered.

= Does this plugin work outside Australia? =
Yes — DataFlows supports international SMS. Set the correct country code in the plugin settings for your store's country.

== Changelog ==

= 1.0.0 =
* Initial release
* Order confirmation, shipped, cancelled, and refund notifications
* Welcome SMS for new customer accounts
* Abandoned cart recovery SMS
* Custom message templates
* Automatic phone number formatting
