Aller au contenu
Retour à tous les articles d'assistance
Dépannage dépannageerreurswidgetflux

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

  1. 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.
  2. Vérifiez que Settings → Chatbot settings → Active est activé.
  3. Vérifiez que le store_id du code correspond à la Chatbot key dans Settings → Chatbot settings.
  4. Videz les caches du thème, des extensions et du CDN, puis rechargez en navigation privée.
  5. Ouvrez la console du navigateur et cherchez les erreurs de mikabot-init.js.
  6. 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

  1. 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.
  2. 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.
  3. 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.
  4. Consultez Chat conversations pour le message échoué. La réponse enregistrée indique généralement la cause.

Aucun produit n’est suggéré

  1. Vérifiez que Settings → Chatbot settings → Enable ecommerce est activé. Sans cela, la recherche produit est entièrement désactivée.
  2. Ouvrez Ecommerce → Products. Si la liste est vide, aucun flux n’a été importé avec succès.
  3. Vérifiez que des produits existent dans la langue utilisée par le visiteur. Les produits sont stockés par langue.
  4. 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

  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 les catégories et affiche un avertissement indiquant le nombre de produits concernés.
  5. 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

  1. Vérifiez la valeur de language dans votre code d’intégration. Elle définit la langue de départ.
  2. Vérifiez que cette langue est activée dans Settings → Site info → Website Languages.
  3. Ajoutez un attribut lang à la balise <html> de votre site pour que la détection automatique ait un repère.
  4. 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

  1. Activez Settings → Chatbot settings → Enable chat e-mail to contact.
  2. Renseignez 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 laissé son adresse e-mail dans le chat.

Toujours bloqué ?

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

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

Articles associés

Contactez-nous

Notre équipe d'assistance est prête à vous fournir une aide rapide et personnelle lorsque vous en avez besoin.