WooCommerce-koppeling

Koppel je webshop aan een agent en je hele productcatalogus komt automatisch in je chatbot terecht. De bot kan dan adviseren over je producten, en toont ze als kaartjes met foto, prijs, voorraad en een link naar het product — bij een eenvoudig product zelfs met een knop om het direct in het winkelmandje te leggen.

Je hoeft niets te installeren en geen sleutels aan te maken: je plakt het adres van je webshop in het dashboard, en Denkchat leest je catalogus uit het openbare productoverzicht dat WooCommerce zelf al aanbiedt (de Store API).

Wat je nodig hebt

• Een WooCommerce-webshop waarvan het openbare productoverzicht bereikbaar is. Bij de meeste winkels staat dat gewoon aan. Is dat bij jou niet zo — een securityplugin of een strenge firewall kan het blokkeren — dan zie je dat meteen bij het koppelen, in plaats van dat het stil misgaat.
• Een betaald plan met de WooCommerce-add-on. Alleen de eigenaar van het project kan die add-on activeren: de betaling loopt via het account van de eigenaar.
• De rol eigenaar of editor in het project om te koppelen en de koppeling te beheren. Kijkers kunnen de koppeling wel zien, maar niet wijzigen.

Wat je níét nodig hebt: een plugin, een API-sleutel of toegang tot je server.

Zo koppel je je webshop

1. Ga in het dashboard naar je agent → Instellingen → Integraties.
2. Vul het adres van je webshop in, bijvoorbeeld https://jouwshop.nl, en klik op Koppel je webshop.
3. Denkchat controleert eerst of er op dat adres een leesbare productlijst staat. Zo niet, dan krijg je te lezen wat er misging — bijvoorbeeld dat je winkel doorverwijst naar https://www.jouwshop.nl en je dus dát adres moet gebruiken.
4. Klopt het adres, dan begint de eerste import meteen. Vaak staan je eerste producten er al zodra het scherm terugkomt; anders zie je dat ze opgehaald worden.

Daarna staat er een statuskaart met je shopadres, hoeveel producten er zijn geïmporteerd, en wanneer de catalogus voor het laatst is bijgewerkt.

Zodra er bij het koppelen (of bij Nu synchroniseren) producten binnenkomen, zet Denkchat de productkaarten voor deze agent aan — je bot kan er dan direct mee adviseren. Staat de schakelaar Productkaarten & filter onverhoopt toch uit, dan zet je hem zelf aan bij Instellingen → Chat Interface.

Wat er per product wordt overgenomen

Niet elke eigenschap wordt een filter; daar zijn twee dingen voor nodig.

Het moet om te beginnen een globale eigenschap zijn: eentje die je in WooCommerce onder Producten → Eigenschappen hebt aangemaakt en daarna aan je producten hangt. Typ je een eigenschap rechtstreeks op één product in, dan kent je winkel hem verder nergens en kunnen wij er ook niet op filteren. Hij gaat niet verloren — hij komt als tekst mee, zodat de bot er wel over kan vertellen.

En de lijst waarden moet kort en opsombaar zijn (maat, kleur, huidtype). Een lange lijst met lange waarden — een ingrediëntenlijst is het klassieke voorbeeld — komt om dezelfde reden als tekst mee in plaats van als filter.

Bij een product met varianten (maten, kleuren) komt het hoofdproduct binnen met een vanaf-prijs. Prijzen per losse variant komen niet mee — de bot verwijst daarvoor naar de productpagina in plaats van een bedrag te noemen dat misschien niet klopt.

Wat er automatisch gebeurt

Elk uur kijkt Denkchat of er voor jouw koppeling iets te doen is, en dagelijks wordt je catalogus helemaal doorlopen. Dan gebeurt er dit:

• nieuwe producten komen erbij;
• producten die uit je shop verdwenen zijn worden verwijderd;
• prijzen, aanbiedingen en voorraad worden bijgewerkt.

Wat niet veranderd is, wordt overgeslagen. Dat scheelt tijd, en het betekent ook dat een dagelijkse ronde bij een stabiele catalogus vrijwel niets doet.

Staat een import halverwege, dan gaat hij in de volgende ronde verder waar hij gebleven was — hij begint niet elke keer opnieuw. Is het druk, dan kan een ronde een uurtje opschuiven; je catalogus blijft ondertussen gewoon werken.

Wat je zelf kunt regelen

• Nu synchroniseren — draait meteen een ronde, bijvoorbeeld nadat je een prijs hebt aangepast en dat direct in de bot wilt zien. Loopt er op dat moment al een ronde, dan krijg je dat te zien en hoef je niets te doen.
• Automatisch bijwerken uitzetten — met de schakelaar onderaan de kaart. Je catalogus blijft dan staan zoals hij is; je werkt hem alleen nog handmatig bij.
• Ontkoppelen — haalt de koppeling en de geïmporteerde producten weg.

Grenzen, eerlijk

Hoeveel producten je plan toestaat

Zit je erboven, dan importeren we de eerste producten tot je limiet en zie je een melding met hoeveel dat er zijn. De rest blijft buiten de bot tot je upgradet. Bestaande producten blijven wél bijgewerkt worden.

Productteksten tellen mee in je kennisbank

Elk product levert ook een stukje tekst voor je kennisbank op, en dat telt mee in de opslagruimte van je plan. Raakt die vol tijdens een import, dan komen de producten zelf nog binnen maar stoppen we met de productteksten, met een melding erbij.

Eén webshop per agent

Wil je een ándere webshop koppelen? Ontkoppel dan eerst de huidige. Doe je dat niet, dan blijven de producten van de vorige shop staan en loopt de eerste ronde vast op onze beveiliging tegen massaal verwijderen (zie hieronder).

Een grote catalogus komt over meerdere rondes binnen

Bij duizenden producten duurt de eerste import meerdere rondes van een uur. Ondertussen werkt je bot gewoon met wat er al binnen is.

Als er iets misgaat

Op de statuskaart staat wat er aan de hand is. De meest voorkomende meldingen:

Staat er een halve ronde open die niet meer vordert, dan verschijnt er een knop Opnieuw proberen. Die begint de synchronisatie schoon opnieuw.

Liever zelf pushen?

Werk je met een eigen webshop of een ander systeem, dan kun je producten ook zelf naar Denkchat sturen met een API-sleutel — zie Product Sync API. API-toegang hoort bij het Standard-plan en hoger; op Hobby is de WooCommerce-koppeling hierboven de enige manier om producten binnen te krijgen. Voor een gewone WooCommerce-winkel is die koppeling sowieso eenvoudiger: ze houdt zichzelf bij, en je hoeft geen sleutel te beheren.