Passer au contenu principal
ChattyBox Logo

Dépannage

Utilisez cette page lorsque le widget est installé mais ne se comporte pas comme prévu.

Le widget n'apparaît pas​

Vérifiez d'abord la console du navigateur. ChattyBox y signale des attributs requis manquants.

Causes courantes :

  • Le script n'est pas présent dans la source de la page déployée.
  • Le script a été ajouté au mauvais modèle, mise en page, conteneur de gestionnaire de balises ou zone de code CMS.
  • Le script est à l'origine d'une règle de consentement ou d'un déclencheur de gestionnaire de balises qui ne s'est pas déclenché.
  • Le même shell d'application supprime le script lors de la navigation côté client.
  • Une politique de sécurité du contenu bloque https://chattybox.ai/widget.js.
  • CSS ou un autre widget chevauche le lanceur.

La plus petite correction :

  1. Ouvrez la page publique déployée dans une fenêtre de navigation privée.
  2. Recherchez la source de la page pour chattybox.ai/widget.js.
  3. Confirmez que le script apparaît une fois et inclut data-api-key et data-api-url.
  4. Déplacez le script vers le pied de page global, la présentation de l'application, la racine Docusaurus ou le déclencheur GTM Toutes les pages s'il est manquant.

data-api-url manquant​

Le widget se ferme plus tôt lorsque data-api-url est manquant.

Utilisez l'extrait complet du tableau de bord ou ajoutez l'attribut requis :

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="https://app.chattybox.ai"
  async
></script>

Si votre tableau de bord affiche une URL API différente, utilisez la valeur du tableau de bord au lieu de l'exemple de valeur.

Clé API non valide ou erreurs d'origine​

Causes courantes :

  • La clé publique du widget n'a pas été copiée correctement.
  • La clé a été supprimée, expirée ou créée pour un autre projet.
  • Une clé intermédiaire a été déployée en production ou une clé de production a été déployée en production.
  • La clé a autorisé les origines et l’origine actuelle du site n’est pas incluse.
  • La page est chargée à partir de http://localhost, d'une URL d'aperçu ou d'un domaine personnalisé qui n'est pas autorisé pour cette clé.

Correctifs :

  1. Ouvrez le projet dans le tableau de bord ChattyBox.
  2. Copiez un nouvel extrait à partir de l'onglet Intégrer.
  3. Si des origines autorisées sont configurées, ajoutez l'origine exacte qui dessert la page, y compris le protocole et le nom d'hôte.
  4. Redéployez ou republiez le site et testez à nouveau dans une fenêtre de navigation privée.

Mauvaise langue​

Le widget choisit la langue dans cet ordre :

  1. data-locale sur le script du widget.
  2. La valeur <html lang> de la page.
  3. La langue du navigateur du visiteur.
  4. Repli anglais.

Correctifs :

  • Supprimez une valeur data-locale incorrecte si la page doit détecter automatiquement la langue.
  • Définissez <html lang="de">, <html lang="fr"> ou le code de langue correspondant sur les pages localisées.
  • Ajoutez data-locale="de" uniquement lorsqu'une page doit forcer une langue d'interface utilisateur de widget spécifique.
  • Re-grattez toutes les versions linguistiques si les réponses citent ou récupèrent du contenu dans la mauvaise langue.

Aucune citation ou réponse faible​

ChattyBox réponses à partir du contenu indexé. Des citations manquantes ou des réponses faibles signifient généralement que le contenu source nécessaire n'a pas été récupéré ou ne répond pas clairement à la question.

Correctifs :

  • Posez la même question dans le chat de test du tableau de bord et comparez les pages citées.
  • Assurez-vous que la page source est publique et incluse dans l'analyse.
  • Ajoutez des titres clairs, des exemples, des FAQ et un texte de réponse directe à la page source.
  • Évitez de vous fier aux captures d'écran, aux vidéos, aux accordéons cachés ou au contenu iframe comme seule source.
  • Re-grattez la page mise à jour, puis testez à nouveau.

Pages non grattées ou contenu périmé​

Causes courantes :

  • La page est absente du plan du site soumis.
  • Le mode URL manuel n’incluait pas la page.
  • La page redirige, bloque les robots d'exploration, nécessite une authentification ou est exclue par les règles des robots.
  • Le contenu de la page a changé après le dernier scratch.
  • Le contenu est rendu de manière à ce que le robot ne puisse pas extraire de texte utile.

Correctifs :

  1. Confirmez que la page s'ouvre publiquement dans une fenêtre de navigateur privée.
  2. Utilisez le mode plan du site pour une large couverture ou des URL manuelles pour un ensemble organisé.
  3. Soumettez l'URL canonique plutôt qu'une URL de suivi, une URL de redirection ou une URL de connexion.
  4. Re-grattez après la publication des modifications de contenu.
  5. Vérifiez le tableau de bord pour les pages ayant échoué ou ignorées.

Toujours coincé​

Recueillez ces informations avant de contacter l'assistance :

  • L'URL de la page publique où le widget doit apparaître.
  • Une capture d'écran ou une copie de toute erreur de la console du navigateur.
  • Si la page utilise un simple HTML, Next.js, Docusaurus, WordPress, un CMS ou Google Tag Manager.
  • Indique si l'extrait inclut data-api-key et data-api-url.
  • Une question test qui devrait fonctionner et la page source qui y répond.