=== Mobile Sasa SMS ===
Contributors: mobilesasa
Tags: sms, woocommerce, order notifications, kenya, bulk sms
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

SMS order notifications for WooCommerce and manual SMS sending through Mobile
Sasa - Kenyan sender IDs, KES billing, M-Pesa top-up.

== Description ==

Send SMS from your WordPress site through [Mobile Sasa](https://mobilesasa.com),
the Kenyan bulk SMS platform.

* **WooCommerce order notifications** - text your customer when their order is
  received, completed, on hold, cancelled, refunded or failed. One editable
  template per status, with placeholders for the customer's name, order number
  and total. Every send (and every failure) is recorded as an order note.
* **Manual sending** - Tools → Send SMS takes a list of numbers and a message.
* **Balance on your dashboard** - a widget shows your SMS units, and a warning
  appears when they fall below a threshold you set.
* **Your own sender ID** - messages arrive from your registered Mobile Sasa
  sender ID, not a shared shortcode.

You need a Mobile Sasa account (free to create at
[account.mobilesasa.com](https://account.mobilesasa.com)) and an API token
scoped to *Send messages*. Top up in KES via M-Pesa or card.

== External services ==

This plugin talks to the Mobile Sasa API at `api.mobilesasa.com`. To deliver a
message it transmits: the recipient phone number, the message content (which
may include the customer's name and order details), your sender ID, and your
API token. The plugin also identifies your site's URL in its User-Agent so
Mobile Sasa can assist with support requests. No other data leaves your site.

* [Mobile Sasa terms of service](https://mobilesasa.com/legal/terms)
* [Mobile Sasa privacy policy](https://mobilesasa.com/legal/privacy)

== Installation ==

1. Install and activate the plugin.
2. In the Mobile Sasa portal, create an API token under Settings → API Tokens
   (scope: *Send messages*).
3. In WordPress, open Settings → Mobile Sasa SMS, paste the token, choose your
   sender ID, and send yourself a test.
4. With WooCommerce active, tick the order statuses you want to text about and
   adjust the templates.

== Frequently Asked Questions ==

= Which phone number formats work? =

Kenyan local (0712345678) and international (254712345678 or +254712345678).
Normalisation happens server-side.

= Does it work without WooCommerce? =

Yes. Manual sending, the balance widget and the low-balance warning work on any
WordPress site; only the order notifications need WooCommerce.

= Is each status texted more than once? =

No. One SMS per status per order, even if another plugin bounces the status
back and forth.

== Changelog ==

= 1.0.0 =
* First release: WooCommerce order-status notifications, manual sending,
  balance widget, low-balance warning, per-status templates.
