Verbind je ChatLab-chatbot met je Shoper-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 voltooien van de onderstaande integratie de uitgebreide handleiding over het optimaliseren van je chatbot voor e-commerce: How to set up ChatLab for your E-commerce store
Wat de integratie biedt
Product Search - Klanten kunnen je Shoper-catalogus doorzoeken door een zoekterm in te voeren. De chatbot zoekt in productnamen met behulp van fuzzy matching en toont tot 10 overeenkomende producten met:
- Productnaam en beschrijving
- Prijs en SKU
- Directe link naar de productpagina in je winkel
- Productafbeelding
- Voorraadstatus
- Optioneel: productbijlagen (pdf's, documenten)
Je kunt ook het in-stock filter inschakelen om alleen producten te tonen die momenteel op voorraad zijn.
Order Details - Klanten kunnen hun bestelstatus controleren door een bestelnummer en het e-mailadres van de bestelling op te geven. Beide waarden worden gecontroleerd aan de hand van de gegevens in je Shoper-winkel. De chatbot toont:
- Bestelnummer, datum en huidige status
- Totaalbedrag en valuta van de bestelling
- Bestelde artikelen met namen, aantallen en prijzen
- Bezorgadres (straat, plaats, postcode, land, telefoonnummer)
- Factuuradres
- Bestelnotities
Vereisten
Controleer voordat je begint met de Shoper-integratie het volgende:
- Je hebt een STANDARD- of PREMIUM-abonnement van ChatLab
- Je hebt toegang tot je Shoper-beheerderspaneel
- Je chatbot is al aangemaakt in ChatLab
Stap 1: Maak een beheerdersgroep aan
- Ga in je Shoper-beheerderspaneel naar Settings > Store administrators (Instellingen > Winkelbeheerders)
- Klik op MORE (Meer) > Add administrators group (Beheerdersgroep toevoegen)
- Voer een naam in voor de groep (bijv. "ChatLab Integration"), selecteer Access type: 'access to webapi' en sla op
Stap 2: Configureer groepsrechten
- Open de zojuist aangemaakte groep en ga naar de rechteninstellingen
- Verleen Read-toegang (Lezen) tot de volgende onderdelen:
- Sales - read
- Catalog - read
- Configuration - read
Stap 3: Voeg een API-beheerder toe
- Ga naar Administrators (Beheerders) en klik op Add administrator (Beheerder toevoegen)
- Vul de gebruikersnaam en het wachtwoord in en wijs de beheerder toe aan de groep die in Stap 1 is aangemaakt
- Sla de beheerder op. Noteer de login (gebruikersnaam) en het password (wachtwoord) - je hebt deze nodig in de volgende stap.
Stap 4: Verbind Shoper in ChatLab
- Log in op ChatLab en selecteer je bot
- Ga naar het tabblad Connect (Verbinden)
- Klik op Connect (Verbinden) op de Shoper-tegel
- Voer je Shop URL in (je Shoper-domein, bijv.
myshop.shoper.pl) - Voer je WebAPI Login in (uit Stap 3)
- Voer je WebAPI Password in (uit Stap 3)
- Klik op Initialize Configuration (Configuratie initialiseren) - hiermee worden de beschikbare talen uit je winkel opgehaald
- Selecteer de juiste Shop Language (Winkeltaal) in het keuzemenu (dit bepaalt welke taalversie van de productgegevens wordt opgehaald)
- Klik op Connect (Verbinden)
ChatLab test de verbinding automatisch door een testzoekopdracht naar producten uit te voeren. Als dit lukt, zie je een bevestigingsbericht en worden zowel de acties voor productzoekopdrachten als voor bestelgegevens standaard ingeschakeld.
Stap 5: Shoper-acties configureren
Na het verbinden kun je afzonderlijke AI-acties inschakelen en aanpassen. Navigeer naar Settings > Actions (Instellingen > Acties) en filter op het Shoper-platform.
Er zijn twee acties beschikbaar:
- Shoper - product search - stelt de chatbot in staat om je productcatalogus te doorzoeken
- Shoper - order details - stelt de chatbot in staat om bestelgegevens op te zoeken
Klik op de activatieknop 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.
Voor het zoeken naar producten klik je op de knop Edit (Bewerken) en ga je naar het tabblad Product Search Settings (Instellingen voor productzoekopdrachten). Er zijn twee extra opties beschikbaar:
- Include product attachments - wanneer ingeschakeld, neemt de chatbot bijlagen van producten (pdf's, documenten) op in de zoekresultaten
- Products in stock only - wanneer ingeschakeld, toont de chatbot alleen producten die momenteel op voorraad zijn
Je integratie testen
Open na het activeren van de acties je chatbotwidget en probeer het volgende:
- "Laat me hardloopschoenen zien" (test het zoeken naar producten)
- "Wat is de status van mijn bestelling 12345?" (test bestelgegevens)
Controleer of de antwoorden overeenkomen met de gegevens uit je Shoper-winkel en of de productlinks correct openen.