Connect your ChatLab chatbot with your PrestaShop store so customers can find products and check their orders directly in the chat. Products are found through AI Search, which searches your indexed PrestaShop catalogue by meaning, or through live store search, which queries the store API.
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.
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 PrestaShop: AI Search and Live Store Search
There are two ways a ChatLab chatbot finds products in a PrestaShop store. A chatbot uses one or the other, never both.
AI Search (recommended) - ChatLab keeps its own index of your PrestaShop 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 PrestaShop 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 PrestaShop 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 PrestaShop search. It searches across product titles and descriptions, returning the top 5 matching products with:
- Product ID, name, and description
- Price (optionally with tax and specific price discounts applied)
- Direct link to the product page in your store
- Product image
Product Search by Reference (SKU) - Customers can look up products using exact reference codes. The chatbot searches across multiple identifier types - reference/SKU, EAN-13 barcode, ISBN, and MPN - on both products and their variants (combinations). This is useful when customers have a specific product code from a catalog, invoice, or packaging.
Order Details - By default, customers provide an order ID and the email address associated with the order. Both are matched against store records; this is not proof of email ownership. The optional Allow order lookup without email verification setting permits order-ID-only lookup. Keep it off unless your deployment has appropriate access controls. The chatbot returns:
- Order reference, date, and current status (e.g., processing, completed, cancelled)
- Order total
- Recipient name, company, full delivery address (street, city, postal code), and phone number
- Carrier name and tracking numbers (multiple tracking numbers supported)
- Ordered items with names, quantities, and individual prices
Prerequisites
Before starting the PrestaShop integration, make sure:
- You have access to your PrestaShop admin panel (back office) and can install modules.
- For the module, you do not need a ChatLab account or chatbot in advance - you can create both while connecting. For the manual setup, create your chatbot in ChatLab first.
Recommended: Connect with the Module
The ChatLab module is the easiest way to connect. It connects your store to a chatbot (product search and order status), creates its own Webservice key and adds the chat widget to your storefront in one go, with no keys to copy.
- Get the module. It is available on PrestaShop Addons, and you can also download it from ChatLab: select your chatbot, open Test & Deploy, click PrestaShop and use Download the ChatLab module (.zip). In your PrestaShop back office, open Modules > Module Manager, click Upload a module and select the
chatlab.zipfile. - Click Configure on the installed ChatLab module, then Connect my store.
- Sign in to ChatLab or create an account, choose a plan if asked, and pick the chatbot for this store or create a new one.
- You are taken back to PrestaShop. The module page confirms that your store is connected and that the AI sales assistant is live on your storefront.
What the module sets up:
- Store connection - the module creates its own Webservice key in your store, so there is nothing to copy. When you disconnect and connect again, it replaces its key instead of adding a second one. Product search and order status are switched on for the chatbot.
- Chat widget - added to your storefront, with a switch on the module page to hide it.
- Catalogue - when AI Search is on for the chatbot, indexing of your catalogue starts by itself.
To disconnect, use Disconnect from ChatLab at the bottom of the module page. Step-by-step screens of the module setup are in How to add chatbot to PrestaShop.
Alternative: Connect with a Webservice Key
If you cannot or do not want to install the module, connect the store yourself with a Webservice key by following Steps 1 to 5 below. Do not create a second connection if the module 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 PrestaShop Store.
Step 1: Enable the Webservice in PrestaShop
- Log in to your PrestaShop back office
- Go to Configure > Advanced Parameters > Webservice
- Scroll down to the Configuration section
- Set Enable PrestaShop's webservice to Yes
- Click Save
Step 2: Create a Webservice Key
- On the same Webservice page, click Add new webservice key
- Click Generate to create a new key
- Enter a description (e.g., "ChatLab Integration")
- Make sure the key is Enabled
- Under resource permissions, grant View (GET) access to the following resources:
addressesattachmentscarrierscategoriescombinationsconfigurationscurrenciescustomersgroupslanguagesorder_carriersorder_detailsorder_statesordersproduct_customization_fieldsproduct_feature_valuesproduct_featuresproduct_option_valuesproduct_optionsproductssearchspecific_price_rulesspecific_pricesstatesshopsstock_availablestagstax_rule_groupstax_rulestaxes
- Click Save
- Copy the generated webservice key - you will need it in the next step
Step 3: Find Your Product URL Format
- In the PrestaShop back office, go to Configure > Shop Parameters > Traffic & SEO
- Scroll down to the Schema of URLs section
- Copy the value from the Route to products field (e.g.,
{category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)
Step 4: Connect PrestaShop in ChatLab
- Log in to ChatLab and select your bot
- Go to the Connect tab
- Click Connect on the PrestaShop tile
- Enter your Webservice key (from Step 2)
- Enter your Shop url (the full URL of your store, e.g.,
https://www.mystore.com) - Enter your Product url format (from Step 3)
- Click Initialize Configuration - this fetches available languages and shops from your store
- Select the correct Default language and, when offered, the intended Prestashop store
- Click Connect
ChatLab automatically tests the connection by verifying that your webservice key has the required access. If successful, you will see a confirmation message.
Step 5: Configure PrestaShop Actions
After connecting, you can enable and customize individual AI actions. Navigate to Settings > Actions and filter by the PrestaShop platform.
The following actions are available:
- Prestashop - product search - enables the chatbot to search your product catalog by name
- Prestashop - search by reference - enables the chatbot to find products by reference/SKU, EAN-13, ISBN, or MPN codes
- Prestashop - order details - enables the chatbot to look up order information
- Prestashop - get product variants - enables the chatbot to retrieve detailed variant information (sizes, colors) for a specific product
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.
When the "Search by reference" action is enabled, the regular product search will also automatically fall back to a reference code search if no results are found by name. This means customers can enter a SKU or barcode in a regular search query and still get accurate results.
Show Products with Restock Date (Pre-order)
When "Products in stock only" is enabled in the Product Search action settings, you can additionally enable "Show products with restock date". This allows the chatbot to include out-of-stock products that have an expected restock date set in PrestaShop. Instead of hiding these products entirely, the chatbot informs the customer about the restock date and that the product is available for pre-order.
Requirements:
- PrestaShop must have "Allow ordering of out-of-stock products" enabled (Shop Parameters > Product Settings)
- The webservice key must have View (GET) access to
combinationsandconfigurationsresources - Products must have an
available_dateset on their combinations in PrestaShop
Tax-Inclusive Prices
Enable the "Apply tax (VAT) to prices" toggle in the Product Search action settings to display prices with tax included. When enabled, ChatLab asks your PrestaShop for the final price a visitor sees, with tax and active discounts applied and rounded to the precision of your shop's default currency. If your shop's webservice does not return final prices, ChatLab calculates them itself from the tax rules of the shop's default country, and a warning about it appears in the PrestaShop integration settings. Compare the result with your storefront. Customer-specific tax rules, location, and checkout adjustments can still produce different totals.
Requirements:
- The webservice key must have View (GET) access to
taxes,tax_rules,tax_rule_groups,configurations,currencies, andgroupsresources
Specific Prices (Discounts and Promotions)
Enable the "Apply specific prices (discounts/promotions)" toggle in the Product Search action settings to display discounted prices from PrestaShop specific price rules. When a discount is active for a product, the chatbot shows both the discounted price and the original price, so customers can see the savings.
This covers universal specific price rules - promotions and sales that apply to all customers with a minimum quantity of 1. Time-limited promotions are also supported; the chatbot only applies discounts that are currently active based on their start and end dates.
Requirements:
- The webservice key must have View (GET) access to
specific_prices,specific_price_rules, andcurrenciesresources
AI Search for PrestaShop: 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 Prestashop - 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 running shoes" (tests product search)
- "I'm looking for product ABC-12345" (tests reference/SKU 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 that the responses match data from your PrestaShop store, that product links open correctly, and that prices include tax and discounts when those options are enabled.
Install Chatbot on Your PrestaShop Store
If you connected with the ChatLab module, the chat widget is already on your storefront. If you connected with a Webservice key, add the widget yourself. See the detailed guide: Installing Chatbot on a PrestaShop Store