> ## 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.

# BigCommerce

> Connect your BigCommerce store for order tracking and product search

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

## Why Connect BigCommerce?

<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 BigCommerce integration enriches the **Visitor Insight** 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 BigCommerce admin for quick management
* **Refunds & Returns**: View refunded amounts and the status of any active return requests

## Prerequisites

* Active BigCommerce store
* Store URL (e.g., `https://yourstore.com` or `yourstore.mybigcommerce.com`)
* BigCommerce API credentials (Access Token and Store Hash)
* Administrator access to your BigCommerce dashboard

## Setup Steps

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Dashboard** → **Integrations** and find the BigCommerce card
  </Step>

  <Step title="Click Connect">
    Click **Connect BigCommerce** to open the connection form
  </Step>

  <Step title="Get Your Store Hash">
    Your Store Hash is part of your BigCommerce store URL:

    <ul>
      <li>If your store URL is <code>[https://store-abc123.mybigcommerce.com](https://store-abc123.mybigcommerce.com)</code>, your store hash is <code>store-abc123</code></li>
      <li>You can also find it in your BigCommerce admin under <strong>Advanced Settings</strong> → <strong>API Accounts</strong></li>
    </ul>
  </Step>

  <Step title="Generate API Credentials">
    Create API credentials in your BigCommerce admin:

    <ol>
      <li>Go to <strong>Advanced Settings</strong> → <strong>API Accounts</strong></li>
      <li>Click <strong>Create API Account</strong></li>
      <li>Enter a name (e.g., "BubblaV Integration")</li>
      <li>Set the <strong>OAuth Scopes</strong> to include:</li>

      <li>
        <ul>
          <li>Products: Read Only</li>
          <li>Orders: Read Only</li>
          <li>Customers: Read Only</li>
        </ul>
      </li>

      <li>Click <strong>Save</strong></li>
      <li>Copy the <strong>Access Token</strong> (shown only once)</li>
    </ol>
  </Step>

  <Step title="Enter Credentials">
    Enter your Store URL, Store Hash, and Access Token in the connection form
  </Step>

  <Step title="Verify Connection">
    Click <strong>Connect</strong>. The BigCommerce card should now show **Connected**
  </Step>
</Steps>

## Available Tools After Connection

| Tool                          | What It Does              | Example Query                                               |
| ----------------------------- | ------------------------- | ----------------------------------------------------------- |
| `bigcommerce_track_order`     | Track orders by number/ID | "Track order #1001"                                         |
| `bigcommerce_search_products` | Search product catalog    | "Show running shoes under \$50"                             |
| `bigcommerce_get_product`     | Get product details       | "Tell me about this product"                                |
| `bigcommerce_customer_orders` | Customer order history    | "My orders for [john@example.com](mailto:john@example.com)" |

## 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="Invalid API credentials">
    <ul>
      <li>Verify that the Access Token is correct and not expired</li>
      <li>Ensure the API account has the correct OAuth scopes</li>
      <li>Check that you copied the entire Access Token</li>
    </ul>
  </Accordion>

  <Accordion title="Connection fails">
    <ul>
      <li>Verify your Store URL and Store Hash are correct</li>
      <li>Check that your store is accessible</li>
      <li>Ensure your API account is active</li>
    </ul>
  </Accordion>

  <Accordion title="Store Hash not found">
    <ul>
      <li>Your Store Hash is the subdomain part of your BigCommerce URL</li>
      <li>For <code>[https://store-abc123.mybigcommerce.com](https://store-abc123.mybigcommerce.com)</code>, the hash is <code>store-abc123</code></li>
      <li>If using a custom domain, find the hash in Advanced Settings → API Accounts</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 API account still has valid permissions</li>
    </ul>
  </Accordion>
</AccordionGroup>

<Info>
  **Security**: We use OAuth 2.0 authentication with HTTPS. Your credentials are encrypted and stored securely. We only request read permissions to access your store data.
</Info>

<Warning>
  **Important**: Save your Access Token securely when you create it. BigCommerce only shows it once and you'll need to regenerate it if lost.
</Warning>