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

# WooCommerce

> What the WooCommerce integration can and can't do, and how to connect it step by step.

# WooCommerce

**Category: E-commerce.** Connect WooCommerce and your widget can find products and check orders for visitors, right inside the chat.

<Note>Integrations are available on the **Pro** and **Business** plans. WooCommerce shares the E-commerce category with Shopify, so only one of the two can be active at a time.</Note>

## What This Bot Can Do

The bot does exactly these actions, nothing more. "Needs sign-in" means the visitor must be identified first; otherwise the bot gives a safe, neutral answer.

| Action                           | What it does                                                                                      | Needs sign-in |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | :-----------: |
| **Search products**              | Search your catalog by keyword and show products with price and image (up to 100).                |       No      |
| **Check order status**           | Look up an order's status and details by the visitor's email.                                     |      Yes      |
| **Update their profile**         | Let a signed-in customer update their own name, phone, or email — they confirm before it's saved. |      Yes      |
| **Update their billing address** | Let a signed-in customer update their own billing address — they confirm first.                   |      Yes      |

<Note>The two update actions are optional. You can turn each one off from the WooCommerce panel if you'd rather keep the bot read-only.</Note>

## What It Can't Do

WooCommerce is scoped to the actions above. It does **not**:

* Add items to a cart or check out from the chat (visitors do that on your store)
* Process returns or change an order from the chat
* Look up an order without the visitor's email

## Part 1 — Connect WooCommerce

BestChatBot connects to WooCommerce automatically. You enter your store address and the connection is authorized for you — the official BestChatBot WordPress plugin handles it, handing BestChatBot a secure, encrypted key. There's nothing to generate, paste, or approve.

<Note>Connecting integrations requires an **Editor**, **Admin**, or **Owner** role. See [Members & Roles](/workspace/members-roles).</Note>

<Steps>
  <Step title="Open the WooCommerce integration" icon="plug">
    In your workspace dashboard, open the **Integrations** tab, find **WooCommerce**, and click **Connect**.
  </Step>

  <Step title="Enter your store address" icon="link">
    In the dialog, enter your store's address (for example `https://shop.example.com`) and click **Connect**. The connection is authorized automatically — there's nothing to approve.

    <Frame>
      <img src="https://mintcdn.com/bestchatbot/2-SeFKQ-UujZE_r-/integrations/wordpress-integration/woocommerce-connect-dialog.png?fit=max&auto=format&n=2-SeFKQ-UujZE_r-&q=85&s=c18d735462b87812adeb9bb04b836bff" alt="WooCommerce connect dialog asking for the store address" width="522" height="333" data-path="integrations/wordpress-integration/woocommerce-connect-dialog.png" />
    </Frame>
  </Step>

  <Step title="You're connected" icon="circle-check">
    The window closes and WooCommerce shows as connected — its actions become available right away. If Shopify was connected, it's disconnected automatically.

    <Frame>
      <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/wordpress-integration-successfuly-connected-dashboard.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=38dd56983f46be1e304139578b1ff6c0" alt="WooCommerce integration connected successfully" width="750" height="1125" data-path="integrations/wordpress-integration/wordpress-integration-successfuly-connected-dashboard.png" />
    </Frame>
  </Step>
</Steps>

From the integration panel you can toggle each **bot capability**.

<Frame>
  <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/integration-connected-options.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=99419beda98c4c3508f86be2540ac404" alt="Connected WooCommerce panel with the bot capability toggles" width="874" height="466" data-path="integrations/wordpress-integration/integration-connected-options.png" />
</Frame>

## Part 2 — Install the Widget on WordPress

Connecting WooCommerce lets the bot read your store. To **show the widget on your site** and let logged-in customers check **their own** orders without typing their email, install the official **Chatbot IO Widget** WordPress plugin. It embeds the widget and signs a short identity token for the logged-in customer, so order lookups are identity-aware out of the box.

### Step 1 — Install the plugin

In WordPress, go to **Plugins → Add Plugin** and search for **Chatbot IO Widget** (by victhedev). Install and activate it.

<Frame>
  <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/official-wp-plugin.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=b678dc3274ae2dd0732999e76f857cd5" alt="Chatbot IO Widget plugin page on WordPress.org" width="1729" height="1134" data-path="integrations/wordpress-integration/official-wp-plugin.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/listed-plugin-wordpress-search.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=cefb7898191cb22b43d68c8f43540d9c" alt="Chatbot IO Widget plugin installed and active in WordPress admin" width="1002" height="577" data-path="integrations/wordpress-integration/listed-plugin-wordpress-search.png" />
</Frame>

### Step 2 — Create a signing key in BestChatBot

In your dashboard, open your **Web Widget → Security** tab and click **Create Signing Key**. This key lets your site sign identity tokens that the widget trusts. Keep it secret.

<Frame>
  <img src="https://mintcdn.com/bestchatbot/97kdRjnWT0Lew0EI/integrations/wordpress-integration/signing-keys-from-dashboard.png?fit=max&auto=format&n=97kdRjnWT0Lew0EI&q=85&s=75eb701e4e5d5d5bc92cb92557dc05c4" alt="BestChatBot Security tab showing Create Signing Key and the JWT payload requirements" width="1177" height="1214" data-path="integrations/wordpress-integration/signing-keys-from-dashboard.png" />
</Frame>

<Note>For the full identity flow and token format, see [Visitor Identity](/integrations/identity/overview).</Note>

### Step 3 — Configure the plugin

Open **Settings → Chatbot IO Widget** in WordPress and enter:

* **API Key** — your widget's public key (`rk_live_...`), found in **Dashboard → Web Widget → Installation**.
* **Signing Key** — the secret key from **Dashboard → Web Widget → Security** (Step 2). Keep it secret.

Save the settings.

<Frame>
  <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/plugin-api-key-and-secret-setup.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=1ed031cb5931749d8b6781f93137c8be" alt="Chatbot IO Widget settings in WordPress with API Key and Signing Key fields" width="1384" height="941" data-path="integrations/wordpress-integration/plugin-api-key-and-secret-setup.png" />
</Frame>

### Done — identity-aware order lookups

The widget now appears on your store, and logged-in customers can ask things like "track my order" and get **their** orders back instantly, with no email prompt.

<Frame>
  <img src="https://mintcdn.com/bestchatbot/WwR07ioD1SK3nvPy/integrations/wordpress-integration/widget-working-on-website.png?fit=max&auto=format&n=WwR07ioD1SK3nvPy&q=85&s=20b8734a1336d13ed56dede2879bd7ef" alt="Widget live on a WooCommerce store showing a logged-in customer's orders" width="2044" height="1231" data-path="integrations/wordpress-integration/widget-working-on-website.png" />
</Frame>

## One per Category

WooCommerce is in the **E-commerce** category with Shopify. Connecting one disconnects the other, so your bot always has a single, clear tool for e-commerce.

<Warning>If you connect WooCommerce while Shopify is active, Shopify is turned off automatically.</Warning>

## Availability

| Plan     | WooCommerce |
| -------- | ----------- |
| Free     | —           |
| Starter  | —           |
| Pro      | ✅           |
| Business | ✅           |

## Next Steps

<CardGroup cols={2}>
  <Card title="Visitor Identity" icon="fingerprint" href="/integrations/identity/overview">
    Set up identity verification for personal actions like order lookups.
  </Card>

  <Card title="Agentic Actions" icon="wand-magic-sparkles" href="/integrations/agentic-actions">
    Learn how the bot turns a request into a real action.
  </Card>
</CardGroup>
