=== AddToChat - AI Sales Assistant ===
Contributors: antoinecorvol
Donate link: https://addtochat.com
Tags: woocommerce, chatbot, ai, sales, customer-service
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
WC requires at least: 8.0
WC tested up to: 9.6
Stable tag: 1.4.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered sales chatbot for WooCommerce. Recommends products, adds to cart, captures emails, and boosts conversions automatically.

== Description ==

**IMPORTANT: This plugin requires an account on [AddToChat](https://addtochat.com) and connects to the AddToChat cloud service (https://api.addtochat.com) to provide AI chatbot functionality.**

This plugin sends product catalog data, customer interactions (chat messages), and page context to the AddToChat API for AI processing. The chat widget (loaded from https://cdn.addtochat.com) is embedded on your storefront.

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

A free plan is available (50 conversations/month). No credit card required.

**Turn visitors into customers with an AI sales assistant that knows your entire catalog.**

AddToChat is a conversational AI chatbot purpose-built for WooCommerce stores. It goes beyond basic live chat — it understands your products, recommends the right items, adds them directly to the customer's cart, and captures leads, all in natural conversation.

= AI Product Recommendations =

The chatbot understands customer intent and recommends relevant products from your catalog using semantic search and AI embeddings. It answers questions about sizing, materials, availability, and more.

= One-Click Add to Cart =

Customers can add recommended products to their WooCommerce cart directly from the chat window — no page reloads, no friction.

= Automatic Catalog Sync =

Your product catalog is automatically synchronized with AddToChat whenever you add, update, or remove products. Real-time webhooks keep everything in sync.

= Knowledge Base =

Add custom entries about shipping policies, return policies, FAQs, brand information, and more. The AI uses this context to give accurate, store-specific answers.

= Email & Lead Capture =

The chatbot captures visitor emails naturally during conversations, feeding them into your CRM for follow-up campaigns.

= Full Feature List =

* **AI Product Recommendations** — Semantic search across your entire catalog
* **One-Click Add to Cart** — Add products from chat without page reloads
* **Automatic Catalog Sync** — Real-time sync via WooCommerce webhooks
* **Knowledge Base** — Custom entries for shipping, returns, FAQ, brand info
* **Email & Lead Capture** — Natural email collection during conversations
* **Contacts & CRM** — Segments, conversation history, revenue attribution
* **Bot Configuration** — Name, tone (friendly/formal/expert), welcome message, business rules
* **Widget Customization** — Brand colors, position, display delay
* **AI-Driven Promotions** — Auto-generate unique promo codes during conversations
* **Upsell & Cross-Sell** — Intelligent upgrade and complementary product suggestions
* **Physical Store Locator** — Direct customers to nearest store with geolocation
* **SEO Data Sync** — Sync from Yoast SEO or Rank Math
* **Product Data Enrichment** — ACF fields, GTIN, brand, custom attributes
* **Email Sequences** — Cart abandonment recovery, welcome emails
* **Integrations** — Make, Zapier, Slack, Discord via webhooks
* **Support Ticket Escalation** — Auto-create tickets when AI cannot resolve
* **Dashboard & Analytics** — Conversations, conversion rates, revenue, AI costs
* **Auto-Updates** — Plugin keeps itself current automatically
* **One-Click Setup** — Paste API key, click connect, live in 60 seconds
* **Multi-Language** — AI responds in any language, admin in EN/FR/ES/DE

= Requirements =

* WordPress 6.0 or higher
* WooCommerce 8.0 or higher
* PHP 8.0 or higher
* An AddToChat account ([free tier available](https://addtochat.com))

== Installation ==

1. Upload the `addtochat` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugin screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Navigate to the **AddToChat** menu in your WordPress admin sidebar.
4. Click **"Go to settings"** and paste your API key from your [AddToChat dashboard](https://app.addtochat.com).
5. Click **"Connect and configure"** — the plugin automatically:
   * Connects your WooCommerce store via REST API
   * Synchronizes your entire product catalog
   * Scans your site content for the knowledge base
6. Your AI chatbot is now live on your store. That's it!

= Minimum Requirements =

* WordPress 6.0+
* WooCommerce 8.0+
* PHP 8.0+

== Frequently Asked Questions ==

= Do I need an AddToChat account? =

Yes. Create a free account at [addtochat.com](https://addtochat.com) to get your API key. A free tier is available with limited monthly conversations.

= Which AI model does AddToChat use? =

AddToChat uses state-of-the-art language models optimized for e-commerce conversations. The AI is specifically tuned to understand product catalogs, recommend items, and close sales.

= Does it work with variable products and product variations? =

Yes. AddToChat fully supports WooCommerce variable products, including all variations with their specific prices, stock status, and attributes.

= Will it slow down my store? =

No. The chat widget loads asynchronously via CDN and does not affect your page load time. All AI processing happens on AddToChat's servers, not yours.

= Can I customize what the bot says? =

Absolutely. You can configure the bot's name, tone (friendly, formal, expert), welcome message, and add custom business rules. You also control the knowledge base entries that inform the AI's responses.

= Does it capture customer emails? =

Yes. The AI naturally captures emails during conversations and stores them in your CRM with segmentation and revenue tracking.

= Is it compatible with HPOS (High-Performance Order Storage)? =

Yes. AddToChat is fully compatible with WooCommerce HPOS and declares HPOS compatibility.

= What languages does the chatbot support? =

The AI can converse in any language. The admin interface is available in English, French, Spanish, and German. The chatbot automatically detects and responds in the visitor's language.

== Screenshots ==

1. AI assistant trained on your WooCommerce store
2. AI synced with your WooCommerce catalog
3. Automatically sync your store knowledge
4. AI-powered SEO optimization for WooCommerce
5. Customize your AI widget experience

== Changelog ==

= 1.4.0 =
* Fix: wp.org review compliance — all PHP identifiers, stored options, AJAX actions, nonces, page slugs and cron hooks now use the plugin-specific AddToChat AI Sales Assistant prefix.
* Fix: widget admin JavaScript now lives in `admin/js/widget-view.js` and is loaded with WordPress enqueue APIs.
* Fix: contributor username updated to match the wp.org submitter account.
* Brand-facing strings, the plugin slug `addtochat-ai-sales-assistant`, the text-domain, and the menu label "AddToChat" are unchanged.

= 1.3.7 =
* New: `page.product_image` now exposes the product thumbnail URL so the widget's persistent product-ask card displays the real image instead of the placeholder glyph.

= 1.3.6 =
* Fix: Hub dashboard now correctly detects connected state (`$atc_connected` var mismatch made it always show "Connect your store")
* Fix: Catalog sync now surfaces the real API error (cooldown 3j / already running / domain mismatch) instead of generic "Erreur lors de la synchronisation"
* Fix: Widget admin page links/copy updated to the canonical AddToChat dashboard URL.

= 1.3.5 =
* Fix: wp.org Plugin Check errors — translators: comments moved inside sprintf() calls (5 places in dashboard.php)
* Fix: Missing escape on `min()` and color ternary in dashboard.php progress bar (esc_attr wrapper)
* Fix: Missing escape on hub.php tile icon output (esc_html wrapper)
* Fix: internal file naming adjusted for Plugin Check prefix rules.
* Fix: Template view files now suppress WordPress.NamingConventions.PrefixAllGlobals — template-scoped vars are not true globals
* Fix: Direct DB query in WC auto-connect includes NoCaching sub-rule in phpcs:ignore
* Fix: Jeev FAQ meta_key/meta_value lookup now wrapped in phpcs:disable/enable block

== Upgrade Notice ==

= 1.4.0 =
Improved WordPress.org compliance, widget admin stability, and plugin review compatibility.