Helpcentrum
Chatbot-integraties

Integratie met PrestaShop

Laatst bijgewerkt:

Verbind je ChatLab-chatbot met je PrestaShop-winkel om klanten direct in de chat realtime toegang te geven tot productinformatie en het volgen van bestellingen.

Belangrijk: Best practices voor E-Commerce

Lees na het afronden van de onderstaande integratie de uitgebreide handleiding over het optimaliseren van je chatbot voor e-commerce: ChatLab instellen voor je e-commercewinkel

Wat de integratie biedt

Product Search - Klanten kunnen je PrestaShop-catalogus doorzoeken door een zoekterm in te voeren. De chatbot zoekt in producttitels en beschrijvingen en toont de beste 5 overeenkomende producten met:

  • Product-ID, naam en beschrijving
  • Prijs (optioneel inclusief btw en toegepaste specifieke prijskortingen)
  • Directe link naar de productpagina in je winkel
  • Productafbeelding

Product Search by Reference (SKU) - Klanten kunnen producten opzoeken met behulp van exacte referentiecodes. De chatbot zoekt naar meerdere typen identificatiecodes - referentie/SKU, EAN-13-barcode, ISBN en MPN - op zowel producten als hun varianten (combinaties). Dit is handig wanneer klanten een specifieke productcode uit een catalogus, factuur of verpakking hebben.

Order Details - Klanten kunnen hun bestelstatus controleren door een bestel-ID en het aan de bestelling gekoppelde e-mailadres op te geven. Beide waarden worden gevalideerd aan de hand van de gegevens in je PrestaShop-winkel. De chatbot toont:

  • Bestelreferentie, datum en huidige status (bijv. in behandeling, voltooid, geannuleerd)
  • Totaalbedrag van de bestelling
  • Naam van de ontvanger, bedrijf, volledig afleveradres (straat, stad, postcode) en telefoonnummer
  • Naam van de vervoerder en trackingnummers (meerdere trackingnummers worden ondersteund)
  • Bestelde artikelen met namen, aantallen en individuele prijzen

Vereisten

Controleer voordat je begint met de PrestaShop-integratie het volgende:

Stap 1: Schakel de webservice in PrestaShop in

  1. Log in op je PrestaShop-backoffice
  2. Ga naar Configure > Advanced Parameters > Webservice (Configureren > Geavanceerde parameters > Webservice)

PrestaShop-beheerdersmenu met de opties Geavanceerde parameters en Webservice|width=25

  1. Scrol omlaag naar het gedeelte Configuration (Configuratie)
  2. Zet Enable PrestaShop's webservice (PrestaShop-webservice inschakelen) op Yes (Ja)
  3. Klik op Save (Opslaan)

Configuratiegedeelte met de schakelaar PrestaShop-webservice inschakelen en de knop Opslaan

Stap 2: Maak een webservicesleutel aan

  1. Klik op dezelfde Webservice-pagina op Add new webservice key (Nieuwe webservicesleutel toevoegen)

Webservice-pagina met de knop Nieuwe webservicesleutel toevoegen|width=50

  1. Klik op Generate (Genereren) om een nieuwe sleutel aan te maken
  2. Voer een beschrijving in (bijv. "ChatLab Integration")
  3. Zorg ervoor dat de sleutel op Enabled (Ingeschakeld) staat
  4. Geef onder bronmachtigingen View (GET)-toegang tot de volgende bronnen:
    • 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

Configuratie van de webservicesleutel met de knop Genereren, beschrijving en View GET-machtigingen

  1. Klik op Save (Opslaan)
  2. Kopieer de gegenereerde webservicesleutel - je hebt deze nodig in de volgende stap

Stap 3: Zoek het formaat van je product-URL

  1. Ga in de PrestaShop-backoffice naar Configure > Shop Parameters > Traffic & SEO (Configureren > Winkelparameters > Verkeer & SEO)

