Integratie met een productfeed (XML, Google Merchant)

Verbind elke online winkel met je ChatLab-chatbot via een productfeed. Als je platform geen native ChatLab-integratie heeft, is de feed dé manier om de chatbot toegang te geven tot je catalogus: hij leest de producten uit de feed, indexeert ze met AI Search en antwoordt met productkaarten die linken naar je winkel.

Voorbeeldgesprek

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

Belangrijk: Best practices voor e-commerce

Nadat je de onderstaande integratie hebt voltooid, raden we aan de uitgebreide handleiding te lezen over het optimaliseren van je chatbot voor e-commerce: ChatLab instellen voor je e-commercewinkel

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
• Prijs (en actieprijs wanneer deze in de feed staat)
• Productafbeelding
• Directe link naar de productpagina in je winkel
• Merk, beschikbaarheid, GTIN / SKU en andere attributen uit de feed

Categorieën - Wanneer de feed het producttype bevat (bijvoorbeeld "Wonen > Keuken > Waterkokers"), kan de chatbot de zoekopdracht verfijnen tot een categorie.

Gepland vernieuwen - De catalogus wordt bijgewerkt volgens het door jou ingestelde schema, zodat nieuwe producten, prijzen en voorraadwijzigingen zonder handmatige tussenkomst bij de chatbot terechtkomen.

Wat de integratie niet biedt

De feed is een bestand en geen directe koppeling met je winkel. De chatbot kan daarom niet:

• de status van een bestelling controleren
• producten aan de winkelwagen toevoegen of een bestelling plaatsen
• actuele voorraadniveaus uitlezen tussen de vernieuwingsmomenten door

Productkaarten met een geldige product-URL linken naar je winkel, waar de klant de aankoop voltooit. Kies voor het volgen van bestellingen een native integratie die dit ondersteunt. Ondersteuning voor het toevoegen aan de winkelwagen hangt ook af van het platform en de inrichting van je storefront; dit is niet beschikbaar via elke native integratie.

Vereisten

• De integratie Feed XML inbegrepen in je abonnement
• Toegang tot AI Search en cataloguscapaciteit toegewezen aan de chatbot: controleer Shop > Products (Winkel > Producten) voor de beschikbare capaciteit
• Geen andere winkelintegratie gekoppeld aan dezelfde bot. Bekijk de gevolgen voordat je een bestaande winkel ontkoppelt.
• Een productfeed in het XML-formaat van Google Merchant (Google Shopping), beschikbaar via een openbaar https-adres. Gecomprimeerde feeds (.gz) en feeds die zijn beveiligd met een gebruikersnaam en wachtwoord worden ondersteund.

Stap 1: Haal de productfeed op uit je winkel

Vraag je winkelbeheerder om een XML-productfeed met Google Merchant-velden. Het genereren van de feed en eventuele kosten voor extensies zijn afhankelijk van je platform:

• Magento / Adobe Commerce - een Google Shopping-feedextensie (bijvoorbeeld via de Magento Marketplace) genereert de XML op een adres zoals https://yourstore.com/feeds/google.xml
• IdoSell - open MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami en vraag de feed-URL op. Controleer of ChatLab deze kan downloaden, aangezien sommige feeds de toegang beperken tot de specifiek aangewezen dienst. Zie IdoSell's handleiding voor Google Shopping en toegangsbeperkingen voor feeds.
• OpenCart - als jouw versie de Google Base-feedextensie bevat, schakel deze dan in onder de feedextensies en kopieer de gegevensfeed-URL; gebruik anders een compatibele XML-exportextensie
• BigCommerce - genereer een downloadbare XML-URL via je feed-export-app. Alleen een koppeling met het Google-verkoopkanaal levert niet de feed-URL op die ChatLab nodig heeft
• Shopware 6 - voeg een verkoopkanaal van het type Product comparison (Productvergelijking) toe, kies Google Shopping (XML) als template, configureer de export en kopieer de URL. Zie Shopware's exporthandleiding.
• osCommerce en maatwerkwinkels - elke module die een RSS 2.0- of Atom-feed genereert met de g:-productattributen

Elk geïndexeerd product heeft een unieke id nodig (standaard g:id). Een naam en productlink worden sterk aanbevolen: ontbreekt de naam, dan wordt teruggevallen op de id; ontbreekt de link, dan kan er geen werkende link naar de webshop worden getoond. Prijs, afbeelding, beschrijving, beschikbaarheid en producttype maken de antwoorden aanzienlijk beter.

Stap 2: Koppel de feed in ChatLab

1. Log in op ChatLab en selecteer je bot
2. Ga naar het tabblad Connect (Koppelen)
3. Klik op Connect (Koppelen) op de tegel Feed XML
4. Plak de Feed URL
5. Als de feed een login vereist, schakel dan The feed requires a username and password (De feed vereist een gebruikersnaam en wachtwoord) in en voer de inloggegevens in
6. Stel eventueel de Product language (Producttaal - tweeletterige taalcode van de feed) in
7. Klik op Test feed (Feed testen) - ChatLab downloadt het begin van de feed en toont het formaat, een voorbeeldtelling (tot 2.000 artikelen, niet noodzakelijk het volledige aantal in de feed), maximaal vijf voorbeeldproducten en eventuele waarschuwingen (ontbrekende prijzen, links, afbeeldingen of categorieën)
8. Klik op Connect (Koppelen)

