Een AI-productadviseur embedden in je webshop

Een AI-productadviseur op je webshop embedden

Een goede productadviseur beantwoordt niet alleen de vraag “wat kost dit?”, maar helpt een bezoeker kiezen tussen producten die sterk op elkaar lijken. Dat is precies waar een AI-productadviseur in een webshop waarde kan toevoegen. Hij kan voorkeuren uitvragen, productdetails uitleggen, alternatieven vergelijken en een bezoeker naar de juiste productpagina sturen. Met Fynd plaats je die ervaring als widget op je bestaande storefront, zonder dat je een volledig nieuw verkoopkanaal bouwt.

De techniek achter het embedden is bewust eenvoudig. De voorbereiding is dat niet altijd. Een script tag werkt pas goed wanneer de bot een actuele, bruikbare productcatalogus kan raadplegen. Daarom begint een succesvolle implementatie niet bij JavaScript, maar bij de vraag: kan Fynd betrouwbare antwoorden baseren op je catalogus, content en afspraken over verzending, retouren en voorraad?

In dit artikel krijg je een praktisch implementatieplan voor Shopify, WooCommerce en een custom webshop. Ook behandelen we het testen in de playground, de livegang, privacy en de fouten die teams het vaakst maken.

Begin met een catalogus die advies mogelijk maakt

Fynd gebruikt retrieval-augmented generation, of RAG, om antwoorden te gronden in jouw bronmateriaal. Voor een productadviseur is de catalogus dus geen bijzaak. Als titels, omschrijvingen, varianten of voorraad ontbreken, krijgt de bezoeker hooguit een vriendelijk maar onvolledig antwoord.

Controleer voor je de widget plaatst minstens deze gegevens:

• Producttitel, merk en duidelijke categorie.
• Beschrijving met kenmerken die een koper werkelijk gebruikt om te kiezen, zoals maat, materiaal, compatibiliteit, toepassing of pasvorm.
• Variantinformatie, bijvoorbeeld kleur, inhoud, afmetingen, bundels en SKU.
• Prijs en beschikbaarheid, inclusief de manier waarop uitverkochte varianten worden behandeld.
• Werkende product-URL's die vanuit het antwoord geopend kunnen worden.
• Beleidspagina's voor verzending, retouren, garantie en klantenservice.

Een feed met alleen naam, prijs en afbeelding is vaak prima voor advertising, maar te dun voor advies. De vraag “welke rugzak past als handbagage én heeft ruimte voor een 16-inch laptop?” vraagt om afmetingen, laptopvak en eventueel informatie over airline-regels. Voeg die details toe aan de productinformatie of aan een aanvullende FAQ-bron. Maak ook onderscheid tussen marketingtaal en feitelijke specificaties. “Ultiem comfort” is geen bruikbaar antwoord op een concrete vraag; samenstelling, maatvoering en onderhoudsinstructies zijn dat wel.

Kies je bronnen voordat je het script installeert

De widget is zichtbaar op je website, maar de kwaliteit wordt bepaald door de bronnen die je aan je Fynd-bot koppelt. De meest gebruikte start is een sitemap, aangevuld met een productfeed of API. Daarmee kan Fynd zowel publieke productpagina's als actuele commercegegevens verwerken.

Gebruik een sitemap voor pagina's die goed leesbare context bevatten: collecties, productpagina's, koopgidsen, retourbeleid en veelgestelde vragen. Blogartikelen met BlogPosting of Article structured data zijn bijzonder nuttig, omdat ze keuzehulp en onderhoudsadvies bevatten dat niet in een feed past. Sluit pagina's uit die geen klantwaarde hebben, zoals interne zoekresultaten, accountpagina's, verouderde campagnes of tag-archieven.

Een feed is meestal het beste kanaal voor gestructureerde productvelden. Een API-koppeling past wanneer prijs, voorraad of assortiment vaak wisselen en je controle wilt over velden en synchronisatie. Heb je uitzonderingen die nergens op de site staan, zoals B2B-voorwaarden, installatiehulp of compatibiliteitsmatrixen, voeg dan custom FAQ's toe. Houd elk antwoord feitelijk en onderhoudbaar.

Een praktische bronindeling kan er zo uitzien:

1. Sitemap voor productpagina's, collectiepagina's en beleidspagina's.
2. Productfeed of API voor SKU's, varianten, prijzen en voorraad.
3. Artikelen en koopgidsen voor vragen vóór de aankoop.
4. Een beperkte custom FAQ voor informatie die niet publiceerbaar of niet crawlbaar is.

