Integratie met CS-Cart: AI Search, live zoeken in de winkel en bestelstatus

Verbind je ChatLab-chatbot met je CS-Cart-winkel, zodat klanten direct in de chat producten kunnen vinden en hun bestellingen kunnen controleren. Producten worden gevonden via AI Search, dat je geïndexeerde CS-Cart-catalogus doorzoekt op betekenis, of via live winkelzoekopdrachten, die de winkel-API raadplegen.

Voorbeeldgesprek

Het voorbeeld illustreert de klantervaring. De beschikbare acties en getoonde informatie zijn afhankelijk van deze integratie en jouw configuratie.

Voordat je begint

Maak of selecteer eerst een chatbot. Je hebt toestemming nodig om de integraties ervan te beheren en toegang tot de verbindingsinstellingen van het externe account. Als de tegel Connect (Verbinden) een upgrade- of contactmelding toont, controleer dan of je abonnement deze integratie bevat. Houd API-inloggegevens geheim; plak ze nooit in de embedcode van een website.

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: ChatLab instellen voor je e-commercewinkel

Hoe de chatbot producten vindt op CS-Cart: AI Search en live zoeken in de winkel

Er zijn twee manieren waarop een ChatLab-chatbot producten vindt in een CS-Cart-winkel. Een chatbot gebruikt de ene of de andere, nooit beide.

AI Search (aanbevolen) - ChatLab houdt een eigen index bij van je CS-Cart-catalogus en de chatbot doorzoekt deze op betekenis.

• Klanten stellen vragen in gewone taal, bijvoorbeeld "een rode jurk onder 300". Een prijsbereik wordt toegepast als een strikt filter, en exacte productcodes (SKU, EAN) worden ook gematcht.
• Prijs, voorraad en varianten worden op het moment van antwoorden live uitgedragen vanuit CS-Cart, zodat klanten actuele gegevens zien, zelfs tussen indexvernieuwingen door.
• Resultaten verschijnen als productkaarten in de chat, tot maximaal 5 per antwoord.
• Indexering start vanzelf zodra de winkel is gekoppeld. De catalogus verbruikt geen trainingstekens.
• Abonnement dat je nodig hebt: elk E-commerce-abonnement bevat dit (FREE 100 producten, E-commerce Start 2.000, E-commerce Grow 5.000, E-commerce Scale 20.000). Voeg bij een Universal-abonnement de add-on E-commerce-integraties toe ($ 30 per maand) plus een AI Search-productpakket ($ 29 per maand, 5.000 producten) dat is toegewezen aan de chatbot.

Live zoeken in de winkel - de chatbot geeft de zoekopdracht van de klant via de winkel-API door aan de zoekfunctie van CS-Cart en antwoordt met wat de winkel teruggeeft.

• Er wordt niets geïndexeerd en er hoeft niets gesynchroniseerd te blijven. De gegevens zijn altijd live.
• Het is een zoekfunctie op trefwoorden: het vindt wat de eigen zoekfunctie van je winkel voor die zoekterm zou vinden. Het begrijpt geen beschrijvingen van een behoefte, synoniemen of typefouten zoals AI Search dat doet.
• Abonnement dat je nodig hebt: een Universal-abonnement met de add-on E-commerce-integraties ($ 30 per maand). Er is geen productpakket nodig.

Wanneer AI Search is ingeschakeld, vervangt dit het live zoeken in de winkel. Bestelstatus werkt op beide manieren hetzelfde. Een derde optie, trainen op gescande winkelpagina's, is beschikbaar bij elk abonnement en is bedoeld voor informatieve inhoud zoals bezorging en retourneren, niet voor producten. Bekijk voor een volledige vergelijking AI Search: hoe je chatbot producten vindt, en bekijk voor productlimieten E-commerce-abonnementen en limieten.

Wat de integratie biedt

Live store search (producten zoeken op trefwoord) - De chatbot stuurt de zoekterm van de klant door naar de zoekfunctie van CS-Cart en toont overeenkomende producten met:

• Productnaam en beschrijving
• Prijs
• SKU (productcode)
• Directe link naar het product in je winkel
• Productafbeelding
• Beschikbare varianten (maten, kleuren, enz.)

Je kunt instellen welke productvelden worden doorzocht (naam, korte beschrijving, volledige beschrijving, trefwoorden) en hoeveel resultaten er worden getoond.

Bestelgegevens - Klanten kunnen hun bestelstatus controleren door hun bestelnummer en e-mailadres op te geven. De chatbot toont:

• Bestelstatus
• Bestelde artikelen met namen, prijzen, aantallen, productafbeeldingen en gekozen varianten
• Totaalbedrag van de bestelling en verzendkosten
• Vervoerder, trackingnummer en verzendstatus
• Naam van de ontvanger en volledig bezorgadres
• Telefoonnummer van de klant

Stap 1: API-toegang inschakelen in CS-Cart

1. Log in op je CS-Cart-beheerderspaneel
2. Ga naar Customers > Administrators (Klanten > Beheerders)

3. Klik op het beheerdersaccount dat wordt gebruikt voor de API-koppeling
4. Ga naar het tabblad API access (API-toegang)
5. Vink "Yes, allow this user to use the API" aan
6. Klik op Save (Opslaan)

7. Kopieer de API key die na het opslaan wordt weergegeven - bewaar deze op een veilige plek
8. Noteer het e-mailadres dat aan dit beheerdersaccount is gekoppeld

