Integratie met Shopify: AI Search, live zoeken in de winkel en bestelstatus

Verbind je ChatLab-chatbot met je Shopify-winkel, zodat klanten rechtstreeks in de chat producten kunnen vinden en hun bestellingen kunnen controleren. Producten worden gevonden via AI Search, dat op betekenis zoekt in je geïndexeerde Shopify-catalogus, of via live winkelzoeken, dat rechtstreeks een query uitvoert op de winkel-API.

Voorbeeldgesprek

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

Voordat je begint

Maak of selecteer eerst een chatbot. Je hebt toestemming nodig om de bijbehorende integraties 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 insluitcode van een website.

Belangrijk: best practices voor e-commerce

Nadat je de onderstaande integratie hebt voltooid, lees je de uitgebreide handleiding over het optimaliseren van je chatbot voor e-commerce: Hoe je ChatLab instelt voor je e-commercewinkel

Hoe de chatbot producten vindt op Shopify: AI Search en live zoeken in de winkel

Er zijn twee manieren waarop een ChatLab-chatbot producten vindt in een Shopify-winkel. Een chatbot gebruikt de ene of de andere optie, nooit allebei.

AI Search (aanbevolen) - ChatLab houdt een eigen index bij van jouw Shopify-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 Shopify, zodat klanten actuele gegevens zien, zelfs tussen indexverversingen door.
• Resultaten verschijnen als productkaarten in de chat, tot 5 per antwoord.
• Indexering start vanzelf zodra de winkel is gekoppeld. De catalogus verbruikt geen trainingskarakters.
• Abonnement dat je nodig hebt: elk E-commerce-abonnement bevat dit (Free 100 producten, Start 2.000, Grow 5.000, Scale 20.000). Voeg bij een Universal-abonnement de add-on E-commerce-integraties ($30 per maand) toe plus een AI Search-productpakket ($29 per maand, 5.000 producten) dat aan de chatbot is toegewezen.

Live zoeken in de winkel - de chatbot stuurt de zoekterm van de klant door naar de zoekfunctie van Shopify via de winkel-API 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 zoekopdracht op trefwoorden: het vindt wat de eigen zoekfunctie van jouw winkel voor die zoekterm zou vinden. Het begrijpt geen beschrijvingen van een behoefte, synoniemen of typfouten 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.

Zodra 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 op elk abonnement en is bedoeld voor informatieve inhoud zoals bezorging en retouren, niet voor producten. Zie voor een volledige vergelijking AI Search: hoe jouw chatbot producten vindt, en zie 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 Shopify. Deze zoekt door producttitels, beschrijvingen, producttypen, tags en leveranciers en toont overeenkomende actieve producten met:

• Productnaam, beschrijving en type
• Leverancier en tags
• Prijs of prijsbereik (voor producten met meerdere varianten)
• Beschikbare varianten met SKU, van-prijs (compare-at price), voorraadaantal en beschikbaarheidsstatus
• Productafbeelding en directe link naar je winkel

Je kunt het zoeken naar producten zo instellen dat alleen artikelen op voorraad worden getoond. Als dit is ingeschakeld, worden niet-voorradige artikelen uitgesloten van de resultaten. Met een extra optie kun je producten opnemen die beschikbaar zijn voor pre-order, zelfs als het filter voor voorraad actief is. Zie Stap 4 voor meer informatie.

Bestelgegevens (Order Details) - Standaard geven klanten hun bestelnummer en het bijbehorende e-mailadres op. Met optionele modi kunnen bestellingen worden opgezocht op alleen bestel-ID of recente bestellingen op alleen e-mailadres. Dit zijn gegevensvergelijkingen, geen bewijs van de identiteit van de bezoeker. De chatbot toont:

• Bestelnummer, datum, totaalbedrag en valuta
• Bestelde artikelen met namen, aantallen, prijzen, SKU, variantnaam en leverancier
• Afhandelingsstatus (fulfillment status) en trackinggegevens (nummer, vervoerder, URL)
• Verzendadres en factuuradres
• Verzendmethode en kosten
• Contactgegevens van de klant (e-mailadres, naam, telefoonnummer)
• Reden en datum van annulering (voor geannuleerde bestellingen)

Stap 1: Maak Shopify API-inloggegevens aan

Belangrijk voor bureaus en Shopify-partners: Maak en installeer de app binnen de organisatie die eigenaar is van de winkel. De Client ID- en Secret-verbinding van ChatLab maakt gebruik van de client credentials grant van Shopify, die geen apps ondersteunt die eigendom zijn van een andere organisatie. Als je de melding "The app cannot access this store" ziet, controleer dan de organisatie en installatie van de app voordat je inloggegevens vervangt. Zie Shopify's client credentials requirements.

1. Log in op je Shopify-beheerderspaneel
2. Ga naar Settings > Apps (Instellingen > Apps)
3. Klik op Develop apps (Apps ontwikkelen)
4. Klik op de pagina App Development op Build apps in Dev Dashboard (Apps bouwen in Dev Dashboard) - dit opent dev.shopify.com/dashboard
5. Klik op Create app (App maken) en voer een naam in (bijv. "ChatLab Integration")

6. Zodra de app is aangemaakt, scrol je naar het gedeelte Access (Toegang) en klik je op Select scopes (Scopes selecteren)

7. Zoek en schakel onder Admin API-toegangsscopes deze machtigingen in:
   • read_products
   • read_orders
8. Klik op Done (Gereed)

9. Klik op de knop Release (Vrijgeven) om je app vrij te geven
10. Ga naar App settings (App-instellingen) en kopieer de Client ID en Secret - bewaar deze veilig, je hebt ze nodig om verbinding te maken met ChatLab