Laat de catalogus eerst verwerken en controleer een aantal producten in de Fynd-playground. Pas daarna heeft het zin om de widget in je storefront te plaatsen.

Het Fynd-script plaatsen

Nadat je bot en catalogus klaarstaan, levert Fynd een embed snippet die bij jouw bot hoort. Gebruik uitsluitend de snippet uit je Fynd-dashboard. Kopieer geen script van een andere omgeving, testbot of andere shop: de bot-ID en instellingen moeten bij de juiste catalogus en domeinen horen.

De basisinstallatie ziet er doorgaans uit als dit voorbeeld:

<script
  src="https://app.fynd.ai/widget.js"
  data-bot-id="jouw-bot-id"
  async
></script>

De exacte URL en attributen kunnen per Fynd-configuratie verschillen. Behandel het codeblok uit je dashboard daarom als de bron van waarheid. Plaats het script één keer, bij voorkeur vlak voor de afsluitende </body>-tag. Een asynchroon script voorkomt dat de widget de initiële paginarender onnodig blokkeert.

Als je consent management platform scripts blokkeert totdat bezoekers toestemming geven, stem dan met je privacyverantwoordelijke af onder welke categorie de widget valt. Voeg de snippet niet tweemaal toe via zowel een tag manager als de themacode. Dubbele installatie leidt vaak tot twee knoppen, dubbele events of een chat die onvoorspelbaar opent.

Installatie op Shopify

Bij Shopify is de veiligste route meestal een app embed of het toevoegen van het script in de layout van het actieve theme. Kies de route die past bij hoe je themes beheert. Een app embed is handig wanneer je veranderingen via de Theme Editor wilt kunnen in- en uitschakelen. Directe plaatsing in code geeft meer controle, maar moet bij theme-updates worden meegenomen.

Voor een handmatige plaatsing:

1. Dupliceer eerst je gepubliceerde theme.
2. Open in het duplicaat layout/theme.liquid.
3. Voeg de Fynd-snippet vlak voor </body> toe.
4. Publiceer niet meteen; gebruik eerst de theme preview.
5. Test desktop, mobiel, productpagina, collectiepagina en winkelmandje.

Gebruik Shopify's preview-URL om te controleren of de widget alleen op de bedoelde storefront verschijnt. Heb je meerdere markten of talen, controleer dan of elke locale de juiste botconfiguratie, bronnen en antwoordtaal krijgt. Een Nederlandse catalogus met een Engelstalige widget is niet per definitie fout, maar moet een bewuste keuze zijn.

Installatie op WooCommerce en custom storefronts

In WooCommerce kun je de snippet toevoegen via een child theme, een betrouwbare header/footer-plugin of een tag manager die al onderdeel is van jullie releaseproces. Bewerk niet zomaar het parent theme: een update kan je aanpassing overschrijven. Bij een cache-plugin moet je na publicatie de relevante page cache en CDN-cache verversen.

Een custom storefront heeft meestal een centrale HTML-layout, server-rendered template of React/Vue-shell. Voeg het script toe aan die gedeelde layout, zodat het op de gewenste routes geladen wordt. Bij single-page applications is een eenmalige plaatsing in de root document template doorgaans voldoende. Controleer wel of routewisselingen de widget niet dupliceren en of de knop niet achter een modal, cookie-banner of mobiele navigatie verdwijnt.

Gebruik een environment-variabele of feature flag wanneer je deploymentstraat dat ondersteunt. Zo kun je de widget eerst op staging activeren en later gericht in productie inschakelen. Zet de bot-ID nooit hardcoded in meerdere losse componenten; één configuratiepunt maakt een rollback en botwissel aanzienlijk veiliger.

Test eerst in de playground

De Fynd-playground is je inhoudelijke testomgeving. Daar test je niet alleen of de bot antwoord geeft, maar vooral of hij advies geeft op basis van jouw bronnen. Maak vóór de livegang een kleine testset met echte klantvragen uit support, site search, reviews en salesgesprekken.

Neem minstens deze categorieën op:

• Een brede oriënterende vraag: “Welke optie is geschikt voor beginners?”
• Een vraag met meerdere criteria: “Ik zoek iets waterdichts, lichts en onder €100.”
• Een vergelijkingsvraag tussen twee producten.
• Een variant- of compatibiliteitsvraag.
• Een vraag over retouren of levering.
• Een vraag waarop de bot níet moet gokken, bijvoorbeeld een ontbrekende producteigenschap.

