> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> How to connect your WooCommerce store to a ChatNorris agent to look up verified orders and answer live price and stock, and import the catalog and product variations into the knowledge base.

# WooCommerce

With the WooCommerce integration, your ChatNorris agent answers about your store's orders and inventory without leaving the chat. Depending on what you turn on, the agent:

* tells the status, total and items of an order, only after verifying that it belongs to the visitor;
* searches products (by SKU or by name) and answers the current availability and price;
* uses your product catalog and its variations (size, color, dimensions) as a knowledge source to answer general questions.

It works in the web widget, WhatsApp, Instagram, Messenger, Telegram, Email, and the API.

## Requirements

* A ChatNorris account on the **Standard** or **Premium** plan. You can see the plans at [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* At least one agent created in ChatNorris. If you don't have one yet, follow [Create an agent](https://docs.chatnorris.ai/en/guias/crear-agente-wizard.md).
* A WooCommerce store with the REST API enabled and access to the WordPress dashboard to generate the API keys (Consumer key and Consumer secret).
* The **Owner** or **Admin** role in your ChatNorris organization.

## Connect WooCommerce

Each agent connects to one WooCommerce store. You connect it only once in **Integrations**, and both the WooCommerce Action and the WooCommerce knowledge source use that connection.

**1. Generate the API keys in WooCommerce**

In the WordPress dashboard, open **WooCommerce → Settings → Advanced → REST API** and generate a key. Copy the **Consumer key** and the **Consumer secret**.

**2. Open the agent's Integrations hub**

In ChatNorris, go to `My agents → [your agent] → Integrations` and choose **WooCommerce**.

**3. Fill in the details and connect**

Enter the **Store URL**, the **Consumer key** and the **Consumer secret**, and click **Connect**.

**4. Test the connection**

Use **Test connection** to confirm that the credentials work before you use them in the Action or in the knowledge source.

The keys are stored encrypted: the hub only shows their last 4 characters. If you rotate the keys in WooCommerce, use **Replace key** in the row's **···** menu; the connection stays the same, so the Action and the source that use it are not affected.

> [!TIP]
>
> ChatNorris only reads orders and products from your store: it doesn't create or change anything in WooCommerce.

## Configure the Action

Connecting the store doesn't turn anything on yet. To choose what the agent can look up:

**1. Create the WooCommerce Action**

Go to `My agents → [your agent] → Actions`, click **New action**, and choose **WooCommerce**. If you haven't connected the store yet, the screen takes you straight to **Integrations**.

**2. Choose what data the agent can look up**

In **Data access** (see the table below).

**3. Configure order verification**

With **Order verification** on, the agent requires the order number plus at least one of these details before showing any information: **Billing email**, **Billing phone**, or **Billing postal code**.

**4. Enable the Action and save**

Turn on **Enabled** in the **General** section and save. From then on, the agent uses your store in all its conversations.

| Capability | What it does |
| - | - |
| **Orders** | Looks up the status, total and items of an order, only after verifying the buyer's identity. |
| **Inventory** | Searches products by SKU or by name and answers the current availability and price. |
| **Customer data** | Reserved for future use. Keep it off: for now it does nothing even if you turn it on. |

> [!WARNING]
>
> **Claude Sonnet or higher is recommended** as the agent's main model (**Settings → AI**). The action reveals an order's data only after verifying it, and in testing Haiku sometimes answers as if the data were already confirmed even when it isn't. The action's form shows this notice with a link to the AI settings.

> [!NOTE]
>
> **One store per agent.** An agent can have only one active store for looking up orders and stock (for example WooCommerce or Odoo). If you try to enable a second one, ChatNorris asks you to first turn off order and stock lookup in the other one. [Odoo](https://docs.chatnorris.ai/en/guias/odoo.md) can stay active for leads and tickets alongside a WooCommerce store.

### How the visitor looks up an order

In the **web widget**, when the agent detects that the visitor wants an order's status, it doesn't ask for the details by text: it shows an **embedded form** inside the chat with two fields — **Order number** and **Email or phone used for the purchase**. The form and the answer are shown in the widget's language (Spanish, English, or Portuguese), and it's the same for WooCommerce and Odoo. While the form is pending, the visitor can't write another message until they fill it in or cancel it.

* If the details match a real order, the agent answers with the status, total and items.
* If they don't match, the agent says it couldn't verify the order and asks the visitor to check the number and the contact detail — it never shows unverified information.
* An order that doesn't exist and a detail that doesn't match get the same answer, so no one can guess order numbers. After 5 failed attempts in the same conversation, order lookup is blocked.

In **WhatsApp** and **Instagram** (where there are no embedded forms), the agent asks for these same details conversationally, in the text chat.

### Price and stock lookup

With **Inventory** on, the agent queries the store every time it's about to talk about a product's price or stock, even if it already looked it up earlier in the conversation: price and availability come from your store at that moment, not from the knowledge base.

If the visitor asks for a recommendation without naming a product ("what do you recommend for 5 people?"), the agent queries the live catalog and suggests one or two specific options with their price, avoiding those that are out of stock.

With the Action active, the **Knowledge Base** source list also shows the informational row **Live WooCommerce catalog**, with the **Live** label and the **View action** link. It isn't a source: it indicates that the agent checks price and stock directly in the store in every conversation, so it doesn't use characters or need syncing.

## Import the catalog into the knowledge base

You can bring your WooCommerce store's product catalog into the knowledge base as another source, so the agent answers general questions about products (not just specific availability). You only need the store connected in **Integrations**: you don't need the WooCommerce Action active, which is configured separately (order and stock lookup).

**1. Open the WooCommerce source**

Go to `My agents → [your agent] → Knowledge Base → Add source` and choose **WooCommerce**. If the store isn't connected yet, click **Connect in Integrations**: there you enter the store URL and the WooCommerce API keys, only once per agent.

**2. Click Sync catalog**

With the store connected, go back to the WooCommerce source and click **Sync catalog** (or **Resync** if you had already brought in the catalog before). You can also do it from the **Knowledge Base** section of the WooCommerce Action's settings screen.

**3. Wait for processing**

Up to 2,000 published products are brought in. For each one, it indexes: name, SKU, price, availability (in stock / out of stock) and description. It goes through the same processing pipeline as any other source (Pending → Processing → Ready).

> [!TIP]
>
> If you also have the WooCommerce Action active to look up orders or stock, sync the catalog too so the agent answers general product questions.

> [!NOTE]
>
> This source appears with its own **WooCommerce** filter in the knowledge base table, and it has no **Edit** button — the content is generated automatically from your store, it isn't edited by hand.

> [!WARNING]
>
> Catalog sync is manual: there's no auto-sync for this source. If prices, stock or products change in your store, click **Sync catalog** again to update the knowledge base.

> [!TIP]
>
> This is different from the WooCommerce Action's real-time inventory lookup: the synced catalog is for general product questions ("what t-shirts do you have?"), while the Action looks up the specific stock and price at the time of the conversation.

### Product variations (size, color, etc.)

If your store has **variable products** (for example, a t-shirt with different sizes and colors), in the same panel you'll find **Product variations**. **Generate variations** creates a map from attributes (dimensions, color, etc.) to SKU for all products with variations, so the agent can answer questions about features without relying only on the live lookup. With **View generated content** you review the result, and with **Download .txt** you download it.

This content is regenerated on every sync and can't be edited: if you need corrections, add them in a separate text source. Unlike the catalog, variations resync automatically at your plan's frequency: weekly on Standard and daily on Premium.

> [!NOTE]
>
> An agent uses a store through the API or through its public site, not both. If it already has the WooCommerce Action with order or stock lookup active, the panel of the [Online store (public site)](https://docs.chatnorris.ai/en/guias/knowledge-base.md#online-store-public-site) source warns you and takes you to **Actions**.

## Credits

Connecting and testing the store doesn't use credits. Each agent response that queries your store live (orders, or price and stock) adds **0.5 AI credit** to the response's normal cost, only once per response. Tests in the Playground don't add this charge. The imported catalog and variations use characters of your knowledge base like any other source. See [AI models and credits](https://docs.chatnorris.ai/en/guias/modelos-ia-creditos.md).

## Pause or disconnect

* **Pause:** turn off the **Active** switch on the WooCommerce row in **Integrations**. The credentials are kept, but the Action can't query the store and the knowledge source doesn't sync; content already indexed is still used. Turn the switch back on to resume it.
* **Disconnect:** from the **···** menu or the WooCommerce detail, click **Disconnect**. Before you confirm, ChatNorris shows you what depends on the connection. The WooCommerce Action is turned off, but its configuration is kept; the knowledge source is deactivated, but content already indexed is kept. The keys are deleted from ChatNorris.

To use the Action and the source again, connect the store again and reactivate them. If you're no longer going to use the keys, revoke them in **WooCommerce → Settings → Advanced → REST API**.

## Frequently asked questions

> [accordion] Does WooCommerce work with any store?
>
> You need a WooCommerce store with the REST API enabled and credentials (Consumer key and Consumer secret) generated from the WordPress dashboard. Use **Test connection** in Integrations to confirm that everything is set up correctly.

> [accordion] Does the order lookup form also appear in WhatsApp and Instagram?
>
> No, the embedded form is exclusive to the web widget. In WhatsApp and Instagram the agent asks for the order number and the verification detail conversationally, in the text chat.

> [accordion] Does the product catalog update on its own?
>
> No. Syncing the catalog to the knowledge base is manual — click **Sync catalog** every time you want to bring in changes to prices, stock or new products. Variations do resync on their own at your plan's frequency, and the price and stock the Action answers always come from the live store.

> [accordion] I already had WooCommerce connected from the Action itself. Do I need to reconnect?
>
> No. Existing connections were migrated automatically to the Integrations hub — you'll find them already connected there. You only need to reconnect if the connection shows as **Needs attention**.

> [accordion] Can I connect two WooCommerce stores to the same agent?
>
> No. Each provider supports only one connection per agent. If you need to connect different stores, use separate agents.

> [accordion] Can I use Jumpseller and WooCommerce in the same agent?
>
> No. An agent uses a single store so it doesn't answer two different prices for the same product. If you have two stores, create one agent for each. See [Jumpseller](https://docs.chatnorris.ai/en/guias/jumpseller.md).

> [accordion] Can I use Laudus and WooCommerce in the same agent?
>
> Yes, with one condition: prices and stock come from only one of the two. The usual setup is to leave stock and price in Laudus, and order lookup in WooCommerce. If you import both catalogs into the knowledge base, the agent sees the products twice: keep only one active. See [Laudus](https://docs.chatnorris.ai/en/guias/laudus.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.