Dépannage

Problèmes courants et comment les résoudre. Pour chaque problème, commencez par la première solution suggérée — c'est la cause la plus probable.

Vérifiez le tableau de bord — Ouvrez l'URL de votre tableau de bord directement. S'il ne se charge pas, le serveur est peut-être hors ligne — contactez votre gestionnaire de compte.
Vérifiez data-bot-id — L'ID du bot dans votre code d'intégration doit correspondre au slug réel de votre bot. Vérifiez dans Tableau de bord → Intégration.
Vérifiez data-backend-url — Doit inclure le protocole (https://) et le domaine correct.
Vérifiez la console du navigateur — Ouvrez les outils de développement (F12) → Console pour voir les erreurs JavaScript.

Vérifiez l'indicateur de santé du LLM — S'il est rouge, OpenRouter est déconnecté. Allez dans Paramètres → Moteur IA et reconnectez-vous.
Vérifiez qu'un modèle est sélectionné — Un modèle d'IA doit être choisi dans le menu déroulant.
Vérifiez la base de connaissances — Si elle est vide, le bot peut répondre de manière générique ou pas du tout. Ajoutez du contenu dans la Base de connaissances.

L'historique du chat ne persiste pas après le rechargement de la page

Le LocalStorage doit être activé — Le widget stocke les données de session dans le localStorage du navigateur. Le mode privé/incognito peut bloquer cela.
L'ID du bot doit être cohérent — Si le data-bot-id diffère d'une page à l'autre, le widget les traite comme des bots distincts avec des historiques séparés.

Attendez la propagation DNS — Les changements peuvent prendre de 5 à 30 minutes.
Vérifiez l'enregistrement A — Vérifiez le panneau de contrôle de votre fournisseur DNS pour confirmer que l'enregistrement A pointe vers l'IP de votre serveur.
Essayez de renouveler le SSL — Allez dans Paramètres → Domaine personnalisé → Renouveler le SSL.
Utilisateurs Cloudflare — Assurez-vous que le mode SSL est réglé sur Full (Strict).
Contactez votre gestionnaire de compte si le problème persiste après la propagation du DNS.

Vérifiez l'indicateur de santé de la DB — Il doit être vert en haut de la page.
Actualisez la page — Les paramètres sont mis en cache ; une actualisation force une relecture.
Contactez votre gestionnaire de compte si l'indicateur DB est rouge.

Vérifiez les indicateurs de santé — Si DB ou VEC est rouge, un service backend nécessite une attention particulière.
Actualisez la page — Les données n'ont peut-être pas été chargées lors de la première visite.
Contactez votre gestionnaire de compte si les indicateurs restent rouges.

Vérifiez les identifiants — Les clés API, mots de passe SMTP et URL de webhooks doivent être à jour.
Consultez les journaux d'activité — Filtrez par le module Intégrations pour des messages d'erreur détaillés.
Testez le service externe — Confirmez que le point de terminaison du webhook, le serveur SMTP ou l'API est accessible.

Vérifiez les tâches de synchronisation — Les fichiers/URL peuvent être encore en cours de traitement. Attendez le statut Terminé.
Actualisez la base de connaissances — Allez dans Base de connaissances et cliquez sur Actualiser.
Examinez le prompt système — Des instructions contradictoires dans Paramètres → Comportement du modèle peuvent ignorer la récupération dans la base de connaissances.
Ajoutez des FAQ — Pour les questions critiques, ajoutez une FAQ avec la réponse exacte. Les FAQ sont prioritaires.

Vérifiez le statut du service WhatsApp — Allez dans Paramètres → WhatsApp et vérifiez que le service est En cours d'exécution.
Vérifiez l'état de l'API — L'indicateur de statut doit être vert.
Vérifiez la session via code QR — En cas de déconnexion, scannez à nouveau le code QR.
Contactez votre gestionnaire de compte si le service ne démarre pas.

Passez à un modèle d'IA plus rapide — Gemini Flash ou Claude Haiku pour une latence plus faible. Voir Modèles d'IA.
Réduisez le nombre max de jetons (tokens) — Diminuez la limite de longueur de réponse dans Paramètres → Comportement du modèle.
Allégez la base de connaissances — Supprimez les documents obsolètes pour accélérer la recherche.
Ajoutez des FAQ — Les questions courantes résolues par les FAQ ignorent totalement le modèle d'IA.
Contactez votre gestionnaire de compte si la lenteur persiste — le serveur peut avoir besoin d'une mise à niveau des ressources.

Consultez les journaux d'activité dans le tableau de bord pour les messages d'erreur.
Contactez votre gestionnaire de compte avec une description du problème et les messages d'erreur que vous voyez.