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

# Zoho Commerce

> Connect your Zoho Commerce store for order tracking and product search

Turn your chatbot into an e-commerce assistant for your Zoho Commerce store. Customers can track orders, search products, and get instant answers about stock availability — around the clock.

## Why Connect Zoho Commerce?

<CardGroup cols={2}>
  <Card title="Order Tracking" icon="truck">
    Customers check order status and shipment tracking using their order number and email
  </Card>

  <Card title="Product Search" icon="magnifying-glass">
    Natural-language product discovery across your active catalog
  </Card>

  <Card title="Stock Availability" icon="box">
    Real-time inventory answers so shoppers know before they buy
  </Card>

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

## Prerequisites

* Active Zoho Commerce store with admin access
* A Zoho account (US, EU, India, Australia, or Japan data center — all supported)

## Setup Steps

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

  <Step title="Click Connect">
    Click **Connect**. You'll be redirected to Zoho to authorize the connection
  </Step>

  <Step title="Sign in to Zoho">
    Sign in with the Zoho account that owns your Zoho Commerce store
  </Step>

  <Step title="Accept Permissions">
    Accept the requested read-only permissions (products, sales orders, store discovery). BubblaV only ever reads your store data
  </Step>

  <Step title="Verify Connection">
    You'll land back on the Zoho Commerce configuration page and the card should show **Connected**
  </Step>

  <Step title="Add the Chat Widget to Your Storefront">
    For the chatbot to talk to your customers, embed the BubblaV widget:

    <ol>
      <li>Open your Zoho Commerce admin</li>
      <li>Go to <strong>Online Store</strong> → <strong>Settings</strong> → <strong>Code</strong></li>
      <li>Paste your BubblaV widget snippet into the <strong>Footer Code</strong> section</li>
      <li>Click <strong>Save</strong></li>
    </ol>
  </Step>
</Steps>

## Available Tools After Connection

| Tool                            | What It Does                         | Example Query                                               |
| ------------------------------- | ------------------------------------ | ----------------------------------------------------------- |
| `zoho_commerce_track_order`     | Track orders by order number + email | "Where is my order SO-00012?"                               |
| `zoho_commerce_search_products` | Search product catalog               | "Show running shoes under \$50"                             |
| `zoho_commerce_get_product`     | Get product details                  | "Tell me more about product #3"                             |
| `zoho_commerce_customer_orders` | Customer order history by email      | "My orders for [john@example.com](mailto:john@example.com)" |

## Test Your Integration

Try these queries on your website:

* "Where is my order SO-00012?" (use a real order number and the customer's email)
* "Show me your products"
* "Do you have this in stock?"
* "What did I order last time?"

## Troubleshooting

<AccordionGroup>
  <Accordion title="Reconnect required">
    If you revoked BubblaV's access from your Zoho account (or Zoho invalidated the grant), the chatbot will stop answering store questions. Click **Connect** again on the Zoho Commerce card to re-authorize — no data is lost.
  </Accordion>

  <Accordion title="Multiple Zoho stores">
    If your Zoho account has more than one Zoho Commerce store, BubblaV connects to the first active store. Make sure the store you want connected is the active one, then reconnect.
  </Accordion>

  <Accordion title="Orders not found">
    <ul>
      <li>Order lookups require both the order number and the customer's email — both must match</li>
      <li>Verify the order exists in the connected store (check for multiple stores, above)</li>
    </ul>
  </Accordion>

  <Accordion title="Products not showing">
    <ul>
      <li>Only products with an active status are searchable</li>
      <li>Wait a few minutes after connecting for tools to activate</li>
    </ul>
  </Accordion>

  <Accordion title="Tools not working">
    <ul>
      <li>Confirm the integration shows **Connected** in your dashboard</li>
      <li>Check that your store has products and orders</li>
    </ul>
  </Accordion>

  <Accordion title="Sign-in fails with a 'user not found' style error">
    Your Zoho account lives on a different data center (EU, India, Australia, or Japan). Start the connection again with the region parameter appended to the connect link: <code>\&dc=eu</code> (or <code>in</code>, <code>au</code>, <code>jp</code>). BubblaV then routes Zoho sign-in through your regional accounts server and automatically calls the matching store API endpoints afterwards.
  </Accordion>
</AccordionGroup>

<Info>
  **Security**: We use OAuth 2.0 with read-only scopes (`ZohoCommerce.items.READ`, `ZohoCommerce.salesorders.READ`, `ZohoCommerce.sitesIndex.READ`). Your credentials are encrypted and stored securely — BubblaV can never modify your store.
</Info>