Dépannage : problèmes fréquents et solutions
Résolvez les problèmes courants d'intoCHAT : bulle absente, analyse sans pages, réponses vagues ou fausses, formulaire de leads absent et actions en échec.
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. Les messages que le chat montre aux visiteurs sont cités ici en anglais ; les visiteurs les voient dans la langue du widget.
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. - Le pays du visiteur est bloqué. La console affiche
intoCHAT: this agent is not offered in the visitor's country (Share > Limits and access), so the chat is not shown.Le pays figure sous Blocked countries dans l'onglet Share. Retirez-le et cliquez sur Save. Le pays est déterminé à partir de l'adresse IP : un visiteur qui utilise un VPN peut sembler se trouver ailleurs. Voir Limites et accès. - Google Tag Manager. GTM retire l'attribut
data-chatbot-iddes 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.aidansscript-src,connect-srcetframe-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, seuls vous et les membres de votre équipe pouvez discuter avec l'agent, dans le Playground.
- « This chat isn't available in your region. » Le pays du visiteur figure sous Blocked countries dans l'onglet Share. Retirez-le et cliquez sur Save.
- « 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.
Les visiteurs voient un message de limite
- « Too many messages. Please try again later. » Ce visiteur a atteint Limit messages per visitor dans l'onglet Share. Il peut écrire de nouveau une fois son heure écoulée, comptée à partir de son premier message. Les personnes sur un même réseau partagent une seule limite. Augmentez le nombre ou désactivez la limite.
- « Too many messages right now. Please try again in a moment. » Les limites horaires propres à intoCHAT, qui s'appliquent à tous les agents, sont atteintes pour cet agent ou pour l'adresse IP du visiteur. Attendez un instant et réessayez.
- « This chat has reached its limit for now. Please try again later. » L'agent a atteint son Monthly message cap for this agent. Le bloc affiche le compte et la date à laquelle il repart de zéro. Augmentez le plafond ou désactivez-le ; l'agent répond de nouveau dès le message suivant.
- « This chat isn't available in your region. » Le pays du visiteur figure sous Blocked countries.
- « Message limit reached » : les messages mensuels de votre offre sont épuisés pour tous vos agents. Voir Offres et limites.
- « The Playground couldn't reply » avec une mention du plafond mensuel : les messages du Playground comptent dans le plafond de l'agent. Augmentez-le ou désactivez-le.
Voir Limites et accès.
Les textes du widget sont dans la mauvaise langue
- Les boutons et avis sont dans la mauvaise langue. Ils suivent le réglage Widget language de l'onglet Appearance. Avec Automatic, la bulle de chat utilise d'abord l'attribut
langde la balise<html>de votre page, par exemple<html lang="fr">, puis les langues du navigateur du visiteur. Beaucoup de créateurs de sites définissent cet attribut eux-mêmes ; vérifiez qu'il correspond à la page. Pour une seule langue partout, choisissez-la sous Widget language et cliquez sur Save changes. - Une page dans une autre langue affiche l'anglais. Le widget parle anglais, allemand, français, italien et espagnol. Pour toute autre langue de page, il passe aux langues du navigateur du visiteur, puis à l'anglais.
- L'iframe intégrée ou le lien direct ignore la langue de la page. Ils n'ont pas de page hôte : avec Automatic, ils suivent le navigateur du visiteur.
- Votre message d'accueil ou d'autres textes restent dans une seule langue. Les textes que vous rédigez s'affichent tels quels. Seuls les textes par défaut sont traduits.
- L'agent répond dans une autre langue. Les réponses suivent Reply language dans l'onglet Setup, pas ce réglage. Par défaut, c'est la langue dans laquelle écrit le visiteur. Pour que toutes les réponses soient dans une seule langue, choisissez-la sous Reply in, activez Always use this language et cliquez sur Save changes. Voir Instructions.
Voir Apparence.
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.
L'entraînement ne se termine pas
- Vous avez fermé la page pendant l'entraînement. L'entraînement continue sur les serveurs d'intoCHAT. Ouvrez l'onglet Knowledge pour voir sa progression.
- Des sources attendent toujours d'être entraînées. Ouvrez l'onglet Knowledge : un entraînement interrompu reprend alors. Si la barre indique toujours « … sources waiting to be trained », cliquez sur Train agent. Les sources terminées restent entraînées.
- Une source affiche Failed. Survolez le badge pour voir pourquoi. Cliquez sur Retry failed, ou utilisez Re-index saved text sur la source.
- Un fichier ou une page ajouté manque. Il était encore en cours de lecture quand vous avez quitté la page. Ajoutez-le de nouveau et attendez qu'il apparaisse comme ajouté.
Voir Gérer les sources.
Les réponses sont fausses, vagues ou dépassées
- Testez la question dans le Playground.
- 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.
- Pour les questions fréquentes, ajoutez une paire question-réponse. Les réponses Q&A passent en premier.
- 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.
- 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 pages web et les pages Notion ne sont relues d'elles-mêmes que si l'Auto-resync est activé ; les fichiers, textes et questions-réponses, jamais.
- 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.
- Si le transfert par e-mail est activé, un visiteur qui demande à parler à quelqu'un se voit proposer le transfert au lieu du formulaire, sauf si une règle correspond.
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.
Le transfert par e-mail ne fonctionne pas
- L'agent ne le propose jamais. Vérifiez que Offer hand-off by email est activé dans l'onglet Setup et que vous avez cliqué sur Save changes. L'agent ne le propose que si le visiteur demande à parler à quelqu'un ou souhaite un suivi qu'il ne peut pas assurer lui-même. Les chats temporaires ne peuvent pas être transférés. Si le chat en direct est activé et que quelqu'un a la boîte de réception Live chat ouverte, l'agent demande plutôt à votre équipe de rejoindre le chat, et ne propose le transfert par e-mail que si le visiteur préfère être contacté par e-mail.
- L'agent dit qu'il n'a pas pu transmettre la conversation. L'agent a déjà envoyé 20 transferts dans l'heure, ou l'e-mail n'a pas pu partir. Réessayez plus tard.
- L'agent dit que l'équipe a déjà la conversation. Cette conversation a été transférée il y a moins de 10 minutes.
- Aucun e-mail n'arrive. Vérifiez les destinataires sous Email when a new lead arrives dans l'onglet Leads, ainsi que votre dossier de spam. Les e-mails envoyés depuis le Playground commencent par
[Test].
Voir Transfert par e-mail.
Le chat en direct n'est pas proposé
- L'agent propose le transfert par e-mail, ou aucune personne. Vérifiez que Offer live chat when someone from the team is online est activé sous Live chat dans l'onglet Setup. Le chat en direct n'est proposé que tant que quelqu'un de votre équipe est en ligne : la boîte de réception Live chat ouverte dans un onglet, au cours des 2 dernières minutes, par une personne ayant au moins le rôle Editor. Un onglet en arrière-plan cesse de compter au bout d'environ 17 minutes.
- Rien ne se passe dans le Playground. Le Playground n'affiche pas le chat en direct. Testez depuis votre site ou le lien direct de l'agent.
- Rien ne se passe dans un chat temporaire. Les chats temporaires ne demandent jamais de chat en direct.
- Le visiteur ne voit pas mes réponses. Si vous avez pris la main sur un chat dans lequel le visiteur n'a pas demandé de personne, sa fenêtre de chat n'affiche vos réponses qu'après son message suivant ou un rechargement de la page.
Voir Chat en direct.
Un webhook n'arrive pas
Cliquez sur Recent deliveries sous le webhook dans l'onglet Leads. L'erreur d'un envoi en échec indique généralement la cause.
HTTP 301: redirects aren't followed, ou un autre statut3xx: indiquez l'adresse finale vers laquelle mène la redirection.No response within 10 seconds.: répondez d'abord avec un statut2xx, puis effectuez le travail long ensuite.The server's TLS certificate isn't valid.: corrigez ou renouvelez le certificat de votre serveur.The webhook is turned off. Turn it on to deliver events.: activez le webhook, puis cliquez sur Resend.- L'adresse est refusée à l'enregistrement : utilisez une adresse publique qui commence par
https://. Les adresses de réseaux privés ou internes ne sont pas acceptées. - Votre vérification de signature échoue : calculez-la sur le corps brut avant d'analyser le JSON, incluez la valeur de
X-IntoChat-Timestampet utilisez le secret le plus récent si vous avez cliqué sur New secret. Si vous refusez les horodatages anciens, vérifiez l'horloge de votre serveur. - Rien n'arrive du tout : vérifiez que le webhook est Active et que l'événement est coché sous Events to send. Un contact qui revient ne déclenche pas de nouveau
lead.created.
Voir Webhooks.
Application d'authentification perdue
- Il vous reste un code de récupération. À l'étape du code sur la page de connexion, cliquez sur Utiliser un code de récupération et saisissez-en un. Désactivez ensuite puis réactivez l'authentification à deux facteurs sous Settings puis Account pour configurer votre nouveau téléphone.
- Il ne vous reste aucun code de récupération. Écrivez à support@intochat.ai depuis l'adresse e-mail de votre compte. Une fois que le support a confirmé qu'il s'agit bien de vous, il peut désactiver l'authentification à deux facteurs pour vous.
- Les codes sont toujours refusés. Réglez l'heure de votre téléphone pour qu'elle se mette à jour automatiquement : les codes dépendent de l'horloge. Chaque code ne fonctionne en outre qu'une fois.
Voir Authentification à deux facteurs.
Toujours bloqué ? Écrivez à support@intochat.ai en indiquant l'ID de votre agent.