Connect your ChatLab chatbot with your CS-Cart store so customers can find products and check their orders directly in the chat. Products are found through AI Search, which searches your indexed CS-Cart catalogue by meaning, or through live store search, which queries the store API. The fastest way to connect is the ChatLab add-on for CS-Cart, which also adds the chat widget to your storefront. Connecting by hand with an API key remains available as an alternative.
Example conversation
Check an order
Requires a connected store and its enabled order action. Available fields depend on the integration. Matching an email address is not proof of identity.
Visitor: Where is my order?
Play the example or read it below. No real customer data is used.The customer asks about an existing order.
Playback pauses when this example leaves the screen. This is a simulation, not a live chat. Widget controls inside the playback are not interactive.Read the complete example
- The customer asks about an existing order.
Visitor: Where is my order?
- The default lookup needs both identifiers.
Assistant: Please give me your order number and the email address used at checkout.
- Use fictional data in this example.
Visitor: 41982, anna@example.com
- The action queries the connected store.
Checking order 41982...
- Report only information returned by the store.
Assistant: Order 41982 is marked as shipped. The carrier is DPD. Please check the tracking page for delivery updates.
The example illustrates the customer experience. The available actions and returned information depend on this integration and your configuration.
Before you start
Create or select a chatbot first. You need permission to manage its integrations and access to the external account's connection settings. If the Connect tile shows an upgrade or contact prompt, check that your subscription includes this integration. Keep API credentials private; never paste them into website embed code.
For the add-on you need CS-Cart 4.18.1 or newer and a CS-Cart administrator account that is allowed to install add-ons and to manage administrators and user groups. The add-on is built for the standard CS-Cart edition, not for Multi-Vendor.
Important: E-Commerce Best Practices
After completing the integration below, read the comprehensive guide on optimizing your chatbot for e-commerce: How to set up ChatLab for your E-commerce store
How the Chatbot Finds Products on CS-Cart: AI Search and Live Store Search
There are two ways a ChatLab chatbot finds products in a CS-Cart store. A chatbot uses one or the other, never both.
AI Search (recommended) - ChatLab keeps its own index of your CS-Cart catalogue and the chatbot searches it by meaning.
- Customers ask in plain language, for example "a red dress under 300". A price range is applied as a strict filter, and exact product codes (SKU, EAN) are matched too.
- Price, stock and variants are read live from CS-Cart at the moment of answering, so customers see current data even between index refreshes.
- Results appear as product cards in the chat, up to 5 per answer.
- Indexing starts by itself when the store is connected. The catalogue does not use training characters.
- Plan you need: every E-commerce plan includes it (Free 100 products, Start 2,000, Grow 5,000, Scale 20,000). On a Universal plan, add the E-commerce integrations add-on ($30 a month) plus an AI Search product pack ($29 a month, 5,000 products) assigned to the chatbot.
Live store search - the chatbot passes the customer's phrase to the CS-Cart search through the store API and answers with what the store returns.
- Nothing is indexed and nothing has to be kept in sync. The data is always live.
- It is a keyword search: it finds what your store's own search would find for that phrase. It does not understand descriptions of a need, synonyms or typos the way AI Search does.
- Plan you need: a Universal plan with the E-commerce integrations add-on ($30 a month). No product pack is needed.
When AI Search is on, it replaces live store search. Order status works the same way on both paths. A third option, training on scanned store pages, is available on any plan and is meant for informational content such as delivery and returns, not for products. For a full comparison see AI Search: how your chatbot finds products, and for product limits see E-commerce plans and limits.
What the Integration Provides
Live store search (product search by phrase) - The chatbot sends the customer's phrase to the CS-Cart search and returns matching products with:
- Product name and description
- Price
- SKU (product code)
- Direct link to the product in your store
- Product image
- Available variants (sizes, colors, etc.)
You can configure which product fields are searched (name, short description, full description, keywords) and how many results to return.
Order Details - Customers can check order status by providing their order ID and email address. The chatbot returns:
- Order status
- Ordered items with names, prices, quantities, product images, and chosen variants
- Order total and shipping cost
- Shipping carrier, tracking number, and shipment status
- Recipient name and full delivery address
- Customer phone
Recommended: Connect with the ChatLab Add-on
The ChatLab add-on for CS-Cart is the easiest way to connect. An add-on is an extension you install in your CS-Cart administration panel. This one connects your store to your chatbot (product search and order status) and adds the chat widget to your storefront in one go, with no keys to copy. You download it from ChatLab as a .tgz file and upload it to your store.
Download the add-on
Select your chatbot and navigate to Test & Deploy. In the Deploy section, expand Online store platforms and click CS-Cart. The Plugin Installation tab is selected by default. Click Download the ChatLab add-on (.tgz).
Your browser saves the add-on as chatlab.tgz. Do not unpack it - CS-Cart needs the archive itself. The button always delivers the current version of the add-on (1.0.2 at the time of writing).
The same download button is available in two other places:
- Connect tab - click Connect on the CS-Cart tile. The CS-Cart Integration dialog opens with the add-on instructions and the Download the ChatLab add-on (.tgz) button. On an E-commerce plan, the same tile is also on the Shop tab under Connect your store.
- Setup wizard - when you create a chatbot and pick CS-Cart as your platform, the Connect CS-Cart step shows the Plugin or app method with the same Download the ChatLab add-on (.tgz) link.
Install the add-on in CS-Cart
- Log in to your CS-Cart administration panel.
- Navigate to Add-ons > Downloaded add-ons.
- Open the gear menu and choose Manual installation.
- Upload the
chatlab.tgzfile you downloaded. CS-Cart installs the add-on.
Connect your store
- In your CS-Cart administration panel, navigate to Marketing > ChatLab AI Chatbot.
- Click Continue. A new browser tab opens with ChatLab.
- Sign in with your ChatLab account, or create one, and choose the chatbot for this store when asked.
- You are redirected back to CS-Cart automatically. The page now shows ChatLab is connected, your ChatLab account, the chatbot name and a Live preview of the chatbot.
- Open your storefront and send a test message. To check store data, also ask about a product and about an order you can verify in the administration panel.
If you started in the ChatLab setup wizard, go back to that browser tab. It shows Waiting for the connection... and continues on its own once the store is connected.
If CS-Cart reports that the connection request is invalid or has expired, your CS-Cart session ended while you were signing in to ChatLab. Open Marketing > ChatLab AI Chatbot again and click Continue once more.
What the add-on sets up
- Store connection - the add-on creates a dedicated read-only API user in your store. The user belongs to a user group named ChatLab API and can only view the catalog, orders, languages and order statuses. Your own administrator API key is not changed. Product search and order details are enabled for the chatbot automatically.
- Chat widget - the widget is added to every storefront page, with no code to paste. If your store uses the cookie consent of the CS-Cart GDPR add-on, the widget is listed there as a functional service and follows each visitor's choice.
- Catalog language - from version 1.0.2, the add-on sends the default language of your storefront, so the chatbot reads product names, descriptions and categories in the language your customers see. ChatLab shows it as Shop Language in the CS-Cart Integration dialog. A language you already chose yourself for this store is kept.
- Store currency - from version 1.0.2, the add-on also sends the primary currency of your store, so prices in the chat carry the right currency. ChatLab shows it as Shop currency in the same dialog, marked Sent by the ChatLab add-on. A currency you set by hand is kept.
To review these settings in ChatLab, select your chatbot, open the Connect tab and click Modify on the CS-Cart tile. When AI Search is on for the chatbot, indexing of your catalogue starts by itself after the store connects.
The CS-Cart store connection is available as a premium feature. If your plan does not include it, the add-on still adds the chat widget to your storefront, but product search and order status stay off until you upgrade.
If you pasted the ChatLab widget code into your theme earlier, shoppers see two chat widgets. The add-on page warns you with A ChatLab widget is already on your storefront. Remove the code from your theme, or untick Show the chat widget on the storefront in the Storefront widget section and click Save.
Update from an earlier version
Versions older than 1.0.2 do not send the catalog language and the store currency. To update:
- Download the current add-on from ChatLab as described above.
- In your CS-Cart administration panel, navigate to Add-ons > Downloaded add-ons, choose Manual installation from the gear menu, upload the new
chatlab.tgzand click Upload & install. - CS-Cart sees that the add-on is already installed and asks how to replace it. Click Use the safe way: CS-Cart uninstalls the old version and installs the new one. The add-on settings in CS-Cart are removed, so the store is no longer connected.
- Open Marketing > ChatLab AI Chatbot, click Continue, sign in to ChatLab and choose the same chatbot again. The add-on sends the catalog language and the store currency at this moment.
Your ChatLab account, the chatbot and its conversations stay in place when you disconnect and connect again. Instead of reconnecting, you can also set Shop Language and the currency yourself in the CS-Cart Integration dialog in ChatLab.
Turn off the widget, disconnect or uninstall
- Hide the widget only - on Marketing > ChatLab AI Chatbot, untick Show the chat widget on the storefront and click Save. The store stays connected.
- Disconnect the store - on the same page, click Disconnect and confirm. The chatbot stops appearing on your storefront, the store connection is turned off for the chatbot and the API key of the read-only user is revoked. Your ChatLab account and chatbot data remain available in ChatLab.
- Uninstall the add-on - uninstall ChatLab in Add-ons > Downloaded add-ons. This also removes the read-only API user and its user group from your store.
- Disconnect in ChatLab - open the Connect tab, click Modify on the CS-Cart tile and click Disconnect. This turns off product search and order status on the ChatLab side only. To remove the widget from your storefront as well, disconnect in CS-Cart.
Alternative: Connect with an API Key
If you cannot or do not want to install the add-on, connect the store yourself with a CS-Cart API key by following Steps 1 to 3 below. Do not create a second connection if the add-on has already connected the store. With this method the chat widget is not added to your storefront automatically - add it yourself as described in Install Chatbot on Your CS-Cart Store at the end of this article.
Step 1: Enable API Access in CS-Cart
- Log in to your CS-Cart administration panel
- Navigate to Customers > Administrators
- Click on the administrator account that will be used for the API connection
- Switch to the API access tab
- Check "Yes, allow this user to use the API"
- Click Save
- Copy the API key displayed after saving - store it securely
- Note the email address associated with this administrator account
Step 2: Connect CS-Cart in ChatLab
- Log in to ChatLab and select your chatbot
- Go to the Connect tab and click Connect on the CS-Cart tile
- The CS-Cart Integration dialog first suggests the add-on. Click Continue manual setup to open the connection form
- Enter your API Key (from Step 1)
- Enter your CS-Cart Account Email (the administrator email with API access)
- Enter your CS-Cart Shop URL (e.g.,
https://yourstore.com) - Under Shop Language, click Load languages and choose the language of your product catalog. This is required when your store has more than one language. Product names, descriptions and categories are read from your store in this language, and changing it later re-indexes the whole product catalog
You can also configure search options:
- Searchable fields - toggle which product fields the chatbot searches through (CS-Cart Product name, CS-Cart Short description, CS-Cart Full description, CS-Cart Keywords)
- Number of search results - how many products to return per query (default: 5)
- Click Connect
After a successful connection, you will see a confirmation message with the option to configure AI actions. When you reopen the dialog later with Modify, it also shows Shop currency, the currency read from your store. If it is missing or wrong, click Set the currency manually and enter the three-letter currency code, for example EUR.
Step 3: Configure CS-Cart Actions
After connecting, enable and customize individual AI actions. Navigate to Settings > Actions and filter by the CsCart platform.
The standard actions include:
- CsCart - product search - enables the chatbot to search your product catalog
- CsCart - order details - enables the chatbot to look up order information
Connection setup enables the standard actions. Review their status and disable any you do not want customers to use. Open an action to edit it, then use Enable or Update in its dialog. You can also customize the action label (the message shown to users while the action runs) and the instructions that guide how the AI uses each action.
AI Search for CS-Cart: Catalogue, Re-indexing and Settings
On an E-commerce plan, or on a Universal plan when an AI Search product pack is assigned to the chatbot, AI Search is on and replaces live store search. Indexing starts by itself when the store is connected.
- Check the catalogue - open Training > E-commerce catalog and review the Products and Categories tabs. Shop > Products shows the Product catalog panel and the AI Search packs on this chatbot card.
- Schedule re-indexing - use Schedule auto-retrain in Training > E-commerce catalog. Re-indexing can run as often as daily and is available on every E-commerce plan and with every product pack. Train now or Retrain runs it on demand. Refreshes are incremental: unchanged products are skipped and removed products are deleted from the index.
- Review the action - in Settings > Actions, open CsCart - AI product search. Its options are Include product card, Products in stock only and Number of products to return.
- Show product cards - turn on Enable Offer Cards in Settings > Model & Advanced. See Offer Cards.
When the catalogue is bigger than the product limit, indexing stops at the limit and the chatbot owner gets an e-mail. Options of the live store search action described above do not necessarily apply to AI Search.
Testing Your Integration
After activating the actions, open Test & Deploy and try:
- "Show me training gloves" (tests product search)
- "What's the status of my order 12345?" (tests order details; supply the matching email for an order you are authorized to access)
Verify the responses match data from your CS-Cart store.
Tips for Search Configuration
- Enable Product name and Short description for best balance of speed and accuracy
- Add Keywords if your products have rich keyword metadata
- Only enable Full description if shorter fields don't return good results - it may slow down searches
- Start with 5 results per query and adjust based on your catalog size
Install Chatbot on Your CS-Cart Store
If you connected with the add-on, skip this section - the widget is already on your storefront. If you connected with an API key, add the chat widget to your CS-Cart storefront yourself:
- In ChatLab, go to the Test & Deploy tab for your chatbot
- Expand Online store platforms, click CS-Cart and open the Manual Installation tab
- Click Copy to clipboard to copy the code snippet
- In your CS-Cart admin, go to Design > Layouts
- Add an HTML block in the default layout and paste the widget snippet into its Content tab
- Save the block and layout changes. Check pages with separate layouts, such as checkout, and all storefront languages
If you use an HTML block with Smarty support, wrap the snippet in {literal} and {/literal}. See CS-Cart's custom-code instructions. Open the published storefront and check the widget on desktop and mobile.
The code only shows the chat widget. Product search and order status come from the store connection: the add-on, or the API key connection on the Connect tab.