User Manual — Xabia Woo (WooCommerce addon)

Addon: Xabia Woo v1.0.4 · Core required: ≥ 1.0.166 (recommended)

Quick Installation Guide

1. Install and activate Xabia Agent Core ( v1.0.166 or higher recommended).
2. Install and activate Xabia Woo ( xabia-woo-1.0.4.zip ) from Plugins → Add new → Upload plugin .
3. In Xabia Agent → Addons , activate or synchronize the xabia-woo subscription until you see Hub Polar: active .
4. If the store is on the same WordPress site, confirm that WooCommerce is active and has products listed.
5. If the store is on another website, fill in the remote SQL credentials and the public URL of the Woo store (remote) in the agent.
6. In the agent, select Information Source → Native Addon → WooCommerce and click Connect and Map .
7. Save, tap Sync data and, if using vector search, tap Train AI .
8. Test product queries, stock, offers, and cart buttons in Playground before publishing.

CPT Assistant (≥ Core 1.0.162): with Woo add-on source, lists only product . Hybrid Remote (≥ 1.0.163): SQL host or remote store URL → remote catalog even if WC is installed. Deep schema/curation CPT displays Woo metadata ( _price , _sku , stock, etc.).

Part 1 — What it is and what it is for

1.1 Brief definition

Xabia Woo is a standalone plugin that installs alongside Xabia Agent Core and WooCommerce . It connects your assistant to your store’s product catalog to:

• Synchronize published products to the agent’s knowledge base (text and, if configured, vectors for semantic search).
• Respond with titles, prices, offers, stock, SKU, categories , and listing links taken from WooCommerce.
• Manage variable products (attributes and variations with price/stock in the Rich Summary field).
• Display “Add to Cart” buttons starting from the tag [ACTION:CART:ID] , where ID is the numeric identifier of the product row (connector ID column).
• Suggest published and valid coupons when the AI deems it appropriate (only real codes obtained from the store; the AI should not invent them).
• Record conversions linked to the chat (when the visitor buys after a recommendation in the same session) in the Core conversions table.

It does not replace WooCommerce’s tax, shipping, payment gateway, or legal policy settings ; it’s a conversation and sales-assisted layer built on top of the data you already have in WordPress.

1.2 What problem does it solve?

Without this add-on, an assistant can make up prices or products.

With Xabia Woo , responses rely on coordinated SQL queries to published product and standard metadata ( _price , _stock_status , etc.), on context rules (“Special Offer”, use of ADDON DISCOVERY ) and on the theme’s AJAX cart and WooCommerce.

1.3 Product identification (useful reference)

• Polar Store (subscription): https://polar.sh/xabia
• The addon slug in the Hub is usually xabia-woo (aliases such as woo / woocommerce are also recognized depending on the provider’s configuration).

1.4 Essential requirements

Part 2 — Step-by-step installation

2.1 Before starting

1. Have the following ZIP files or packages: Xabia Agent Core , WooCommerce (from WordPress.org or your reseller) and Xabia Woo .
2. Please confirm that your hosting allows REST/admin-ajax for the shopping cart and license.

2.2 Recommended activation order

1. Xabia Agent Core → Activate.
2. WooCommerce → Activate and complete the minimum store wizard if you haven’t already.
3. Xabia Woo → Activate after Core.

If you activate Xabia Woo without the Core, you will see a warning on the desktop: you must first activate Xabia Agent Core .

2.3 Install Xabia Woo from ZIP

1. Log in as administrator .
2. Plugins → Add new → Upload plugin .
3. Choose the Xabia Woo ZIP file.
4. Install now → Activate plugin .

2.4 Verify that WordPress recognizes the plugin

Xabia Woo should appear in Plugins . In Xabia Agent → Addons , the “Xabia — WooCommerce” card should display the WordPress status (active / installed / not installed) next to the xabia-woo/xabia-woo.php file.

Part 3 — “Addons” screen: Polar subscription and license

Open Xabia Agent → Addons .

There you can manage all the commercial options of the Woo add-on.

3.1 General screen texts

