Helpcentrum
Chatbot-integraties

Integratie met BigCommerce

Laatst bijgewerkt:

Verbind je BigCommerce-winkel met je ChatLab-chatbot. Zodra de koppeling actief is, doorzoekt de chatbot je producten, indexeert hij de hele catalogus voor AI Search, kunnen klanten rechtstreeks vanuit de chat producten toevoegen aan hun winkelwagen en controleert hij de status van bestellingen direct in je winkel.

Voorbeeldgesprek

Bekijk het in een gesprek

Controleer een bestelling

Vereist een gekoppelde winkel en de ingeschakelde bestelactie. Beschikbare velden zijn afhankelijk van de integratie. Een overeenkomend e-mailadres is geen identiteitsbewijs.

ChatLab-voorbeeldVoorbeeldgesprek

Bezoeker: Waar is mijn bestelling?

Speel het voorbeeld af of lees het hieronder. Er worden geen echte klantgegevens gebruikt.
1 / 5

De klant vraagt naar een bestaande bestelling.

Het afspelen pauzeert wanneer dit voorbeeld uit beeld verdwijnt. Dit is een simulatie, geen livechat. De widgetknoppen tijdens het afspelen zijn niet interactief.
Lees het volledige voorbeeld
  1. De klant vraagt naar een bestaande bestelling.

    Bezoeker: Waar is mijn bestelling?

  2. De standaardzoekopdracht heeft beide gegevens nodig.

    Assistent: Geef alsjeblieft je bestelnummer en het e-mailadres door dat bij het afrekenen is gebruikt.

  3. Gebruik fictieve gegevens in dit voorbeeld.

    Bezoeker: 41982, anna@example.com

  4. De actie haalt gegevens op uit de gekoppelde winkel.

    Bestelling 41982 controleren...

  5. Meld alleen de gegevens die de winkel teruggeeft.

    Assistent: Bestelling 41982 staat gemarkeerd als verzonden. De bezorger is DPD. Bekijk de trackingpagina voor de meest recente bezorginformatie.

Dit voorbeeld laat de klantervaring zien. Welke acties beschikbaar zijn en welke informatie wordt getoond, hangt af van deze integratie en je instellingen.

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: Hoe je ChatLab instelt voor je e-commerce-winkel

Wat de integratie biedt

AI-productzoekfunctie - Klanten beschrijven in hun eigen woorden wat ze zoeken en de chatbot vindt passende producten in je catalogus. Het antwoord bevat:

  • Productnaam en beschrijving
  • Huidige prijs in de valuta van je winkel, en bij afgeprijsde artikelen ook de normale prijs
  • Productafbeelding
  • Directe link naar de productpagina in je winkel
  • Beschikbaarheid, SKU, merk, categorieën en productopties (zoals maten of kleuren) wanneer het product deze heeft

Producten zoeken op trefwoord - Een eenvoudige zoekfunctie op basis van zoekwoorden in je BigCommerce-catalogus. Zodra de catalogus is geïndexeerd, vervangt AI-productzoekfunctie deze automatisch.

Bestelstatus - De klant geeft het bestelnummer en het e-mailadres op dat bij het afrekenen is gebruikt. De chatbot toont vervolgens de bestelstatus, de bestelde artikelen, de totaalbedragen en de trackinginformatie zodra de bestelling is verzonden. Bestellingen worden altijd gecontroleerd aan de hand van het e-mailadres van de klant. Een willekeurig geraden bestelnummer geeft dus nooit toegang tot de bestelling van iemand anders.

Toevoegen aan winkelwagen - Productkaarten in de chat kunnen een knop Add to cart (Toevoegen aan winkelwagen) bevatten. In je BigCommerce-webshop plaatst deze knop het product direct in de winkelwagen van de bezoeker en wordt de teller in de paginakop bijgewerkt. Bij producten met opties zoals maat of kleur kiest de klant eerst de gewenste variant in de chat. Bij producten met opties die niet via de chat kunnen worden ingevuld (zoals een verplicht tekstveld voor een gravering), opent de knop de productpagina.

Chatwidget in je webshop - ChatLab voegt de chatwidget via de BigCommerce Script Manager automatisch toe aan je webshop, dus je hoeft zelf geen code te plakken.

Bekijk de winkelwagenervaring

Zie Producten toevoegen aan de winkelwagen voor een voorbeeld van de winkelwagen en instructies om dit in je webshop te testen. De onderstaande reeks dient ter illustratie; er wordt geen echte BigCommerce-winkelwagenactie uitgevoerd.

Bekijk het in een gesprek

Kies een variant voordat je het aan het winkelmandje toevoegt

Illustratieve weergave: daadwerkelijke knoppen voor winkelmandjes en variantkiezers zijn afhankelijk van het platform en de storefront. Deze demo voert geen actie in het winkelmandje uit.

ChatLab-voorbeeldVoorbeeldgesprek

Smaragdgroene wikkeljurk, $79. Viscose, midi-lengte.

Speel het voorbeeld af of lees het hieronder. Er worden geen echte klantgegevens gebruikt.
1 / 4