PrestaShop-beheerdersmenu met de opties Winkelparameters en Verkeer & SEO|width=25

  1. Scrol omlaag naar het gedeelte Schema of URLs (Schema van URL's)
  2. Kopieer de waarde uit het veld Route to products (Route naar producten) (bijv. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Gedeelte Schema van URL's met het veld Route naar producten

Stap 4: Verbind PrestaShop in ChatLab

  1. Log in op ChatLab en selecteer je bot
  2. Ga naar het tabblad Connect (Verbinden)

Tabblad Verbinden met de PrestaShop-integratietegel

  1. Klik op Connect (Verbinden) op de PrestaShop-tegel
  2. Voer je Webservice key (webservicesleutel uit stap 2) in
  3. Voer je Shop url in (de volledige URL van je winkel, bijv. https://www.mystore.com)
  4. Voer je Product url format (product-URL-formaat uit stap 3) in

PrestaShop-integratieformulier met webservicesleutel, winkel-URL, product-URL-formaat en standaardtaal

  1. Klik op Initialize Configuration (Configuratie initialiseren) - hiermee worden de beschikbare talen uit je winkel opgehaald
  2. Selecteer de juiste Default language (standaardtaal) in het keuzemenu
  3. Klik op Connect (Verbinden)

ChatLab test de verbinding automatisch door te controleren of je webservicesleutel over de vereiste toegangsrechten beschikt. Als dit is gelukt, zie je een bevestigingsbericht.

Stap 5: Configureer PrestaShop-acties

Na het verbinden kun je individuele AI-acties inschakelen en aanpassen. Navigeer naar Settings > Actions (Instellingen > Acties) en filter op het PrestaShop-platform.

PrestaShop-acties in Instellingen met productzoekfunctie en bestelgegevens

De volgende acties zijn beschikbaar:

  • Prestashop - product search - stelt de chatbot in staat om je productcatalogus op naam te doorzoeken
  • Prestashop - search by reference - stelt de chatbot in staat om producten te vinden op referentie/SKU, EAN-13, ISBN of MPN-codes
  • Prestashop - order details - stelt de chatbot in staat om bestelgegevens op te zoeken
  • Prestashop - get product variants - stelt de chatbot in staat om gedetailleerde variantinformatie (maten, kleuren) voor een specifiek product op te halen

Klik op de activeringsknop bij elke actie om deze in te schakelen. Je kunt ook het actielabel aanpassen (het bericht dat aan gebruikers wordt getoond terwijl de actie wordt uitgevoerd) en de instructies wijzigen die bepalen hoe de AI elke actie gebruikt.

Wanneer de actie "Search by reference" is ingeschakeld, valt de reguliere productzoekfunctie automatisch terug op een zoekopdracht naar referentiecodes als er geen resultaten op naam worden gevonden. Dit betekent dat klanten een SKU of barcode in een normale zoekopdracht kunnen invoeren en toch nauwkeurige resultaten krijgen.

Toon producten met datum voor nieuwe voorraad (Pre-order)

Wanneer "Products in stock only" is ingeschakeld in de actie-instellingen van Product Search, kun je daarnaast "Show products with restock date" inschakelen. Hiermee kan de chatbot niet-voorradige producten opnemen waarvoor in PrestaShop een verwachte voorraaddatum is ingesteld. In plaats van deze producten volledig te verbergen, informeert de chatbot de klant over de voorraaddatum en dat het product beschikbaar is als pre-order.

Vereisten:

  • In PrestaShop moet "Bestellen van niet-voorradige producten toestaan" zijn ingeschakeld (Shop Parameters > Product Settings)
  • De webservicesleutel moet View (GET)-toegang hebben tot de bronnen combinations en configurations
  • Producten moeten een ingestelde available_date hebben op hun combinaties in PrestaShop

Prijzen inclusief btw

Schakel de optie "Apply tax (VAT) to prices" in bij de actie-instellingen van Product Search om prijzen inclusief btw weer te geven. Wanneer dit is ingeschakeld, berekent de chatbot prijzen aan de hand van de btw-regels uit je PrestaShop-winkel op basis van het standaardland van de winkel. Dit zorgt ervoor dat de prijzen die klanten in de chat zien, overeenkomen met wat ze in je webshop zien.

Vereisten:

  • De webservicesleutel moet View (GET)-toegang hebben tot de bronnen taxes, tax_rules, tax_rule_groups en configurations

Specifieke prijzen (kortingen en promoties)

Schakel de optie "Apply specific prices (discounts/promotions)" in bij de actie-instellingen van Product Search om gereduceerde prijzen uit de regels voor specifieke prijzen van PrestaShop weer te geven. Wanneer er een korting actief is voor een product, toont de chatbot zowel de gereduceerde prijs als de originele prijs, zodat klanten direct het prijsvoordeel zien.

Dit geldt voor algemene specifieke prijsregels - promoties en aanbiedingen die gelden voor alle klanten met een minimale hoeveelheid van 1. Tijdgebonden promoties worden ook ondersteund; de chatbot past alleen kortingen toe die op dat moment actief zijn op basis van hun begin- en einddatum.

Vereisten:

  • De webservicesleutel moet View (GET)-toegang hebben tot de bronnen specific_prices en specific_price_rules

Je integratie testen

Open na het activeren van de acties je chatbot-widget en probeer het volgende:

  • "Laat me hardloopschoenen zien" (test de productzoekfunctie)
  • "Ik ben op zoek naar product ABC-12345" (test het zoeken op referentie/SKU)
  • "Wat is de status van mijn bestelling 12345?" (test het opvragen van bestelgegevens)

Controleer of de antwoorden overeenkomen met de gegevens uit je PrestaShop-winkel, of productlinks correct openen en of prijzen inclusief btw en kortingen worden getoond wanneer die opties zijn ingeschakeld.

Chatbot installeren op je PrestaShop-winkel

Raadpleeg de uitgebreide handleiding om de chat-widget aan je PrestaShop-webshop toe te voegen: Chatbot installeren op een PrestaShop-winkel

Doorzoek alle artikelenVraag het de agent