Dépannage : problèmes fréquents et solutions

La plupart des problèmes n'ont que quelques causes. Parcourez la section qui correspond à ce que vous constatez. La console de développement de votre navigateur (F12) indique souvent la cause directement.

La bulle de chat n'apparaît pas

• Le script n'est pas sur la page. Affichez le code source de la page et cherchez embed.js. Beaucoup de créateurs de sites n'ajoutent le code personnalisé qu'au site publié, pas à l'aperçu de l'éditeur. Le script fonctionne dans le head comme dans le body ; l'emplacement recommandé est juste avant </body>. Voir Installer avec une balise script.
• Mauvais ID d'agent. La console affiche Chatbot not found. Copiez de nouveau le snippet depuis l'onglet Share.
• Le site ne fait pas partie des domaines autorisés. La console affiche intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown. L'agent est limité à d'autres sites. Dans l'onglet Share, ajoutez le domaine de ce site sous Where this agent can appear, ou videz la liste pour autoriser n'importe quel site. Un nouveau domaine peut mettre jusqu'à une minute à atteindre la fenêtre de chat. Voir Domaines autorisés.
• L'agent est privé. La console affiche intoCHAT: this agent is private, so the chat is not shown. Dans l'onglet Share, désactivez Private agent et cliquez sur Save.
• Google Tag Manager. GTM retire l'attribut data-chatbot-id des balises script dans les balises HTML personnalisées : le widget ne sait alors pas quel agent charger. La console affiche « The embed script needs a data-chatbot-id attribute. » Utilisez le snippet du guide Google Tag Manager.
• Content Security Policy. Si votre site envoie un en-tête CSP, autorisez https://www.intochat.ai dans script-src, connect-src et frame-src.
• Optimiseurs de scripts. Le script lit l'ID de l'agent dans sa propre balise. Si une extension fusionne ou réécrit les scripts, excluez-en embed.js.
• Bloqueurs de publicité ou de traçage. Certaines extensions de navigateur bloquent les scripts de chat tiers. Testez dans une fenêtre privée sans extensions.
• La bulle s'affiche mais l'agent ne répond plus. Les visiteurs voient « Message limit reached » quand votre quota mensuel est épuisé ; voir Offres et limites.

Une iframe ou le lien direct n'affiche pas le chat

• L'iframe reste vide ou affiche une erreur du navigateur. Le site ne fait pas partie des domaines autorisés de l'agent, ou l'agent est privé. Le navigateur refuse alors de charger le chat dans le cadre, et la console mentionne frame-ancestors. Ajoutez le domaine du site dans l'onglet Share, sous Where this agent can appear.
• « This agent is private. » Désactivez Private agent dans l'onglet Share. Tant que l'option est active, vous seul pouvez discuter avec l'agent, dans le Playground.
• « This agent doesn't exist anymore. » L'identifiant de l'agent dans l'adresse est incorrect, ou l'agent a été supprimé. Copiez de nouveau le code depuis l'onglet Share.
• « The chat couldn't load. Please try again later. » Les réglages de l'agent n'ont pas pu être chargés. Rechargez la page.

L'analyse du site ne trouve aucune page

• « No pages found » : intoCHAT n'a trouvé aucune page sur ce site. Vérifiez l'adresse, ou activez Single page mode et ajoutez les pages importantes une par une.
• Tout est filtré : vérifiez Exclude URLs containing. Un motif comme / correspond à toutes les pages.
• « The page answered with an error (403) » ou similaire : le site bloque les visiteurs automatisés. Demandez à son responsable d'autoriser l'accès, ou importez le contenu sous forme de fichier ou collez-le comme texte.
• « No meaningful content found » : la page ne contient presque pas de texte lisible.
• « Monthly crawl limit reached » : attendez la remise à zéro mensuelle ou changez d'offre. Fichiers, textes et Q&A fonctionnent toujours.

Voir Analyse de site web et Fichiers.

Les réponses sont fausses, vagues ou dépassées

1. Testez la question dans le Playground.
2. Dans l'onglet Knowledge, utilisez Preview the text sur la source censée contenir la réponse. Si le texte n'y est pas, la page n'a pas été lue comme prévu.
3. Pour les questions fréquentes, ajoutez une paire question-réponse. Les réponses Q&A passent en premier.
4. Cliquez sur l'étoile (Mark as priority) de la source la plus fiable. Elle passe alors devant les autres connaissances pertinentes et l'emporte en cas de contradiction, sans nouvel entraînement.
5. Si une page de votre site a changé, cliquez sur Refresh from website (actualiser depuis le site) sur sa source ; la page est relue et réentraînée si son texte a changé. Pour un fichier modifié, importez la nouvelle version sous le même nom et lancez l'entraînement. Les sources ne se mettent pas à jour seules.
6. Supprimez les sources dépassées qui contredisent les actuelles et vérifiez vos Instructions.

Quand il ne trouve rien de pertinent, l'agent dit qu'il ne sait pas au lieu de deviner. C'est voulu : ajoutez le contenu manquant. Voir Gérer les sources.

Le formulaire de leads n'apparaît pas

• Enable lead collection est activé et vous avez cliqué sur Save lead settings.
• En mode Manual (visitor asks), le formulaire n'apparaît que si le visiteur demande à être contacté.
• Les règles de mots-clés ne vérifient que le dernier message du visiteur.
• Le formulaire apparaît au maximum trois fois par conversation, et plus du tout une fois que le visiteur a donné ses coordonnées dans cette session. Pour retester, ouvrez une nouvelle fenêtre privée.
• Il n'apparaît jamais dans les chats temporaires.

Voir Collecte de leads.

Une action échoue

• Ouvrez l'action et cliquez sur Send test request dans 2. Try it pour voir le statut et la réponse.
• « URL points to a blocked or internal host » : les adresses privées et internes sont refusées. Utilisez une URL publique.
• « This address redirects somewhere else » : cliquez sur Use this address.
• « Request timed out after 30s » : le point de terminaison est trop lent.
• L'agent ne l'appelle jamais : vérifiez que l'action est activée et que When to use décrit les questions concernées.
• Les actions côté client ne fonctionnent pleinement que sur une page où le widget est installé, et échouent dans une intégration en iframe. Voir Actions côté client.

Toujours bloqué ? Écrivez à support@intochat.ai en indiquant l'ID de votre agent.