Integratie met een productfeed (XML, Google Merchant)

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

Belangrijk: best practices voor e-commerce

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

Wat de integratie biedt

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

• Productnaam en beschrijving
• Prijs (en de aanbiedingsprijs wanneer deze in de feed staat)
• Productafbeelding
• Directe link naar de productpagina in je webshop
• Merk, beschikbaarheid, GTIN / SKU en andere kenmerken uit de feed

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

Gepland vernieuwen - De catalogus wordt vernieuwd volgens het schema dat je instelt, zodat nieuwe producten, prijzen en voorraadwijzigingen automatisch bij de chatbot terechtkomen zonder dat je iets hoeft te doen.

Wat de integratie niet biedt

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

• de status van een bestelling controleren
• producten aan het winkelmandje toevoegen of een bestelling plaatsen
• live voorraadniveaus tussen vernieuwingen door uitlezen

Productkaarten linken altijd direct naar je webshop, waar de klant de aankoop afrondt. Als je functies zoals het volgen van bestellingen of het toevoegen aan het winkelmandje nodig hebt, gebruik dan een native integratie.

Vereisten

• De integratie Feed XML inbegrepen in je abonnement
• Het productpakket AI Search product pack toegewezen aan de chatbot: dit bepaalt hoeveel producten er geïndexeerd kunnen worden
• Een productfeed in het XML-formaat van Google Merchant (Google Shopping), beschikbaar op een openbaar https-adres. Gecomprimeerde feeds (.gz) en feeds die beveiligd zijn met een gebruikersnaam en wachtwoord worden ondersteund.

Stap 1: Haal de productfeed op uit je webshop

De meeste platforms exporteren standaard of via een gratis extensie al een Google Merchant-feed:

• 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 - Marketing and integrations, Price comparison sites and marketplaces, Google Merchant: schakel de feed in en kopieer het adres
• OpenCart - Extensions, Feeds, Google Base: schakel deze in en kopieer de datafeed-URL
• BigCommerce - Channel Manager, Google Shopping, of een feed-app uit de BigCommerce App Marketplace
• Shopware - Marketing, Product comparisons, Google Shopping: maak de export aan en kopieer de URL
• osCommerce en maatwerkwebshops - elke module die een RSS 2.0- of Atom-feed genereert met de g:-productkenmerken

De feed moet minimaal een product-ID (g:id), een naam en een link bevatten. Prijs, afbeelding, beschrijving, beschikbaarheid en producttype zorgen voor aanzienlijk betere antwoorden.

Stap 2: Koppel de feed in ChatLab

1. Log in bij 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 (Feed-URL)
5. Als de feed inloggegevens vereist, schakel dan The feed requires a username and password (De feed vereist een gebruikersnaam en wachtwoord) in en vul de gegevens in
6. Stel eventueel de Product language (Producttaal) in (tweeletterige taalcode van de taal die in de feed wordt gebruikt)
7. Klik op Test feed (Feed testen) - ChatLab downloadt het begin van de feed en toont het formaat, het aantal gevonden producten, de eerste producten zoals ze geïndexeerd zullen worden en eventuele waarschuwingen (ontbrekende prijzen, links, afbeeldingen of categorieën)
8. Klik op Connect (Koppelen)

Na een succesvolle koppeling begint ChatLab op de achtergrond met het indexeren van de catalogus. Afhankelijk van de grootte van de feed duurt dit van een minuut tot enkele tientallen minuten. Je kunt de voortgang volgen onder Training > E-commerce catalog (Catalogus e-commerce).

Stap 3: Niet-standaard feeds (velden toewijzen)

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

1. Klik eerst op Test feed (Feed testen) - de elementnamen die in je bestand worden gevonden, verschijnen in de dropdownmenu's voor toewijzing
2. Open Field mapping for non-standard feeds (Veldtoewijzing 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, vereist), Product name (Productnaam), Description (Beschrijving), Product page URL (Productpagina-URL), Image URL (Afbeeldings-URL), Price (Prijs), Category path (Categoriepad) en de overige velden
5. Klik opnieuw op Test feed (Feed testen) en controleer de voorbeeldproducten
6. Klik op Connect (Koppelen)

Velden die op "Default (Google Merchant)" blijven staan, behouden de standaardnamen. Een feed die aan de standaarden voldoet, heeft dus helemaal geen handmatige toewijzing nodig.

Stap 4: Schema voor vernieuwen

1. Ga naar Training > E-commerce catalog (Catalogus e-commerce)
2. Klik op de kaart 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 (dagelijks, wekelijks of maandelijks), 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 worden ook uit de catalogus van de chatbot verwijderd. Het geplande vernieuwingsschema volgt de mogelijkheden van je abonnement: wekelijkse en maandelijkse schema's vereisen de functie voor gepland opnieuw trainen, dagelijkse schema's vereisen de functie voor dagelijks opnieuw trainen.

Stap 5: De AI-actie configureren

Na het koppelen wordt de actie Feed XML - AI product search automatisch ingeschakeld voor chatbots met het AI Search-product. Ga naar Settings > Actions (Instellingen > Acties) en filter op het platform Feed XML om dit aan te passen. Je kunt het label van de actie en de instructies voor de AI wijzigen, en Include product card (Productkaart toevoegen) inschakelen zodat de chatbot de volledige productkaart toont in plaats van alleen een korte beschrijving.

Je integratie testen

Open je chatbotwidget en probeer bijvoorbeeld:

• "Laat me waterkokers onder de 50 dollar zien" (test het zoeken met een prijsfilter)
• "Hebben jullie blauwe katoenen t-shirts?" (test het matchen op kenmerken)

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

Handige tips

• Voeg het producttype in de feed toe (g:product_type) als een volledig pad, bijvoorbeeld "Kleding > Heren > T-shirts" - dit wordt de categorie waarop de chatbot kan filteren
• Zorg voor volledige productbeschrijvingen in de feed; de chatbot gebruikt deze om vragen van klanten te matchen
• Varianten van hetzelfde product moeten hetzelfde item_group_id delen - ChatLab toont ze dan als één product met alle beschikbare kleuren en maten
• Bij een grote feed zorgt een gecomprimeerde feed (.gz) voor snellere downloads

De chatbot op je webshop installeren

Om de chatwidget aan je webshop toe te voegen:

1. Ga in ChatLab naar het tabblad Deploy (Implementeren) bij jouw bot
2. Kopieer het codefragment
3. Plak het in het sjabloon van je webshop, vlak voor de afsluitende </body>-tag, of gebruik het veld voor aangepaste HTML of scripts van je e-commerceplatform