​

Overview

The Netcore Unbxd Shopping Assistant, is an AI-driven chatbot integrated into e-commerce websites. It assists customers by understanding their preferences, guiding them in product selection, and offering tailored suggestions based on their interactions with the assistant.

​

Key Features of a Shopping Assistant:

1. Personalized Recommendations: Based on user queries, browsing behavior, and past interactions, the assistant suggests products that the user will likely be interested in.
2. Real-time Interaction: It engages users in real-time conversations, offering immediate answers to questions about products, shipping details, availability, and more.
3. Search Assistance: It helps users refine their search by applying filters (e.g., size, color, brand) or guiding them through a product catalog.
4. Product Discovery: If the user is unsure about what to buy, the assistant offers curated product options, helping users explore a variety of choices.

​

Why is a Shopping Assistant Useful?

1. Improved Customer Experience:

   By offering immediate assistance, personalized product suggestions, and easy navigation, shopping assistants make the shopping process more intuitive and enjoyable for users. This leads to higher customer satisfaction.

2. Increased Conversions and Sales:

   Personalized product recommendations can directly influence purchasing decisions. By presenting the right products at the right time, a shopping assistant can drive higher conversion rates and more sales.

3. 24/7 Availability:

   Unlike human customer support, a shopping assistant is always available, providing instant responses to users’ queries at any time of the day. This is particularly useful for global ecommerce platforms where users might be browsing at different times.

4. Efficient Handling of Queries:

   The assistant can handle a large volume of queries simultaneously, reducing the need for human agents. It can answer repetitive questions like product details, availability, price, and shipping, freeing up customer support staff to focus on more complex issues and so on.

​

Integration of Shopping Assistant to Netcore Unbxd console.

We support the following two methods for integrating the Shopping Assistant: an API-driven approach for more control and flexibility, and a simpler JavaScript (JS) embedding method.

​

API-Driven Implementation

This method allows for greater control and customization of the integration by making API calls from your backend or frontend to interact with the Shopping Assistant.

​

1. Initialize Conversation

Purpose: This API call initiates a new conversation session for a unique user on your website, establishing a context for future interactions.

Endpoint:

GET /v1/sites/{site_key}/conversation?uid={netcoreid}

Parameters:

Example Request:

GET /v1/sites/your_site_key/conversation?uid=user123

Successful Response (200 OK):

{   
"conversation_id": "1672hsuafdguya-1268tebhbsc-978te3hsqw" 
} 

Response Fields:

Possible Error Codes:

​

2. Send Chat Message

Purpose: To send a user’s message to the Shopping Assistant and receive AI-generated responses, product recommendations, and relevant filters.

Endpoint:

POST /v1/sites/{site_key}/conversation/{conversation_id}/chat?uid={uid}
 

Parameters:

Request Body:

{
  "message": "Show me some options for tshirts",
  "filters": [
    {
      "field": "size",
      "options": ["XS"]
    }
  ],
  "metadata": [
    {
      "name": "clicks",
      "value": ["uniqueId of product"]
    },
    {
      "name": "carts",
      "value": ["uniqueId of product"]
    }
  ]
} 

Request Fields:

Successful Response (200 OK):

{
  "message": "Okay, here are some t-shirts in size XS that you might like:",
  "products": [
    {
      "productId": "tshirt123",
      "title": "Classic Cotton Tee",
      "imageUrl": "https://example.com/images/tshirt123.jpg",
      "productUrl": "https://example.com/products/tshirt123",
      "price": 25.99
    },
    {
      "productId": "tshirt456",
      "title": "Premium Soft T-Shirt",
      "imageUrl": "https://example.com/images/tshirt456.jpg",
      "productUrl": "https://example.com/products/tshirt456",
      "price": 39.50
    }
    // ... more products
  ],
  "filters": [
    {
      "field": "color",
      "options": ["Black", "White", "Blue", "Green"]
    },
    {
      "field": "brand",
      "options": ["YourBrand", "AnotherBrand"]
    }
    // ... more filters
  ]
}

Response Fields:

Possible Error Codes:

​

JS Script Embedding Implementation

This method offers a faster and simpler way to integrate the Shopping Assistant by embedding a JavaScript script and a CSS file into your website.

To implement using the JS script, include the following in your website’s <head> or <body>:

HTML:

<link rel="stylesheet" href="https://libraries.unbxdapi.com/unbxd-shopping-assistant.css">

<script src="https://libraries.unbxdapi.com/unbxd-shopping-assistant.js"></script>