Zoekresultaten tonen een productkaart met een winkelmandknop in ondersteunde winkels.

Het afspelen pauzeert wanneer dit voorbeeld uit beeld verdwijnt. Dit is een simulatie, geen livechat. De widgetknoppen tijdens het afspelen zijn niet interactief.
Lees het volledige voorbeeld
  1. Zoekresultaten tonen een productkaart met een winkelmandknop in ondersteunde winkels.

    Smaragdgroene wikkeljurk, $79. Viscose, midi-lengte.

  2. De klant kiest een product en maat via de ondersteunde winkelmandknoppen.

    Bezoeker: Smaragdgroene wikkeljurk, maat 38.

  3. Bevestig pas een succesvolle toevoeging nadat de storefront de actie heeft verwerkt.

    Assistent: Voorbeeldresultaat: de geselecteerde variant is toegevoegd aan je winkelmandje in de winkel.

  4. Betaling en afrekenen vinden plaats in de winkel.

    Assistent: Controleer je winkelmandje in de winkel om aantal, prijs en bezorging te bevestigen en ga door naar afrekenen.

Wat de integratie niet biedt

  • Afrekenen binnen de chat. De klant rondt de aankoop altijd af in je BigCommerce-winkel.
  • Live voorraadmeldingen. Prijzen en voorraadstatus worden op het moment van antwoorden opgehaald uit BigCommerce, maar de chatbot stuurt klanten geen meldingen over latere wijzigingen.
  • Toevoegen aan winkelwagen op headless-omgevingen. De winkelwagenknop werkt op webshops die zijn gebaseerd op BigCommerce-thema's. Op een headless-webshop opent de knop in plaats daarvan de productpagina en moet de chatwidget handmatig aan de site worden toegevoegd.

Vereisten

  • Een BigCommerce-winkel waarin je winkeleigenaar bent of een gebruiker met rechten om apps te installeren of API-accounts aan te maken.
  • De BigCommerce-integratie inbegrepen in je ChatLab-plan.
  • Voor AI-productzoekfunctie: voldoende AI Search-capaciteit toegewezen aan de chatbot voor al je zichtbare producten. Controleer de beschikbare capaciteit via Shop > Products.
  • Geen andere winkelintegratie gekoppeld aan dezelfde chatbot.

Kies een van de twee onderstaande manieren. Beide leiden tot hetzelfde resultaat.

Optie A: De ChatLab-app installeren

  1. Ga in het BigCommerce-beheerderspaneel naar Apps, zoek ChatLab en klik op Install.
  2. Controleer de machtigingen en klik op Confirm. ChatLab vraagt om alleen-lezen toegang tot producten, bestellingen, klanten en winkelinformatie, en om toegang tot webshopcontent om de chatwidget toe te voegen.
  3. De ChatLab-pagina opent binnen je beheeromgeving. Klik op Continue setup. Het onboardingproces van ChatLab opent in een nieuw browsertabblad.
  4. Log in op je ChatLab-account of maak een nieuw account aan als je er nog geen hebt.
  5. Kies een bestaande chatbot of maak een nieuwe aan voor deze winkel.

Dat is alles. ChatLab koppelt de winkel aan de gekozen chatbot, schakelt de acties voor productzoekfunctie en bestelstatus in, begint met het indexeren van je catalogus en voegt de chatwidget toe aan je webshop. Je kunt ChatLab op elk gewenst moment weer openen via het menu Apps in je beheerderspaneel.

Als je de app in BigCommerce verwijdert, wordt de integratie in ChatLab uitgeschakeld en verdwijnt de chatwidget uit je webshop. Je chatbot en de bijbehorende gesprekken blijven bewaard in je ChatLab-account.

Optie B: Koppelen via een API-account op winkelniveau

Gebruik deze optie als je de toegang liever zelf instelt, of als je een chatbot wilt koppelen zonder de app te installeren.

Stap 1: Het API-account aanmaken in BigCommerce

  1. Ga in het BigCommerce-beheerderspaneel naar Settings (Instellingen) en vervolgens naar Store-level API accounts.
  2. Klik op Create API account en geef het een naam, bijvoorbeeld ChatLab.
  3. Stel de machtigingen in:
    • Products - read-only
    • Orders - read-only
    • Customers - read-only
    • Information & settings - read-only
    • Content - modify
  4. Klik op Save. BigCommerce toont de inloggegevens één keer en downloadt ze als een tekstbestand.
  5. Kopieer het API path en het Access token.

Het API-pad ziet er als volgt uit: api.bigcommerce.com/stores/abc123/v3/. Het gedeelte tussen stores/ en /v3/ is je store hash.

Houd het toegangstoken geheim. Je kunt het op elk gewenst moment intrekken door het API-account in BigCommerce te verwijderen.

Stap 2: De winkel koppelen in ChatLab

  1. Open je chatbot in ChatLab en ga naar Shop (Winkel).
  2. Klik op de tegel BigCommerce.
  3. Plak het API-pad (of alleen de store hash) in het veld Store hash or API path en het token in Access token.
  4. Klik op Check connection. ChatLab haalt het winkelprofiel op en toont de winkelnaam, het adres van de webshop en de valuta.
  5. Klik op Connect.