Als automatische catalogusindexering is ingeschakeld en de vereiste AI Search-toegang en -capaciteit beschikbaar zijn, start de configuratie direct met indexeren op de achtergrond. Train de catalogus anders handmatig. Volg de voortgang en foutmeldingen in Shop > Products (Winkel > Producten) of Training > E-commerce catalog (Training > E-commercecatalogus); een geslaagde koppeling betekent niet automatisch dat producten al direct doorzoekbaar zijn.

Stap 3: Niet-standaard feeds (Veldkoppeling)

Als je feed niet het Google Merchant-formaat gebruikt, kan ChatLab deze alsnog uitlezen:

1. Voer eerst Test feed (Feed testen) uit - de in je bestand gevonden elementnamen verschijnen in de selectiemenu's voor veldkoppeling
2. Open Field mapping for non-standard feeds (Veldkoppeling voor niet-standaard feeds)
3. Als een afzonderlijk product geen item- of entry-element is, vul dan de naam in bij Product element (Productelement)
4. Kies het juiste element voor elk veld: Product identifier (Product-id, verplicht), Product name (Productnaam), Description (Beschrijving), Product page URL (Productpagina-URL), Image URL (Afbeeldings-URL), Price (Prijs), Category path (Categoriepad) en de overige velden
5. Voer Test feed opnieuw uit en controleer de voorbeeldproducten
6. Klik op Connect

Velden die op "Default (Google Merchant)" blijven staan, behouden de standaardnamen; een feed die de standaard volgt, heeft dus helemaal geen handmatige veldkoppeling nodig.

Stap 4: Schema voor vernieuwen

1. Ga naar Training > E-commerce catalog (Training > E-commercecatalogus)
2. Klik op de kaart van Feed XML op Retrain (Opnieuw trainen)
3. Met Retrain now! (Nu opnieuw trainen!) vernieuw je de catalogus direct
4. Om automatisch te vernieuwen kies je de frequentie (elke dag, eenmaal per week of eenmaal per maand), de dag en het tijdstip en klik je op Schedule retrain (Opnieuw trainen inplannen)

Alleen producten die sinds de vorige vernieuwing zijn gewijzigd worden opnieuw geïndexeerd, en producten die uit de feed zijn verwijderd verdwijnen uit de catalogus van de chatbot. Het geplande schema volgt de mogelijkheden van je abonnement: voor wekelijkse en maandelijkse schema's is de functie voor periodiek opnieuw trainen vereist, voor dagelijkse schema's de dagelijkse variant.

Stap 5: De AI Action configureren

Als automatische catalogusindexering en de juiste toegangsrechten zijn ingeschakeld, activeert de koppeling automatisch Feed XML - AI product search. Schakel dit anders handmatig in en train de catalogus. Om instellingen aan te passen ga je naar Settings > Actions (Instellingen > Acties) en filter je op het platform Feed XML. Je kunt het label van de actie aanpassen, de instructies wijzigen die de AI aansturen en Include product card (Productkaart toevoegen) inschakelen zodat de chatbot de volledige productkaart toont in plaats van alleen de korte beschrijving.

De integratie testen

Open je chatbot-widget en probeer bijvoorbeeld:

• "Laat me waterkokers onder de 50 dollar zien" (test het zoeken met een prijsfilter)
• "Heb je blauwe katoenen T-shirts?" (test het matchen op kenmerken en attributen)

De antwoorden moeten producten uit je feed tonen, compleet met links naar je webshop.

Tips

• Vermeld het producttype in de feed (g:product_type) als een volledig pad, bijvoorbeeld "Kleding > Heren > T-shirts" - dit wordt de categorie waarop de chatbot kan filteren
• Zorg voor volledige beschrijvingen in de feed; de chatbot gebruikt deze om vragen van klanten te koppelen aan het juiste aanbod
• Varianten van hetzelfde product moeten hetzelfde item_group_id delen - ChatLab combineert hun kenmerken voor kleur, maat, materiaal en patroon in één geïndexeerd product. Het eerste artikel bepaalt de prijs en link van de groep, dus controleer variantspecifieke details in je winkel
• Als je feed erg groot is, downloadt een gecomprimeerde (.gz) feed aanzienlijk sneller

Chatbot installeren op je webshop

Zo voeg je de chatwidget toe aan je winkel:

1. Ga in ChatLab naar het tabblad Deploy (Publiceren) van je bot
2. Selecteer Widget en kopieer het codefragment
3. Plak dit in het template van je webshop, vlak voor de afsluitende </body>-tag, of gebruik de instelling voor "aangepaste HTML" of "scripts" van je platform

Gerelateerde artikelen

• Handleiding voor e-commerceconfiguratie
• De chatbot toevoegen aan je website