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

# POS Integration for Product Consultation

> POS Integration for Product Consultation - AI Hive Documentation

# MiPos Integration (Product Search)

The **MiPos** tool allows your AI Agent to access your product database directly on MiPos to search, quote, and send product information to customers during conversations.

***

## Implementation Process

### Step 1: Prepare Data on MiPos

First, ensure you have an account and products on the MiPos system.

1. Register and log in to the MiPos admin page.
2. Create a new **Shop** (Store).
3. Add all products to that Shop (ensure fields like Name, Price, and Images are filled).

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-e2b25c61.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=054f88ad327a69324ea9740865ab40ff" alt="image.png" width="1910" height="945" data-path="images/tools/tools-e2b25c61.png" />

### Step 2: Add MiPos Tool to Agent

Return to the **AIHive Studio** interface to connect.

1. Select the Agent you want to integrate -> Go to the **Configuration** tab.
2. Scroll down to the **Tools / CRM, ERP Integration** section.
3. Click the **+ Add** button.

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-3ecc29af.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=4eac67622b0a466912ecb85e829bf784" alt="image.png" width="2460" height="1392" data-path="images/tools/tools-3ecc29af.png" />

In the list that appears, find and select the **"MiPos Product Search"** tool.

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-9c30097e.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=65509aae46b479761183f3ab61ade36d" alt="image.png" width="937" height="1183" data-path="images/tools/tools-9c30097e.png" />

### Step 3: Configure Connection (API Key)

For the Agent to "communicate" with your Shop, you need to provide the connection key.

1. After adding the tool, click the **Settings icon (⚙️ or ℹ️)** next to the MiPos tool.
2. An input form appears requesting 2 parameters:
   * **API Key:** Security key.
   * **Shop ID:** Store identifier.

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-e78c155a.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=44a2529c460be815aa705451b6ebf1e4" alt="image.png" width="2459" height="1392" data-path="images/tools/tools-e78c155a.png" />

> 💡 How to get this information:
>
> 1. Open the **MiPos** admin page in a new tab.
> 2. Go to **Settings** (or **API Developer** section).
> 3. Copy the `API Key` and `Shop ID`.
> 4. Paste them back into the AIHive Studio configuration form.

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-fd8b5622.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=89a3ddd3aeb35f36ef5a5591b5a61936" alt="image.png" width="2533" height="1408" data-path="images/tools/tools-fd8b5622.png" />

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-7e7984dc.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=5831af18d1077115576ec98e57753400" alt="image.png" width="2555" height="1392" data-path="images/tools/tools-7e7984dc.png" />

Click **Save** to complete the connection.

***

## Test Operation

After saving, verify the integration:

1. Open the Chat Preview.
2. Ask the Bot a query like: *"Find me lipstick"* or *"Show me the price of product X"*.
3. If the Bot returns the correct product cards from your MiPos inventory, you have connected successfully!

<img src="https://mintcdn.com/nhatvk/VlMByXuc5F7xKAo6/images/tools/tools-90d512e0.png?fit=max&auto=format&n=VlMByXuc5F7xKAo6&q=85&s=feb7490859eb1c6e91f54fac5b01e5f2" alt="image.png" width="2453" height="1383" data-path="images/tools/tools-90d512e0.png" />
