Integration with Abicart

Instructions on how to integrate ChatLab with Abicart store

Before you start Abicart integration setup make sure the chatbot is already added to your website.

Overview

The Abicart Integration with our chatbot service allows seamless interaction between your online store and customers via our chatbot. With this integration, customers can:

• Search for products in your Abicart store while chatting with the bot.
• Check order details, such as status and tracking information, when they provide an order identifier.

To use this integration, a Standard or Premium Subscription is required.

How it works?

1. Product Search

The chatbot enables users to search for products available in your Abicart store seamlessly.

When a user enters a search query, the chatbot performs a search against the product titles and descriptions in your catalog.

The search returns the top products based on relevance to the query (configurable, default: 5 products). Each matched product includes the following details:

• ID: The unique identifier of the product.
• Name: The name of the product.
• Price: The product's current price in the configured currency.
• Description: A brief description of the product.
• Store Link: A direct link to the product page in the store.
• Image: A representative image of the product.

This feature helps users quickly find products of interest without needing to navigate the store manually.

2. Order Details

Users can conveniently check the status of their orders by interacting with the chatbot. To fetch order details, the user must provide the order ID and the email address associated with the order.

Both parameters are validated against the Abicart store records, and the order information is returned only if there is a match.

The chatbot retrieves comprehensive details for matched orders including:

• Order Status: The current status of the order (e.g., processing, completed, canceled).
• Total Value: The total monetary value of the order.
• Shipping Information: Delivery details and tracking information.
• Ordered Items: A list of items in the order with quantities and prices.

This feature ensures that users can easily stay updated on their order status and details without needing to log in to the store's dashboard.

Prerequisites

Integration Setup

Step 1: Obtain Abicart API Credentials

To connect your Abicart store with ChatLab, you'll need:

• API Key: Your Abicart API authentication key
• Webshop ID: Your unique Abicart webshop identifier

Please contact Abicart support or check your Abicart admin panel to obtain these credentials.

Step 2: Configure Integration in ChatLab

Login to ChatLab admin console, select the bot and go to Connect tab.

Navigate to 'Abicart' section, enable integration with Abicart by switching it on.

Configure all required parameters:

API Key: Your Abicart API authentication key (obtained from Abicart)

Webshop ID: Your Abicart webshop identifier (numeric value)

Language code: Two-letter lowercase language code (e.g., "en", "sv", "de")

Currency code: Three-letter uppercase currency code (e.g., "EUR", "SEK", "USD")

Number of products to return: How many products should be shown in search results (default: 5)

Step 3: Verify Connection

After filling in all required fields:

1. Click the "Verify" button to test the connection to your Abicart store
2. Wait for verification to complete
3. If successful, you'll see a success message
4. If verification fails, check your API credentials and ensure they are correct

Step 4: Save Configuration

Once verification is successful:

1. Click the "Save" button to store your Abicart integration settings
2. You'll see a confirmation message
3. A modal will appear prompting you to configure actions

Configure Abicart Actions

After enabling the integration, you need to activate and configure the available Abicart actions:

Navigate to Actions Settings

1. Go to Bot Settings → Actions tab
2. Find the Abicart actions section

Available Actions

1. Abicart - articles search

Purpose: Allows the chatbot to search for products in your Abicart store

Configuration:

• Status: Toggle to Active to enable this action
• Action Label: Optional label shown to users when the bot is searching (e.g., "Searching products...")
• Custom Prompt: Customize the AI instruction for when to use this function

2. Abicart - order details

Purpose: Allows the chatbot to fetch order information for customers

Configuration:

• Status: Toggle to Active to enable this action
• Action Label: Optional label shown to users when fetching order info (e.g., "Retrieving order details...")
• Custom Prompt: Customize the AI instruction for when to use this function

Testing Your Integration

After configuration:

1. Open your chatbot widget on your website
2. Try searching for a product: "Show me products related to [keyword]"
3. Try checking an order: "What's the status of my order [order-id]?"
4. Verify that the bot responds with accurate information from your Abicart store

Troubleshooting

Verification Failed:

• Double-check your API Key and Webshop ID
• Ensure your Abicart account has API access enabled
• Verify the language and currency codes are valid for your store

Invalid Language Error:

• The verification will show available languages if you enter an invalid code
• Choose one of the supported languages from the error message

Invalid Currency Error:

• The verification will show available currencies if you enter an invalid code
• Choose one of the supported currencies from the error message

Products Not Showing:

• Ensure the "Abicart - articles search" action is Active
• Check that products exist in your Abicart store
• Verify your language code matches your product data language

Order Details Not Working:

• Ensure the "Abicart - order details" action is Active
• Verify customers are providing both order ID and email address
• Check that the order exists in your Abicart system