# SpryConnect for WooCommerce

**Contributors:** SpryConnect  
**Tags:** sms, woocommerce, notifications, otp, spryconnect  
**Requires at least:** 5.8  
**Tested up to:** 6.4  
**Requires PHP:** 7.4  
**Stable tag:** 1.0.0  
**License:** MIT  
**License URI:** https://opensource.org/licenses/MIT

Send automated SMS notifications to customers for WooCommerce order status changes using SpryConnect API.

## Description

SpryConnect for WooCommerce integrates your WooCommerce store with SpryConnect's powerful SMS platform, enabling you to send automated SMS notifications to customers when their order status changes.

### Features

* **Automated Order Notifications** - Send SMS when order status changes (Pending, Processing, Completed, etc.)
* **Customizable Templates** - Personalize SMS messages with dynamic variables
* **SMS Logs** - Track all sent messages with detailed logs
* **Connection Testing** - Test your API connection before going live
* **WordPress Native** - Built using WordPress and WooCommerce standards
* **Lightweight** - No bloat, just essential features

### Supported Order Statuses

* Pending Payment
* Processing
* On Hold
* Completed
* Cancelled
* Refunded
* Failed

### Template Variables

Personalize your SMS messages with these variables:

* `{customer_name}` - Customer's full name
* `{customer_first}` - Customer's first name
* `{order_number}` - Order number
* `{order_id}` - Order ID
* `{order_total}` - Order total with currency
* `{order_status}` - Current order status
* `{order_date}` - Order date
* `{payment_method}` - Payment method
* `{shipping_method}` - Shipping method
* `{shop_name}` - Your store name
* `{shop_url}` - Your store URL
* `{shop_email}` - Your store email

## Installation

### Automatic Installation

1. Log in to your WordPress admin panel
2. Navigate to **Plugins > Add New**
3. Search for "SpryConnect for WooCommerce"
4. Click **Install Now** and then **Activate**

### Manual Installation

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Navigate to **Plugins > Add New > Upload Plugin**
4. Choose the ZIP file and click **Install Now**
5. Click **Activate Plugin**

### Configuration

1. Navigate to **SpryConnect > Settings** in your WordPress admin
2. Enter your SpryConnect API credentials:
   - **API Key** - Your SpryConnect API key
   - **API Secret** - Your SpryConnect API secret
   - **Sender ID** - Your approved sender ID (max 11 characters)
3. Click **Test Connection** to verify your credentials
4. Enable notifications for desired order statuses
5. Customize SMS templates as needed
6. Click **Save Changes**

## Frequently Asked Questions

### Where do I get API credentials?

Sign up for a SpryConnect account at [spryconnect.com](https://spryconnect.com) and obtain your API key and secret from the dashboard.

### How much does it cost to send SMS?

SMS costs are based on your SpryConnect plan. Check your account balance in the plugin settings or SpryConnect dashboard.

### Can I customize the SMS messages?

Yes! Each order status has its own customizable template. Use the template variables to personalize messages.

### Will this slow down my checkout?

No. SMS sending happens asynchronously after the order is placed, so it doesn't affect checkout performance.

### Can I see which SMS were sent?

Yes. Navigate to **SpryConnect > SMS Logs** to view all sent messages with status, cost, and delivery information.

### What happens if SMS sending fails?

Failed messages are logged with error details. You can review them in the SMS Logs page.

### Can I send test SMS?

Yes. Use the "Test Connection" feature in settings to verify your API credentials and send test messages.

### Is my data secure?

Yes. All API communications use HTTPS encryption. Your credentials are stored securely in your WordPress database.

## Screenshots

1. Settings page with API configuration
2. Notification toggles for order statuses
3. Template editor with variables
4. SMS logs with filtering

## Changelog

### 1.0.0 - 2026-01-14
* Initial release
* Automated order notifications
* Customizable SMS templates
* SMS logs viewer
* Connection testing
* WordPress Settings API integration

## Upgrade Notice

### 1.0.0
Initial release of SpryConnect for WooCommerce.

## Support

For support, please contact:
* Email: support@spryconnect.com
* Documentation: https://docs.spryconnect.com
* Website: https://spryconnect.com

## Requirements

* WordPress 5.8 or higher
* WooCommerce 6.0 or higher
* PHP 7.4 or higher
* Active SpryConnect account
* Valid API credentials

## Privacy Policy

This plugin sends customer phone numbers and order information to SpryConnect's API for SMS delivery. Please ensure you have appropriate consent from customers and comply with local privacy regulations (GDPR, etc.).

## Credits

Developed by SpryConnect Team  
Uses SpryConnect PHP SDK

## License

This plugin is licensed under the MIT License. See LICENSE file for details.
