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

# WooCommerce

> Connect your WooCommerce store for order tracking and product search

Transform your chatbot into a powerful e-commerce assistant for your WooCommerce store. Customers can track orders, search products, and get instant answers about your store.

## Why Connect WooCommerce?

<CardGroup cols={2}>
  <Card title="Order Tracking" icon="truck">
    Customers check order status using order numbers
  </Card>

  <Card title="Product Search" icon="magnifying-glass">
    Interactive product discovery with filters and pricing
  </Card>

  <Card title="Visitor Insights" icon="chart-user">
    Support agents see order history and customer value in real-time
  </Card>

  <Card title="24/7 Automation" icon="clock">
    Reduce support workload with accurate, instant info
  </Card>
</CardGroup>

## Visitor Insights for Support Agents

The WooCommerce integration enriches the **Visitor Insights** panel in your BubblaV dashboard, providing support agents with critical customer context during live chats:

* **Order History**: A detailed list of current and past orders with fulfillment and payment status
* **Order Tracking**: Real-time tracking information including carrier, tracking numbers, and delivery status
* **Product Details**: View exactly which products were ordered, including images and itemized prices
* **Admin Access**: Direct links to view orders in your WooCommerce admin for quick management
* **Returns & Cancellations**: Handle return requests and order cancellations - creates order notes and updates status for merchant visibility

## Prerequisites

* Active WooCommerce store (WordPress with WooCommerce plugin)
* Administrator access to your WordPress dashboard
* WordPress 5.0+ (recommended)

## Setup Steps

<Steps>
  <Step title="Install the Plugin">
    Visit the <a href="https://wordpress.org/plugins/bubblav-chat/" target="_blank">BubblaV plugin page</a> on WordPress.org and follow the installation instructions, or search for "BubblaV" in your WordPress admin → Plugins → Add New.
  </Step>

  <Step title="Activate the Plugin">
    After installing, click <strong>Activate</strong> on the plugin page in your WordPress admin.
  </Step>

  <Step title="Connect to BubblaV">
    In your WordPress admin, go to <strong>Settings</strong> → <strong>BubblaV Chat</strong>, then click <strong>Connect to BubblaV</strong> and sign in to your BubblaV.com account.
  </Step>

  <Step title="Automatic Setup">
    The connection will be established automatically, and your WooCommerce store will be available to your chatbot.
  </Step>
</Steps>

## Available Tools After Connection

| Tool                                     | What It Does                  | Example Query                                               |
| ---------------------------------------- | ----------------------------- | ----------------------------------------------------------- |
| `woocommerce_track_order`                | Track orders by number/ID     | "Track order #1001"                                         |
| `woocommerce_search_products`            | Search product catalog        | "Show running shoes under \$50"                             |
| `woocommerce_get_product`                | Get product details           | "Tell me about this product"                                |
| `woocommerce_customer_orders`            | Customer order history        | "My orders for [john@example.com](mailto:john@example.com)" |
| `woocommerce_get_categories`             | Browse product categories     | "What categories do you have?"                              |
| `woocommerce_validate_discount_code`     | Check if coupon code is valid | "Is SAVE10 still valid?"                                    |
| `woocommerce_check_product_availability` | Check stock/availability      | "Is the jacket in stock?"                                   |
| `woocommerce_initiate_return`            | Start return request (form)   | "I want to return my order"                                 |
| `woocommerce_create_return`              | Submit return request         | "Return the jacket from order #1001"                        |
| `woocommerce_cancel_order`               | Request order cancellation    | "Cancel my order #1001"                                     |

## Test Your Integration

Try these queries on your website:

* "Track order #1001" (use a real order number)
* "Show me your products"
* "What running shoes do you have?"
* "Check my order status"

## Troubleshooting

<AccordionGroup>
  <Accordion title="Plugin installation fails">
    <ul>
      <li>Verify you have administrator access to your WordPress site</li>
      <li>Check that your hosting provider allows plugin installations</li>
      <li>Ensure sufficient disk space is available</li>
      <li>Check PHP version compatibility (PHP 7.4+ recommended)</li>
    </ul>
  </Accordion>

  <Accordion title="Connection fails">
    <ul>
      <li>Ensure you're signed in to your BubblaV account when connecting</li>
      <li>Check that your WordPress site is accessible from the internet</li>
      <li>Verify that the plugin is properly activated</li>
      <li>Temporarily disable security plugins to test</li>
    </ul>
  </Accordion>

  <Accordion title="Tools not working">
    <ul>
      <li>Wait a few minutes for activation</li>
      <li>Verify your store has orders and products</li>
      <li>Check that the plugin has proper permissions to access WooCommerce data</li>
    </ul>
  </Accordion>

  <Accordion title="WooCommerce data not appearing">
    <ul>
      <li>Ensure WooCommerce is properly installed and activated</li>
      <li>Check that the plugin has access to WooCommerce data in its settings</li>
      <li>Verify that your store has published products and orders</li>
    </ul>
  </Accordion>
</AccordionGroup>

<Info>
  **Security**: The WordPress plugin uses secure API authentication with read-only permissions. Your store data is never modified, and all connections use HTTPS encryption.
</Info>