• The “Polar Hub: active / inactive” badge indicates whether the license includes the xabia-woo addon depending on the Hub (not to be confused with simply having the ZIP file active).
• The “Synchronize licenses with the hub” button forces a new check for all cards.
• “Subscribe” (when the Hub is inactive) opens the Polar store for the Woo product (not to be confused with the MEC addon checkout).
• If you see “Add-on not included in the plan” with a valid Core license: the hub does not have xabia-woo in addon_activations for your key (the Woo product is missing from Polar or the UUID of the product is missing from the hub server).

3.2 After purchasing or renewing

1. Paste the license key if your workflow uses it on the addon card.
2. Click Activate / Update subscription or Sync license .
3. Reload Addons and confirm Polar Hub: active for Woo.

Part 4 — Agent Configuration (source «WooCommerce Addon»)

Edit the agent who should report the catalog or assist the sale.

4.1 Font type

In «Source of information» :

• Choose “Native Addons (External Connector)” when the Core detects Xabia Woo and the Hub license is valid.

4.2 Addon selector

In the addon dropdown, choose “WooCommerce — catalog and sales” (internal slug woo ).

4.3 “Connect and Map” Button

1. Click “Connect and Map” for a test query (one row) and list columns.
2. If Hub Polar is inactive for Woo, you will see a license error; fix Addons before continuing.
3. Apply the suggested column preset for products (see table below).

4.4 Typical fields of the mapping preset

4.5 Save

Click “Save agent” to persist source_type , addon_slug , mapping, and SQL credentials if you would use them in a remote scenario.

4.6 Remote store without local WooCommerce

Xabia Woo can function as a remote catalog : the chat site has Xabia Woo active and Hub licensed, but the actual store lives on another WordPress site with WooCommerce.

Then:

1. Keep Source of information → Native addon → WooCommerce .
2. Fill in the remote SQL credentials ( Host , DB , User , Password and Prefix if not wp_ ).
3. Fill in the public URL of your Woo store (remote) , for example https://tu-tienda.com .
4. Press Connect and Map , save and sync.

The chat will use products from the remote database. When you generate an [ACTION:CART:ID] button, the frontend will display a direct purchase link to the remote store ( ?add-to-cart=ID ) instead of attempting to add the product to the local WordPress cart. Variable products will typically lead to a product page where the visitor can choose a variant.

Part 5 — Memory, synchronization, and playground

After changing prices or stock in bulk, resynchronize (and train if using vectors).

Part 6 — Best practices in WooCommerce

• Keep published products consistent (prices, taxes visible according to your template).
• In variables , define clear attributes so that the Rich Summary lists useful combinations.
• The coupons that AI can mention are only those that have been published , with a usage limit and an unexpired date; it does not replace eligibility rules by product or email in WooCommerce.

Part 7 — Visitor Experience in Chat

• The AI receives sales rules and a summary of recent products when the project uses Woo .
• If you recommend a product with a cart action, the frontend displays an add to cart button (requires WooCommerce active on the chat page).
• Variable products: sometimes it is necessary to choose a variation in the data sheet ; the Summary may include lines that guide the visitor.
• After adding to cart, the visitor can complete the order in WooCommerce; if the purchase follows a recommendation in session, an internal conversion may be recorded (see next part).
• If the catalog is in a remote store, the tabs, cart, and coupons are resolved to the domain configured as the Woo store’s public URL (remote) .
• The Core can automatically translate product information and context when a visitor asks in another language;

  The shortcode language is used as an interface backup, not as a response blocker.

Part 8 — Conversions and ROI (reference)

When the Xabia add-on is activated, it creates a simple conversion log (agent, order, amount, products, and date) when a WooCommerce purchase follows a recent chat recommendation. This is for internal ROI analysis and does not replace native WooCommerce reports.

Part 9 — Common Problems

Quick checklist: Active Core → Active WooCommerce → Active Xabia Woo → Active Hub → Addon Source + Woo → Connect and Map → Save → Sync → Train (if applicable) → Playground .

Part 10 — Support

• Xabia/Digixop (licenses, Hub, Xabia Woo): help@xabia.ai .
• WooCommerce (payments, shipping, themes, third-party disputes): support from your provider or WooCommerce.com as appropriate.

For main license, tokens and wallet , see the Core Manual .