Dépannage
Repérez le symptôme observé, puis parcourez les vérifications de haut en bas. Les premières sont celles qui échouent le plus souvent.
Le widget ne s’affiche pas
- Affichez le code source de la page et cherchez
MIKADO_CHATBOT_CONFIG. S’il est absent, le code n’a jamais été publié — voir Installer le widget. - Vérifiez que Settings → Chatbot settings → Active est activé.
- Vérifiez que le
store_iddu code correspond à la Chatbot key dans Settings → Chatbot settings. - Videz les caches du thème, des extensions et du CDN, puis rechargez en navigation privée.
- Ouvrez la console du navigateur et cherchez les erreurs de
mikabot-init.js. - Vérifiez que le widget n’est pas dans un conteneur masqué par défaut par votre thème.
Le widget s’ouvre mais ne répond pas
- Consultez votre compteur de messages sur Account. Une fois la limite de l’offre atteinte, les réponses s’arrêtent jusqu’à la remise à zéro de la période ou une montée en offre.
- Repérez une bannière rouge ou orange en haut du tableau de bord — elle signale les limites d’utilisation et les indisponibilités du fournisseur d’IA.
- Envoyez un message de test via le lien Demo page dans Settings → Chatbot settings. Si la démo fonctionne mais pas votre site, le problème vient de l’intégration.
- Consultez Chat conversations pour le message échoué. La réponse enregistrée indique généralement la cause.
Aucun produit n’est suggéré
- Vérifiez que Settings → Chatbot settings → Enable ecommerce est activé. Sans cela, la recherche produit est entièrement désactivée.
- Ouvrez Ecommerce → Products. Si la liste est vide, aucun flux n’a été importé avec succès.
- Vérifiez que des produits existent dans la langue utilisée par le visiteur. Les produits sont stockés par langue.
- Contrôlez Ecommerce → AI configuration → Search Strategy. Category Only ne renvoie rien si vos catégories sont vides.
L’import d’un flux produits échoue
- Ouvrez l’URL du flux en navigation privée. Elle doit être accessible publiquement, sans connexion.
- Faites correspondre le type de flux au fichier : Google Shopping Feed pour du XML, Custom CSV Feed pour du CSV.
- Chaque article a besoin d’un
idunique. Les articles sans identifiant sont ignorés et signalés comme missing id. - Pour le XML Google Shopping, ajoutez
product_typeà chaque article. Sans ce champ, Mikabot ne peut pas construire les catégories et affiche un avertissement indiquant le nombre de produits concernés. - Importez une langue à la fois et comparez les compteurs — Products in Feed contre Products in DB.
Liste complète des champs : Référence des champs de flux produits.
Le bot répond dans la mauvaise langue
- Vérifiez la valeur de
languagedans votre code d’intégration. Elle définit la langue de départ. - Vérifiez que cette langue est activée dans Settings → Site info → Website Languages.
- Ajoutez un attribut
langà la balise<html>de votre site pour que la détection automatique ait un repère. - Vérifiez que des réponses IA existent dans cette langue sous Settings → AI responses.
Les transcriptions de chat n’arrivent pas par e-mail
- Activez Settings → Chatbot settings → Enable chat e-mail to contact.
- Renseignez Email Recipients en séparant les adresses par des points-virgules (
;), pas par des virgules. - La transcription n’est envoyée qu’après qu’un visiteur a laissé son adresse e-mail dans le chat.
Toujours bloqué ?
- Écrivez à [email protected]
- Indiquez votre clé de chatbot, l’URL de la page concernée et le symptôme exact
- Joignez des captures d’écran et les éventuelles erreurs de console
Nous répondons sous 24 heures les jours ouvrés.
Articles associés
Transfert vers un humain
Orientez les visiteurs vers votre équipe quand le bot doit s'effacer, et conservez la conversation.
Analyses et optimisation
Lisez le tableau de bord Mikabot et transformez ses chiffres en actions concrètes.
Configuration du compte
Créez votre compte Mikabot, vérifiez votre e-mail et prenez vos repères dans le tableau de bord.
Contactez-nous
Notre équipe d'assistance est prête à vous fournir une aide rapide et personnelle lorsque vous en avez besoin.