ChatLab test de verbinding en activeert direct de acties voor productzoekfunctie en bestelstatus. Wanneer er AI Search-capaciteit is toegewezen aan de chatbot, begint het indexeren van de catalogus meteen; dit wordt bevestigd in het scherm. In hetzelfde venster zie je of de chatwidget aan je webshop is toegevoegd. Het toegangstoken wordt versleuteld opgeslagen en wordt daarna nooit meer weergegeven; laat het tokenveld leeg wanneer je de koppeling alleen wilt bijwerken.

De acties configureren

Ga naar Settings > AI Actions (Instellingen > AI Actions). Er zijn drie acties beschikbaar voor BigCommerce:

  • BigCommerce - AI product search - semantisch zoeken in de geïndexeerde catalogus. In de instellingen kun je instellen dat de volledige productkaart in het antwoord wordt getoond, de resultaten beperken tot producten op voorraad en de knop Add to cart inschakelen.
  • BigCommerce - product search - trefwoordzoekfunctie in de BigCommerce-catalogus, bedoeld voor situaties waarin AI Search niet beschikbaar is voor de chatbot. Deze actie kan ook worden beperkt tot voorradige producten en de knop Add to cart tonen.
  • BigCommerce - order details - opzoeken van bestelstatussen. In de actie-instellingen kun je snelheidslimieten (rate limiting) instellen en persoonsgegevens maskeren.

Elke actie beschikt over een aanpasbare prompt en een actielabel dat in de chat te zien is terwijl de chatbot bezig is met verwerken.

De catalogus controleren

Open Training > E-commerce catalog (Training > E-commerce-catalogus) om de voortgang van het indexeren te volgen, de geïndexeerde producten te bekijken en de catalogus opnieuw te trainen na grotere wijzigingen in de winkel. Producten die niet zichtbaar zijn in je winkel, worden niet geïndexeerd.

Producten zonder beschrijving worden uitsluitend geïndexeerd op basis van naam, merk, categorieën en attributen. Als je producten in BigCommerce geen omschrijving hebben, verbetert zelfs een korte toevoeging de zoekresultaten aanzienlijk.

Wanneer je de chatbot ook traint op de pagina's van je website, herkent ChatLab een BigCommerce-winkel en slaat het product-, categorie- en merkpagina's automatisch over. Productgegevens komen al uit de catalogus en hoeven dus niet nogmaals van de webpagina's te worden gelezen.

De chatwidget in je webshop

Wanneer de winkel is gekoppeld via de app, of via een API-account met modify-rechten voor Content, voegt ChatLab de widget automatisch voor je toe. Je vindt deze in Storefront > Script Manager onder de naam ChatLab chatbot. De widget wordt in de footer van alle webshoppagina's geplaatst binnen de toestemmingscategorie Functional en wordt automatisch verwijderd als je de winkel loskoppelt.

Als het API-account is aangemaakt zonder toegang tot Content, maak dan een nieuw API-account met die rechten aan en koppel opnieuw, of voeg de widget handmatig toe:

  1. Open je chatbot in ChatLab, ga naar Test & Deploy (Testen en publiceren), kies BigCommerce en kopieer de code.
  2. Ga in het BigCommerce-beheerderspaneel naar Storefront > Script Manager.
  3. Klik op Create a Script en geef het een naam, bijvoorbeeld ChatLab.
  4. Stel Placement in op Footer, Location op Storefront pages en Script category op Functional.
  5. Kies bij Script type voor Script en plak de code in Script contents.
  6. Klik op Save en vernieuw je webshop. De chatbot verschijnt nu in de benedenhoek van elke pagina.

Problemen oplossen

  • "Failed to connect to the BigCommerce store. Check the store hash and the access token." - Het token is niet volledig gekopieerd, het API-account is verwijderd of de store hash hoort bij een andere winkel. Kopieer beide waarden opnieuw uit het bestand dat BigCommerce heeft gedownload bij het aanmaken van het API-account.
  • De chatwidget is niet automatisch toegevoegd - Het API-account heeft geen modify-rechten voor Content. Maak een nieuw API-account aan met deze machtiging en verbind opnieuw, of voeg de widget toe via de Script Manager zoals hierboven beschreven.
  • De chatbot verschijnt niet in de webshop - Controleer of het script aanwezig is onder Storefront > Script Manager. Als je winkel een cookiebanner gebruikt, laadt de widget pas nadat de bezoeker de categorie Functional accepteert.
  • De chatbot vindt geen producten - Controleer de indexeringsstatus onder Training > E-commerce catalog en zorg dat de producten op zichtbaar staan in je winkel.
  • De bestelling wordt niet gevonden - De chatbot heeft het e-mailadres nodig waarmee is afgerekend, samen met het bestelnummer uit de bevestigingsmail.
  • Toevoegen aan winkelwagen opent de productpagina - Het product heeft een verplichte optie die niet via de chat kan worden gekozen (zoals een tekstveld), of de chatbot draait buiten je BigCommerce-webshop.