# 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.

## 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](/fr/docs/script-tag).
- **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](/fr/docs/allowed-domains).
- **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](/fr/integrations/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](/fr/docs/plans-and-limits).

## 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](/fr/docs/allowed-domains) 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](/fr/docs/website-crawl) et [Fichiers](/fr/docs/files).

## 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](/fr/docs/managing-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](/fr/docs/lead-collection).

## 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](/fr/docs/client-actions).

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