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

# Haravan

> Add your AI chatbot to Haravan stores with one-click installation—no coding required

Connect your Haravan store to BubblaV and instantly deploy an AI-powered chatbot that provides 24/7 customer support—all without touching a single line of code.

## Why Connect Haravan?

<CardGroup cols={2}>
  <Card title="One-Click Install" icon="bolt">
    No coding required. Simply authorize and the chatbot is automatically added to your store.
  </Card>

  <Card title="Instant Setup" icon="clock">
    Go from zero to live chatbot in under 2 minutes
  </Card>

  <Card title="Automatic Updates" icon="refresh">
    Chatbot updates automatically whenever you change your settings in the dashboard
  </Card>

  <Card title="24/7 Support" icon="headset">
    Provide instant answers to your customers around the clock
  </Card>
</CardGroup>

## Prerequisites

* Active Haravan store
* Store owner or admin permissions

## Setup Steps

Installing BubblaV on your Haravan store is quick and simple with OAuth authorization.

<Steps>
  <Step title="Install from Haravan App Store">
    Go to the [BubblaV Haravan App listing](https://apps.haravan.com/products/bubblav) and click **Install app**.
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to the Haravan authorization page. Review the permissions requested and click **Yes** to approve the installation.

    <Frame>
      <img src="https://mintcdn.com/bubblav-e553cf80/R3ckwS1UlR0o66Bf/images/haravan/oauth.png?fit=max&auto=format&n=R3ckwS1UlR0o66Bf&q=85&s=facfbfd4d2317e8a7936ade809d027ec" alt="Haravan OAuth Authorization Dialog" width="424" height="562" data-path="images/haravan/oauth.png" />
    </Frame>

    This dialog confirms that BubblaV will be granted permission to add the chatbot to your store.
  </Step>

  <Step title="Verify Connection">
    After clicking **Yes**, you'll be redirected back to your BubblaV dashboard. The Haravan card should now show **Connected**, and your chatbot is live on your store.
  </Step>
</Steps>

<Info>
  **No Code Changes Needed**: The integration automatically injects the chatbot script into your Haravan store. You don't need to edit any theme files or add code manually.
</Info>

***

## What the Chatbot Can Do

Once connected, the chatbot can answer customer questions using your live store data:

<CardGroup cols={2}>
  <Card title="Smart Product Search" icon="search">
    Customers describe what they want ("vòng tay bạc dưới 2 triệu", "quà tặng cho mẹ") and the chatbot searches your catalog with price, availability, size/color and brand filters — then shows product cards with images and prices in VND.
  </Card>

  <Card title="Add to Cart" icon="shopping-cart">
    Product cards include an **Add** button. On your storefront, items go straight into the customer's cart; from other sites, a new tab opens with the items pre-added.
  </Card>

  <Card title="Order Tracking" icon="package">
    Customers track an order with its number plus the email or phone used at checkout, and get a status card with payment state, delivery tracking and a buy-again button.
  </Card>

  <Card title="Order History" icon="history">
    Returning customers can list their past orders by email or phone number.
  </Card>
</CardGroup>

<Info>
  **Always Connected**: Haravan access tokens refresh automatically — your
  chatbot keeps working without periodic reconnections. (Stores connected
  before August 2026 may be asked to reconnect once when their token expires.)
</Info>

***

## Available Tools After Connection

| Tool | What It Does | Example Query |
| - | - | - |
| `haravan_track_order` | Track orders by number/ID | "Kiểm tra đơn hàng #1025" / "Track order #1025" |
| `haravan_search_products` | Advanced product search with filters (price range, availability, size/color variants, brand, sort) | "Vòng tay bạc dưới 2 triệu" / "Silver bracelet under 2 million VND" |
| `haravan_get_product` | Get full product details (complete description, specs, variants, stock) | "Gửi thông số thang gấp 604" / "Tell me more about product #1" |
| `haravan_customer_orders` | Customer order history | "Cho tôi xem các đơn hàng của email này" / "My orders for [john@example.com](mailto:john@example.com)" |
| `haravan_initiate_return` | Start a return request | "Tôi muốn trả hàng" / "I want to return my order" |
| `haravan_create_return` | Process return authorization | "Xử lý trả hàng giúp tôi" / "Process my return" |
| `haravan_validate_discount_code` | Validate promo codes | "Mã SUMMER25 còn hiệu lực không?" / "Is code SUMMER25 valid?" |

## Test Your Integration

Visit your Haravan store and open the chatbot widget. Try asking:

* "What are your business hours?"
* "Show me charm bracelets under 2 million" (product search)
* "Gửi thông số \[product]" (full product specs via product details)
* "Where is my order #1025?" with the email used at checkout (order tracking)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization fails">
    * Ensure you have store admin permissions
    * Clear browser cache and try again
    * Verify your store URL is correct
  </Accordion>

  <Accordion title="Chatbot not appearing on store">
    * Wait a few minutes for the script injection to complete
    * Clear your browser cache and reload the store page
    * Check that the connection status shows **Connected** in your dashboard
  </Accordion>

  <Accordion title="Chatbot asks to reconnect">
    * Your Haravan session expired; click **Reconnect** on the Haravan integration card
    * This is expected at most once for stores connected before August 2026
  </Accordion>
</AccordionGroup>

<Info>
  **Security**: We only request the minimum permissions needed to add the chatbot to your store. Your store data remains secure.
</Info>


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