Dépannage

Repérez le symptôme observé, puis déroulez les vérifications de haut en bas.

Le widget n’apparaît pas

Écartez d’abord les deux situations où le widget ne se charge pas volontairement :

1. Limite mensuelle de messages atteinte. Vérifiez le compteur sur Account. Une fois la limite atteinte, le widget ne s’affiche plus du tout — les visiteurs ne voient rien. Il revient au changement de mois ou après un relèvement du forfait.
2. Mikabot temporairement indisponible. Le widget reste alors également masqué. Le tableau de bord affiche dans ce cas une bannière en haut de page.

Ensuite, l’intégration elle-même :

3. Affichez le code source de la page et cherchez MIKADO_CHATBOT_CONFIG. S’il est absent, le snippet n’a jamais été publié — voir Installer le widget.
4. Vérifiez que Settings → General settings → Active est activé. Les nouveaux chatbots sont créés inactifs.
5. Vérifiez que store_id dans le snippet correspond à la Chatbot key sur Settings → General settings.
6. Videz les caches de votre thème, de vos extensions et de votre CDN, puis rechargez en navigation privée.
7. Ouvrez la console du navigateur et cherchez les erreurs de mikabot-init.js.
8. Si vous utilisez l’option container, vérifiez que l’élément existe dans le DOM avant l’exécution du loader. Si le sélecteur ne correspond à rien, le widget ne s’affiche nulle part.

Le widget s’ouvre mais ne répond pas

1. Envoyez un message de test depuis le lien Demo page sur Settings → General settings. Si la démo fonctionne mais pas votre site, le problème vient de l’intégration.
2. Retrouvez le message en échec dans Chat conversations. Le Response payload enregistré indique généralement la cause.
3. Regardez s’il y a un bandeau en haut du tableau de bord.

Aucun produit n’est proposé

1. Vérifiez que Settings → General settings → Enable ecommerce est activé. Sans cette option, la recherche produit est entièrement désactivée et le menu Ecommerce est masqué.
2. Ouvrez Ecommerce → Products. Si la liste est vide, aucun flux n’a été importé avec succès.
3. Vérifiez qu’il existe des produits dans la langue utilisée par le visiteur. Les produits sont stockés par langue.
4. Examinez Ecommerce → AI configuration → Search Strategy. Category Search Only ne renvoie rien lorsque vos catégories sont vides.
5. Vérifiez Ecommerce → AI configuration → Do not recommend unavailable products. Activée, elle écarte tout ce que votre flux marque en rupture.

L’import d’un flux produit échoue

1. Ouvrez l’URL du flux en navigation privée. Elle doit être accessible publiquement, sans connexion.
2. Faites correspondre le type de flux au fichier : Google Shopping Feed pour du XML, Custom CSV Feed pour du CSV.
3. Chaque article a besoin d’un id unique. Les articles sans identifiant sont ignorés et signalés comme missing id.
4. Pour le XML Google Shopping, ajoutez product_type à chaque article. Sans ce champ, Mikabot ne peut pas construire de catégorie pour cet article.
5. Importez une langue à la fois et comparez les compteurs — Products in Feed et Products in DB.

Liste complète des champs : Référence des champs de flux produit.

Le bot répond dans la mauvaise langue

Le widget choisit sa langue de départ dans cet ordre :

1. La valeur language de votre snippet d’intégration
2. L’attribut lang de votre balise <html>
3. La langue du navigateur du visiteur
4. L’anglais

Les vérifications sont donc :

1. Contrôlez la valeur language de votre snippet.
2. Assurez-vous qu’elle fait partie de celles que Mikabot reconnaît : en, nl, fr, de, es, it. Toute autre valeur est ignorée et l’étape suivante s’applique.
3. Contrôlez votre attribut <html lang> pour la même raison. Une valeur régionale comme en-US ou nl-BE n’est pas reconnue — utilisez le code à deux lettres seul.
4. Vérifiez que la langue est activée sous Settings → Site info → Website Languages.
5. Vérifiez qu’il existe des réponses dans cette langue sous Settings → AI smart responses. Une traduction manquante retombe sur l’anglais.

Quelle que soit la langue de départ, le bot suit le visiteur : écrire en français obtient une réponse en français.

Les transcriptions ne sont pas envoyées par e-mail

1. Activez Settings → General settings → Enable chat e-mail to contact.
2. Remplissez Email Recipients en séparant les adresses par des points-virgules (;), pas par des virgules.
3. La transcription n’est envoyée qu’après qu’un visiteur a fourni une adresse e-mail ou un numéro de téléphone dans le chat.

Toujours bloqué ?

1. Écrivez à [email protected]
2. Indiquez votre chatbot key, l’URL de la page concernée et le symptôme exact
3. Joignez des captures d’écran et les éventuelles erreurs de la console

Nous répondons sous 24 heures les jours ouvrés.