Leg per vraag vast wat een acceptabel antwoord is. Controleer of productnamen en links kloppen, of de bot onzekerheid benoemt wanneer gegevens ontbreken en of hij niet doet alsof voorraad of levertijd gegarandeerd is wanneer de bron verouderd kan zijn. Test ook Nederlands en Engels wanneer je beide talen bedient. De beste verbetering is vaak niet een langere prompt, maar een ontbrekende specificatie toevoegen aan de bron.

Checklist voor livegang

Een technische installatie is pas geslaagd wanneer bezoekers de widget kunnen vinden, begrijpen en vertrouwen. Loop deze checklist af voordat je de feature aanzet:

• De juiste Fynd-bot is gekoppeld aan het productiedomein.
• Catalogusbronnen zijn succesvol verwerkt en recente wijzigingen zijn gesynchroniseerd.
• Productlinks openen op het juiste domein en in de juiste taal.
• Welkomsttekst, toon en fallback voor onbekende antwoorden zijn afgestemd op je merk.
• De widget is toegankelijk op mobiel, tablet en desktop.
• De knop bedekt geen checkoutactie, cookie-banner of andere belangrijke interface.
• Je privacytekst en consent-configuratie zijn gecontroleerd.
• Teamleden weten waar ze leads, gesprekken en analytics terugvinden.
• Er is een eigenaar voor het beoordelen van gemiste vragen en bronupdates.
• Je kent de snelle rollback: script of feature flag uitzetten.

Start eventueel op product- en collectiepagina's voordat je de widget overal toont. Dat beperkt risico en maakt het eenvoudiger om het effect op koopvragen te beoordelen. Fynd biedt een 14-daagse Starter-trial om deze eerste implementatie en evaluatie in een echte storefront te doorlopen.

Veelgemaakte fouten

De eerste fout is de widget live zetten vóór de catalogus klaar is. De interface werkt dan, maar antwoorden blijven algemeen. De tweede fout is te veel bronnen zonder selectie importeren. Oude blogs, tijdelijke sale-pagina's en dubbele product-URL's geven tegenstrijdige context. Kies relevante URL's en onderhoud ze.

Ook een te brede rolbeschrijving veroorzaakt problemen. Een productadviseur hoeft niet elk klantenserviceprobleem, iedere orderstatus en elk juridisch verzoek af te handelen. Definieer wat de bot wel doet, wanneer hij naar contact of een beleidspagina verwijst en welke claims hij nooit mag doen. Vermijd bijvoorbeeld absolute uitspraken over medische geschiktheid, veiligheid, levertijden of productcompatibiliteit als je bronnen daar geen bewijs voor geven.

Tot slot: beoordeel succes niet alleen op het aantal chats. Kijk in Fynd-analytics naar populaire vragen, productinteresse, leads en terugkerende onderwerpen zonder goed antwoord. Die signalen vertellen je welke catalogusvelden of content je moet verbeteren.

Privacy, consent en verantwoord gebruik

Een AI-widget verwerkt gesprekken. Geef bezoekers daarom helder aan wat de widget doet, welke informatie ze beter niet delen en waar ze het privacybeleid vinden. Vraag niet om persoonsgegevens als die niet nodig zijn voor productadvies. Als je leads verzamelt, maak dan expliciet welke gegevens worden gevraagd, waarom en hoe toestemming wordt vastgelegd.

Bespreek met je privacy- en securityteam welke verwerkingsovereenkomst, bewaartermijnen, subverwerkers en consentinstellingen op jullie situatie van toepassing zijn. Plaats geen ordergegevens, klantprofielen of geheime interne documentatie in een publieke botbron zonder passende toegangscontrole. Een productadviseur is het sterkst wanneer hij rijk is aan productkennis, niet wanneer hij onnodig veel klantdata kent.

Van embed naar een blijvend kanaal

Na livegang begint het echte werk. Bekijk wekelijks gesprekken en analytics, groepeer vragen zonder passend antwoord en verbeter eerst de bron die ontbreekt. Maak koopgidsen voor terugkerende keuzevragen, verrijk feeds met specificaties en voeg alleen waar nodig een custom FAQ toe. Zo wordt de bot in de loop van tijd concreter in plaats van alleen uitgebreider.

Begin met de Starter-trial van 14 dagen om cataloguskwaliteit, embed en vragenpatronen te valideren. Kies daarna een Fynd-plan dat past bij je gebruik: Starter voor de eerste productadvieservaring, Growth voor een groeiende operationele inzet en Pro wanneer je meer schaal, bots of governance nodig hebt. De widget is slechts één script tag; een betrouwbare AI-productadviseur is een doorlopend proces van goede data, duidelijke grenzen en leren van echte koopvragen.