=== StoreVoiceAI for WooCommerce ===
Contributors: storevoiceai, kanzucode, kakomap
Tags: woocommerce, ai voice agent, customer support, phone, voice
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.0.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Give your WooCommerce store a 24/7 AI voice agent that answers customer calls day and night. Includes free minutes to get started.

== Description ==

**Every unanswered call is a customer who didn't buy.**

Most WooCommerce stores publish a phone number and then miss half the calls that come in - after hours, during busy periods, over weekends. StoreVoiceAI gives your store a 24/7 AI voice agent that picks up every time, knows your catalog, answers product questions, and helps customers through to purchase.

Install the plugin, connect your StoreVoiceAI account, and your store starts handling voice conversations the same day. **Your account includes free minutes to get started** - no payment required to experience the product with real customers.

[Learn more at storevoiceai.com](https://storevoiceai.com/)

= What StoreVoiceAI does for your store =

* **Answers every call, day and night.** Your AI agent picks up when you can't - after hours, weekends, busy periods. No voicemail. No missed customers.
* **Knows your products.** The agent learns from your existing WooCommerce product pages and site content, so it can answer questions about specific items, sizing, shipping, and returns.
* **Sounds human, not robotic.** Natural-sounding voice conversations powered by the latest conversational AI, not a clunky phone menu.
* **Sits inside your store.** A tasteful call widget on your shop page lets customers start a voice conversation instantly without dialing a number.
* **Gives you a real US phone number.** Provision a dedicated United States phone number for your store so customers can call your business directly.
* **No code, no configuration headaches.** Pick a voice, name your agent, write a short greeting. Done.

= What you get inside the plugin =

* On-site voice call widget (tap to call from your shop page)
* Dedicated inbound phone number with your choice of area code
* Catalog-aware AI conversations powered by your product data
* Choice of natural-sounding agent voices
* Custom agent name and opening greeting
* Knowledge base built from your existing site pages
* Call analytics dashboard inside your WordPress admin
* Detailed call logs with timestamps and conversation metadata

= Who this is for =

* Solo founders and small teams who cannot be on-call around the clock
* Stores where customers ask questions before buying (fashion, electronics, beauty, home goods)
* Businesses that want to cover after-hours demand without hiring staff
* Anyone who suspects missed calls are costing them revenue

= Limitations =

Phone number provisioning is currently limited to United States phone numbers. International phone number support is on the roadmap, but there is no committed release date yet.

= How it works =

1. Install and activate the plugin (WooCommerce required).
2. Connect your StoreVoiceAI account - your account includes free minutes to get started.
3. Pick a voice, name your agent, and write a short greeting.
4. (Optional) Provision a phone number for inbound calls.
5. Done. Your agent is live and ready to talk to your customers.

= External Service =

This plugin relies on the StoreVoiceAI cloud service to deliver real-time AI voice conversations. It is the only third-party service the plugin contacts.

**Service used:** StoreVoiceAI, operated by Kanzu Code Inc.
**Endpoint:** https://api.storevoiceai.com/v1/api/

**What it is used for:**

* Provisioning and updating your AI voice agent (name, voice, greeting, knowledge base).
* Initiating and routing voice calls between your customers and the AI agent.
* Provisioning and managing inbound phone numbers (US area codes).
* Returning call logs, call analytics, and minutes-usage information for display inside your WordPress admin.
* Synchronizing your store's WooCommerce product data and selected knowledge-base pages so the agent can answer customer questions about your catalog.

**What data is sent and when:**

* When you activate the plugin and connect your account, the plugin sends your site URL, site name, and a generated WooCommerce REST API key so the service can read your catalog on your behalf.
* When you configure your agent or knowledge base in the plugin admin, the corresponding settings (agent name, voice selection, greeting, list of knowledge-base pages) are sent to the service.
* When a customer initiates a voice call through the on-site widget or your provisioned phone number, the call audio is streamed to the service for real-time AI processing.
* When you open the admin dashboards, the plugin requests aggregated call logs and minutes usage from the service.

No data is sent to the service until the plugin is connected to a StoreVoiceAI account by a site administrator. Call audio is not stored inside your WordPress database; only summaries and metadata are persisted locally.

**Account required:** Yes. The plugin is an interface to the StoreVoiceAI cloud service and will not function without a StoreVoiceAI account. Sign up at [storevoiceai.com](https://storevoiceai.com/). Accounts include free minutes to get started; additional minutes are available on paid plans.

**Legal:**

* Terms of Service: [https://storevoiceai.com/terms](https://storevoiceai.com/terms)
* Privacy Policy: [https://storevoiceai.com/privacy](https://storevoiceai.com/privacy)

By installing and activating this plugin you agree to the StoreVoiceAI Terms of Service and Privacy Policy.

= About =

StoreVoiceAI is built and supported by Kanzu Code Inc, a team that has been building tools for online businesses for over a decade.

For pricing, demos, and account setup, visit [storevoiceai.com](https://storevoiceai.com/).

== Installation ==

= Requirements =

* WordPress 5.0 or higher
* WooCommerce 5.0 or higher (installed, activated, and configured with a currency)
* PHP 8.0 or higher
* A StoreVoiceAI account - sign up free at [storevoiceai.com](https://storevoiceai.com/)

= Installing from the WordPress admin =

1. In your WordPress admin, go to **Plugins -> Add New** and search for "StoreVoiceAI for WooCommerce."
2. Click **Install Now**, then **Activate**.
3. A new **StoreVoiceAI** menu will appear in your admin sidebar. Open it to connect your account and configure your agent.

= Installing manually =

1. Download the plugin zip from your StoreVoiceAI account or from the WordPress plugin directory.
2. In your WordPress admin, go to **Plugins -> Add New -> Upload Plugin**.
3. Choose the zip file, click **Install Now**, then **Activate**.

= Installing via FTP =

1. Unzip the plugin file.
2. Upload the `storevoiceai-for-woocommerce` folder to `/wp-content/plugins/` on your server.
3. In your WordPress admin, go to **Plugins** and activate **StoreVoiceAI for WooCommerce**.

== Frequently Asked Questions ==

= Do I need WooCommerce installed? =

Yes. StoreVoiceAI is purpose-built for WooCommerce stores and will not activate without WooCommerce installed, activated, and configured with a store currency set.

= Do I need a StoreVoiceAI account? =

Yes. The plugin is an interface to the StoreVoiceAI service, where AI conversations are processed in real time. You can create an account at storevoiceai.com. Your account includes free minutes so you can experience the product with real customers before choosing a paid plan.

= What happens to my dashboard and call logs when my free minutes are used? =

Your dashboard, call analytics, and full call logs remain completely accessible. You can review every conversation, see trends, and manage your agent settings at any time. Additional call minutes are available through a paid plan at storevoiceai.com.

= Will my customers know they're talking to an AI? =

We recommend being transparent with your customers. Your agent's name and opening greeting are fully customizable, so you can introduce them however suits your brand.

= Can I choose how the agent sounds? =

Yes. You can pick from a range of natural-sounding voices in the **Settings** page inside the plugin.

= Can customers call a real phone number? =

Yes. You can provision a dedicated phone number directly from the **Phone Numbers** section in the plugin. Pick a US area code and the number is ready in seconds.

= How does the agent know about my products? =

The agent uses your store's WooCommerce product data and any pages you add to its knowledge base. You manage which content it learns from inside the plugin.

= Where can I see how my agent is performing? =

The plugin includes a **Dashboard** with call volume, duration trends, and analytics, plus full **Call Logs** showing every conversation with timestamps and details.

= Does the plugin work with my theme? =

The on-site call widget is a small, self-contained button that sits on your shop page. It is designed to work alongside any well-built WooCommerce theme without conflicts.

= What if the agent doesn't know the answer to a question? =

The agent stays on-brand and politely redirects the conversation to what it can help with. You can shape its behavior and persona through the agent settings.

= Where can I get support? =

For support, account help, and demos, visit [storevoiceai.com](https://storevoiceai.com/).

== Changelog ==

= 0.0.10 =
* New: Free-plan paywalls on the billing and usage pages guide you to upgrade before using paid features, with clearer messaging about what each plan unlocks.
* Improvement: Checkout now shows a circular progress indicator so you know the top-up is being processed.
* Improvement: Refined billing card styling for a cleaner, more readable billing and usage page.
* Fix: Wallet transactions now show clearer loading feedback and the skeleton placeholder no longer lingers after data loads.

= 0.0.9 =
* New: Wallet top-ups now open Stripe checkout directly on the billing page and credit your balance.
* New: The billing page lists your recent wallet transactions with amounts and running balance.
* Improvement: Plan minutes, wallet balance, and the per-minute overage rate now reflect live account data.

= 0.0.8 =
* New: First-run spotlight tour introduces the dashboard so new users know where the agent lives.
* New: Place a real demo call to your agent from inside the onboarding wizard before going live.
* New: Shipping policy, returns policy, and contact email are now managed as site-wide settings, kept in sync between onboarding and Settings.
* Improvement: Agent name and greeting are saved as soon as you leave the first onboarding step, so your work persists if you stop partway.
* Improvement: The Transfer Phone Number card shows a loading shimmer while it checks your subscription and provisioned number, so it no longer flashes a locked state.
* Fix: Reloading the onboarding wizard on the Policies step now correctly resumes on that step instead of jumping to the final screen.
* Fix: The bundled dependencies were stale and incorrectly required PHP 8.1, which blocked installation on PHP 8.0 sites. The plugin now installs and activates on PHP 8.0 as documented.

= 0.0.7 =
* New: Guided first-run onboarding wizard for connecting your account and setting up your agent.
* New: Set your agent's working hours and a transfer phone number to route calls to a human.
* New: Your product catalog now syncs to your agent automatically when you add, edit, or delete a product.
* New: Resolution analytics on the dashboard, plus alerts when your minutes are running low.
* New: Sync your call logs on demand from the Call Logs page.
* Improvement: Preview agent voices with sample audio before choosing one.
* Improvement: Clearer error messages and more reliable handling of connection problems.
* Improvement: Phone number setup now shows loading states and clearer limits.
* Change: Minimum PHP requirement lowered to 8.0.

== Privacy ==

StoreVoiceAI processes conversation audio and metadata through the StoreVoiceAI service (storevoiceai.com) to deliver AI voice conversations. The plugin does not store call audio inside your WordPress database. Call logs and analytics displayed in the WordPress admin are summaries only.

This plugin transmits your store's product data and knowledge base content to the StoreVoiceAI service to power agent responses. No data is transmitted until the plugin is connected to a StoreVoiceAI account by an authorized site administrator.

For complete privacy information, see the StoreVoiceAI Privacy Policy at storevoiceai.com.