Stap 2: CS-Cart verbinden in ChatLab

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

3. Klik op Connect op de CS-Cart-tegel
4. Voer je API Key in (uit stap 1)
5. Voer je Account Email in (het e-mailadres van de beheerder met API-toegang)
6. Voer je Shop Url in (bijv. https://yourstore.com)

Je kunt ook de zoekopties configureren:

• Searchable fields - kies welke productvelden de chatbot doorzoekt (productnaam, korte beschrijving, volledige beschrijving, trefwoorden)
• Number of search results - hoeveel producten er per zoekopdracht worden geretourneerd (standaard: 5)

7. Klik op Connect

Na een succesvolle verbinding zie je een bevestigingsbericht met de optie om AI-acties te configureren.

Stap 3: CS-Cart-acties configureren

Schakel na het verbinden individuele AI-acties in en pas ze aan. Ga naar Settings > Actions (Instellingen > Acties) en filter op het platform CsCart.

De standaardacties zijn onder meer:

• CsCart - product search - stelt de chatbot in staat om je productcatalogus te doorzoeken
• CsCart - order details - stelt de chatbot in staat om bestelgegevens op te zoeken

Bij het instellen van de verbinding worden de standaardacties ingeschakeld. Controleer hun status en schakel acties uit die je klanten niet wilt laten gebruiken. Open een actie om deze te bewerken en gebruik vervolgens Enable (Inschakelen) of Update (Bijwerken) in het bijbehorende dialoogvenster. Je kunt ook het actielabel aanpassen (het bericht dat aan gebruikers wordt getoond terwijl de actie wordt uitgevoerd) evenals de instructies die bepalen hoe de AI elke actie gebruikt.

AI Search voor CS-Cart: catalogus, herindexering en instellingen

Bij een E-commerce-abonnement, of bij een Universal-abonnement wanneer een AI Search-productpakket aan de chatbot is toegewezen, staat AI Search aan en vervangt het de live winkelzoekfunctie. Het indexeren start vanzelf zodra de winkel is gekoppeld.

• Controleer de catalogus - open Training > E-commerce catalog (E-commercecatalogus) en bekijk de tabbladen Products (Producten) en Categories (Categorieën). Onder Shop > Products zie je het paneel Product catalog en de kaart AI Search packs on this chatbot.
• Herindexering inplannen - gebruik Schedule auto-retrain (Automatisch opnieuw trainen inplannen) in Training > E-commerce catalog. Herindexering kan dagelijks worden uitgevoerd en is beschikbaar bij elk E-commerce-abonnement en bij elk productpakket. Met Train now (Nu trainen) of Retrain (Opnieuw trainen) start je dit handmatig. Updates zijn incrementeel: ongewijzigde producten worden overgeslagen en verwijderde producten worden uit de index gewist.
• Bekijk de actie - open in Settings > Actions (Instellingen > Acties) de actie CsCart - AI product search. De opties hiervan zijn Include product card, Products in stock only en Number of products to return.
• Productkaarten tonen - schakel Enable Offer Cards in onder Settings > Model & Advanced. Zie Offer Cards.

Als de catalogus groter is dan de productlimiet, stopt het indexeren bij de limiet en ontvangt de eigenaar van de chatbot een e-mail. Opties van de hierboven beschreven actie voor live winkelzoeken zijn niet automatisch van toepassing op AI Search.

Je integratie testen

Open na het activeren van de acties Overview (Overzicht) en probeer:

• "Laat me trainingshandschoenen zien" (test het zoeken naar producten)
• "Wat is de status van mijn bestelling 12345?" (test bestelgegevens; geef het bijbehorende e-mailadres op voor een bestelling waartoe je geautoriseerd bent)

Controleer of de antwoorden overeenkomen met de gegevens uit je CS-Cart-winkel.

Tips voor de zoekconfiguratie

• Schakel Product name en Short description in voor de beste balans tussen snelheid en nauwkeurigheid
• Voeg Keywords toe als je producten over uitgebreide metadata met trefwoorden beschikken
• Schakel Full description alleen in als kortere velden geen goede resultaten opleveren - dit kan zoekopdrachten vertragen
• Begin met 5 resultaten per zoekopdracht en pas dit aan op basis van de grootte van je catalogus

Chatbot installeren op je CS-Cart-winkel

Om de chatwidget toe te voegen aan je CS-Cart-webshop:

1. Ga in ChatLab naar het tabblad Deploy (Implementeren) voor je bot
2. Selecteer het platformtabblad CS-Cart
3. Kopieer het codefragment
4. Ga in je CS-Cart-beheeromgeving naar Design > Layouts (Ontwerp > Lay-outs)
5. Voeg een HTML block (HTML-blok) toe aan de standaardlay-out en plak het widgetfragment in het tabblad Content (Inhoud)
6. Sla de blok- en lay-outwijzigingen op. Controleer pagina's met afzonderlijke lay-outs, zoals het afrekenproces, en alle talen van de webshop

Als je een HTML-blok met Smarty-ondersteuning gebruikt, plaats het fragment dan tussen {literal} en {/literal}. Zie de instructies van CS-Cart voor aangepaste code. Open de gepubliceerde webshop en controleer de widget op desktop en mobiel.

Gerelateerde artikelen

• AI Search: hoe je chatbot producten vindt
• E-commerce-abonnementen en limieten
• Handleiding voor het instellen van e-commerce
• Chatbot toevoegen aan je website