Probleemoplossing

Zoek het symptoom dat je ziet en werk de controles van boven naar beneden af.

De widget verschijnt niet

Sluit eerst de twee situaties uit waarin de widget met opzet niet laadt:

1. Maandelijkse berichtenlimiet bereikt. Controleer het aantal berichten op Account. Zodra de limiet bereikt is, wordt de widget helemaal niet weergegeven — bezoekers zien niets. Hij komt terug bij de maandwissel of bij een hoger abonnement.
2. Mikabot tijdelijk onbeschikbaar. De widget blijft dan ook verborgen. Het dashboard toont in dat geval een banner bovenaan de pagina.

Daarna de embed zelf:

3. Bekijk de paginabron en zoek op MIKADO_CHATBOT_CONFIG. Ontbreekt die, dan is het snippet nooit gepubliceerd — zie De widget installeren.
4. Controleer of Settings → General settings → Active aan staat. Nieuwe chatbots worden inactief aangemaakt.
5. Controleer of store_id in het snippet overeenkomt met de Chatbot key op Settings → General settings.
6. Leeg de caches van je thema, plugins en CDN en herlaad in een privévenster.
7. Open de browserconsole en kijk naar fouten van mikabot-init.js.
8. Gebruik je de optie container, controleer dan of het element in de DOM bestaat voordat de loader draait. Komt de selector met niets overeen, dan wordt de widget nergens weergegeven.

De widget opent maar antwoordt niet

1. Stuur een testbericht via de Demo page-link op Settings → General settings. Werkt de demo wel en je site niet, dan zit het probleem in de embed.
2. Zoek het mislukte bericht op in Chat conversations. De opgeslagen Response payload noemt meestal de oorzaak.
3. Kijk naar een melding bovenaan het dashboard.

Er worden geen producten voorgesteld

1. Controleer of Settings → General settings → Enable ecommerce aan staat. Zonder die schakelaar is productzoeken volledig uitgeschakeld en is het menu Ecommerce verborgen.
2. Open Ecommerce → Products. Is de lijst leeg, dan is er geen feed succesvol geïmporteerd.
3. Controleer of er producten bestaan voor de taal die de bezoeker gebruikt. Producten worden per taal opgeslagen.
4. Bekijk Ecommerce → AI configuration → Search Strategy. Category Search Only geeft niets terug als je categorieën leeg zijn.
5. Controleer Ecommerce → AI configuration → Do not recommend unavailable products. Staat die aan, dan wordt alles overgeslagen wat je feed als niet op voorraad markeert.

Een productfeed-import mislukt

1. Open de feed-URL in een privévenster. Hij moet publiek bereikbaar zijn zonder login.
2. Laat het feedtype bij het bestand passen: Google Shopping Feed voor XML, Custom CSV Feed voor CSV.
3. Elk item heeft een unieke id nodig. Items zonder worden overgeslagen en gemeld als missing id.
4. Voeg bij Google Shopping XML product_type toe aan elk item. Zonder dat veld kan Mikabot geen categorie voor dat item aanmaken.
5. Importeer één taal tegelijk en vergelijk de tellers — Products in Feed versus Products in DB.

Volledige veldenlijst: Referentie productfeedvelden.

De bot antwoordt in de verkeerde taal

De widget kiest zijn starttaal in deze volgorde:

1. De waarde language in je embed-snippet
2. Het lang-attribuut op je <html>-tag
3. De browsertaal van de bezoeker
4. Engels

De controles zijn dus:

1. Controleer de waarde language in je embed-snippet.
2. Zorg dat het een waarde is die Mikabot herkent: en, nl, fr, de, es, it. Al het andere wordt genegeerd en de volgende stap in de volgorde geldt.
3. Controleer om dezelfde reden je <html lang>-attribuut. Een regionale waarde zoals en-US of nl-BE wordt niet herkend — gebruik de kale tweeletterige code.
4. Controleer of de taal geactiveerd is onder Settings → Site info → Website Languages.
5. Controleer of er responses bestaan in die taal onder Settings → AI smart responses. Een ontbrekende vertaling valt terug op het Engels.

Wat de starttaal ook is, de bot volgt de bezoeker: wie in het Frans schrijft krijgt een Frans antwoord.

Chattranscripties worden niet gemaild

1. Zet Settings → General settings → Enable chat e-mail to contact aan.
2. Vul Email Recipients in en scheid meerdere adressen met puntkomma’s (;), niet met komma’s.
3. De transcriptie wordt pas verstuurd nadat een bezoeker een e-mailadres of telefoonnummer in de chat achterlaat.

Nog steeds vast?

1. Mail [email protected]
2. Vermeld je chatbot key, de betreffende pagina-URL en het exacte symptoom
3. Voeg screenshots en eventuele browserconsolefouten toe

We reageren binnen 24 uur op werkdagen.