Docs/E-Commerce/WooCommerce Integration

WooCommerce Integration

Connect your WooCommerce store to enable live product search, order lookups, cart display, and category browsing from your AI agent. The integration uses WooCommerce's built-in REST API with an OAuth handshake — no plugin installation required.

Prerequisites

  • WooCommerce 3.5 or later.
  • WordPress site served over HTTPS — the WooCommerce REST API requires a valid SSL certificate.
  • WordPress permalinks set to Post name (go to WordPress Admin → Settings → Permalinks, select Post name, and save).
  • The store must be publicly accessible — AIChatVault's servers need to reach your WooCommerce REST API endpoint.

Connecting via OAuth (recommended)

1

Open Integrations → WooCommerce

In your agent's sidebar, click Deploy or Integrations and select the WooCommerce card.
2

Enter your WooCommerce store URL

Type your full store URL, for example https://yourstore.com.
3

Click Connect

You are redirected to your WooCommerce store's OAuth approval page. Log in as an admin and click Approve.
4

Connection confirmed

You are redirected back to AIChatVault. The integration page shows a green Connected status. A background product sync starts automatically.

Connecting manually (fallback)

If the OAuth redirect cannot reach AIChatVault (e.g. your store is on a local network, behind a firewall, or the OAuth callback fails), use the manual connection method:

  • In WooCommerce Admin, go to WooCommerce → Settings → Advanced → REST API.
  • Click Add Key. Set Description to "AIChatVault", User to an admin account, and Permissions to Read/Write.
  • Click Generate API Key and copy both the Consumer Key and Consumer Secret.
  • On the WooCommerce integration page in AIChatVault, expand the Manual connection form and enter your store URL, Consumer Key, and Consumer Secret.

Available actions

ActionDescription
Product Search & RecommendationsSearches the WooCommerce catalogue and shows product cards with images, prices, and direct links.
Order Status LookupRetrieves order status and purchase history by order ID and customer email.
View CartDisplays the customer's current cart contents, quantities, and totals.
Browse CategoriesBrowses WooCommerce product categories to improve product discovery.

Widget embed code

Unlike Shopify, the WooCommerce integration does not auto-inject the chat widget. Copy the widget snippet from the integration page and paste it into your WordPress theme — typically just before the closing </body> tag in your theme's footer.php, or use a plugin like "Insert Headers and Footers" to add it site-wide without editing theme files.

Product sync

After connecting, AIChatVault syncs your WooCommerce product catalogue to the knowledge base. Use the Sync Products button on the integration page to trigger a manual sync at any time — useful after adding new products or making significant catalogue changes.

Disconnecting WooCommerce

Clicking Disconnect removes the integration and clears synced products from the knowledge base. The agent will no longer answer product or order questions from WooCommerce data. The API key you created in WooCommerce remains unless you delete it manually from WooCommerce Admin → REST API.

⚠️
If your WooCommerce site uses a self-signed SSL certificate or is on a local/development server, the OAuth flow and API calls will fail. Use a staging environment with a valid certificate, or connect a production store.

Was this page helpful?