11. Ga naar het gedeelte Home (Start) en klik om de applicatie in je winkel te installeren

12. Selecteer je winkel en bevestig door op Install (Installeren) te klikken

Stap 2: Zoek het subdomein van je winkel

Zoek het myshopify.com-domein van de winkel via Settings > Domains (Instellingen > Domeinen) in Shopify en voer vervolgens alleen het gedeelte vóór .myshopify.com in. Voor pizza-delicious.myshopify.com voer je pizza-delicious in, niet je aangepaste storefront-domein of de dashboard-URL admin.shopify.com. Zie de domeinhandleiding van Shopify.

Stap 3: Verbind Shopify in ChatLab

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

3. Klik op Connect op de Shopify-tegel
4. Voer je Client ID in (uit Stap 1)
5. Voer je Secret in (uit Stap 1)
6. Voer je Shopify subdomain in (uit Stap 2)

7. Klik op Connect

ChatLab test de verbinding automatisch door te controleren of je API-gegevens over de vereiste toegangsrechten beschikken. Als dit lukt, zie je een bevestigingsbericht.

Stap 4: Configureer Shopify-acties

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

De standaardacties omvatten:

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

Het instellen van de verbinding schakelt de standaardacties in. Controleer hun status en schakel acties uit waarvan je niet wilt dat klanten ze 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) en de instructies waarmee de AI elke actie aanstuurt.

Product Search - Voorraadinstellingen

De actie voor het zoeken naar producten bevat voorraadfilteropties op het tabblad Product Search Settings (Instellingen voor product zoeken):

• Products in stock only (Alleen producten op voorraad) - Indien ingeschakeld, retourneert de chatbot alleen producten die momenteel op voorraad zijn. Niet-voorradige producten worden uitgesloten van de zoekresultaten.
• Show products available for pre-order (Toon producten die beschikbaar zijn voor pre-order) - Deze optie verschijnt wanneer "Products in stock only" is ingeschakeld. Indien actief, worden producten die niet op voorraad zijn maar in Shopify zijn geconfigureerd om door te gaan met verkopen (pre-order), nog steeds weergegeven in de zoekresultaten, gemarkeerd als beschikbaar voor pre-order.

Privacy bij het opzoeken van bestellingen

In de Order Lookup Configuration (Configuratie voor bestelling opzoeken) van de bestelactie staan zowel Allow order lookup without email verification (Bestelling opzoeken zonder e-mailverificatie toestaan) als Allow order lookup by email address only (Bestelling opzoeken met alleen e-mailadres toestaan) standaard uitgeschakeld. De modus voor alleen e-mail retourneert standaard 1 recente bestelling, configureerbaar van 1-3. Het inschakelen van opzoeken op basis van alleen het ID schakelt de modus voor alleen e-mail uit. Iedereen die de geselecteerde zoekidentificatie kent, kan bestelgegevens achterhalen, dus controleer je toegangsbeheer en maskering van persoonsgegevens (PII) voordat je een van beide opties inschakelt.

AI Search voor Shopify: catalogus, herindexering en instellingen

Op een E-commerce-abonnement, of op een Universal-abonnement wanneer er een AI Search-productpakket is toegewezen aan de chatbot, 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). Shop > Products toont het paneel Product catalog en de kaart AI Search packs on this chatbot.
• Plan herindexering - gebruik Schedule auto-retrain (Automatisch hertrainen inplannen) in Training > E-commerce catalog. Herindexering kan dagelijks worden uitgevoerd en is beschikbaar op elk E-commerce-abonnement en bij elk productpakket. Met Train now (Nu trainen) of Retrain (Opnieuw trainen) start je dit direct handmatig. Updates zijn incrementeel: ongewijzigde producten worden overgeslagen en verwijderde producten worden uit de index gewist.
• Controleer de actie - open in Settings > Actions (Instellingen > Acties) de optie Shopify - AI product search. De instellingen hiervan zijn Include product card, Products in stock only en Number of products to return.
• Toon productkaarten - schakel Enable Offer Cards in onder Settings > Model & Advanced. Zie Offer Cards.

Wanneer de catalogus groter is dan de productlimiet, stopt het indexeren bij de limiet en ontvangt de chatbot-eigenaar een e-mail. De hierboven beschreven opties van de live winkelzoekfunctie gelden niet automatisch voor AI Search.

Je integratie testen

Nadat je de acties hebt geactiveerd, open je Overview (Overzicht) en probeer je:

• "Laat me hardloopschoenen zien" (test het zoeken naar producten)
• "Wat is de status van mijn bestelling #1001?" (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 Shopify-winkel en of de productlinks correct openen.

Chatbot installeren op je Shopify-winkel

Om de chatwidget aan je Shopify-storefront toe te voegen:

1. Ga in ChatLab naar het tabblad Deploy (Implementeren) voor je bot
2. Selecteer het platformtabblad Shopify
3. Selecteer Widget en kopieer het codefragment
4. Ga in je Shopify-beheeromgeving naar Online Store > Themes (Webshop > Thema's)
5. Klik op het menu met drie puntjes bij je actieve thema en selecteer Edit code (Code bewerken)
6. Open het bestand theme.liquid onder Layout
7. Plak het codefragment in het <head>-gedeelte
8. Klik op Save (Opslaan)

Open de gepubliceerde storefront om te controleren of de widget laadt. De API-verbinding en de installatie op de storefront staan los van elkaar; controleer de ingeschakelde acties in Settings > Actions.

Gerelateerde artikelen

• AI Search: hoe je chatbot producten vindt
• E-commerce-abonnementen en limieten
• E-commerce-configuratiehandleiding
• Chatbot toevoegen aan je website