Integration with PrestaShop

Connect your ChatLab chatbot with your PrestaShop store to give customers real-time access to product information and order tracking directly in the chat.

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

What the Integration Provides

Product Search -- Customers can search your PrestaShop catalog by entering a phrase. The chatbot 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 -- Customers can check their order status by providing an order ID and the email address associated with the order. Both values are validated against your PrestaShop store records. 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:

• Your chatbot is already added to your PrestaShop store -- see Installing Chatbot on a PrestaShop Store
• You have access to your PrestaShop admin panel (back office)

Step 1: Enable the Webservice in PrestaShop

1. Log in to your PrestaShop back office
2. Go to Configure > Advanced Parameters > Webservice

3. Scroll down to the Configuration section
4. Set Enable PrestaShop's webservice to Yes
5. Click Save

Step 2: Create a Webservice Key

1. On the same Webservice page, click Add new webservice key

2. Click Generate to create a new key
3. Enter a description (e.g., "ChatLab Integration")
4. Make sure the key is Enabled
5. Under resource permissions, grant View (GET) access to the following resources:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • states
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Click Save
7. Copy the generated webservice key -- you will need it in the next step

Step 3: Find Your Product URL Format

1. In the PrestaShop back office, go to Configure > Shop Parameters > Traffic & SEO

2. Scroll down to the Schema of URLs section
3. 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

1. Log in to ChatLab and select your bot
2. Go to the Connect tab

3. Click Connect on the PrestaShop tile
4. Enter your Webservice key (from Step 2)
5. Enter your Shop url (the full URL of your store, e.g., https://www.mystore.com)
6. Enter your Product url format (from Step 3)

7. Click Initialize Configuration -- this fetches available languages from your store
8. Select the correct Default language from the dropdown
9. 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

Click the activate button on each action to enable it. 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 combinations and configurations resources
• Products must have an available_date set 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, the chatbot calculates prices using tax rules from your PrestaShop store based on the shop's default country. This ensures that the prices customers see in the chat match what they see on your storefront.

Requirements:

• The webservice key must have View (GET) access to taxes, tax_rules, tax_rule_groups, and configurations resources

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 and specific_price_rules resources

Testing Your Integration

After activating the actions, open your chatbot widget 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)

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

To add the chat widget to your PrestaShop storefront, see the detailed guide: Installing Chatbot on a PrestaShop Store