Si le widget de chat de Papo (https://papo.global/) n'apparaît pas sur votre site, le diagnostic commence par vérifier si le snippet de code est correctement inséré avant la balise </body>, s'il y a des conflits avec des plugins de cache ou d'optimisation, et si la boîte de réception du site reste active dans le panneau Papo. Ce guide rassemble les étapes pour identifier et corriger le problème rapidement.
Le widget de chat est le point de contact qui transforme les visiteurs en conversations. Quand il disparaît, vous perdez des opportunités de service. La bonne nouvelle, c'est que la plupart des pannes ont des causes simples et des solutions rapides.
| Cause probable | Vérification rapide | Solution proposée |
|---|---|---|
| Snippet absent ou mal positionné | Inspectez le code source de la page (Ctrl+U) et recherchez le script du widget. | Réinsérez le snippet exactement avant la fermeture </body>, tel que généré dans le panneau. |
| Conflit avec un plugin de cache ou d'optimisation | Testez le site dans une fenêtre de navigation privée ou désactivez temporairement les plugins de cache. | Excluez le script du widget des règles de minification/cache ou videz le cache après avoir inséré le snippet. |
| Boîte de réception du site supprimée ou sans agents | Accédez à Paramètres → Boîtes de réception et vérifiez si la boîte de type « Site » est listée et avec des agents associés. | Recréez la boîte de réception et associez au moins un agent ; copiez le nouveau snippet et mettez à jour le site. |
| Script bloqué par des extensions de navigateur | Ouvrez le site dans un autre navigateur ou sans extensions actives. | Conseillez aux visiteurs de désactiver les bloqueurs de script pour le domaine, ou révisez les paramètres de sécurité (CSP) du site. |
| Conflit avec un autre widget ou script | Vérifiez la console du navigateur (F12) à la recherche d'erreurs JavaScript. | Corrigez les conflits en ajustant l'ordre de chargement ou en isolant les scripts. |
Comment diagnostiquer l'absence du widget
-
Confirmez que le snippet est dans le code source
Ouvrez la page du site, faites un clic droit et sélectionnez « Afficher le code source » (ou utilisez Ctrl+U). Recherchez le script qui commence par quelque chose comme<script src="... app.papo.global ...">. S'il n'apparaît pas, le snippet n'a pas été ajouté ou a été supprimé. -
Testez dans une fenêtre de navigation privée
Souvent, le navigateur stocke une version en cache de la page sans le widget. Ouvrir une fenêtre de navigation privée ignore le cache local et charge la version la plus récente du site. Si le widget apparaît dans ce mode, le problème vient du cache et non du script lui-même. -
Vérifiez la console du navigateur
Appuyez sur F12 pour ouvrir les outils de développement et allez dans l'onglet « Console ». Les erreurs en rouge peuvent indiquer que le script du widget est bloqué par des politiques de sécurité ou entre en conflit avec d'autres scripts de la page. -
Vérifiez si la boîte de réception est active dans le panneau Papo
Allez dans Paramètres → Boîtes de réception. Si la boîte créée pour le site (type « Site ») n'est pas listée, elle a peut-être été supprimée accidentellement. Si elle est listée, vérifiez qu'au moins un agent est associé — une boîte sans agents ne charge pas correctement le widget.
Comment corriger les problèmes les plus courants
Réinstaller correctement le snippet
Si le code est absent ou mal positionné, refaites le processus :
- Dans le panneau Papo, dans Paramètres → Boîtes de réception, cliquez sur Ajouter une boîte et sélectionnez Site.
- Donnez un nom à la boîte et indiquez l'URL du site.
- Copiez le script généré et collez-le dans le HTML de toutes les pages où le chat doit apparaître, immédiatement avant la fermeture
</body>. - Associez au moins un agent à la boîte et enregistrez.
Remplacer l'ancien snippet par le nouveau garantit qu'aucun caractère n'a été perdu lors d'éditions manuelles.
Gérer le cache et les plugins d'optimisation
Les plugins de cache, de minification JavaScript ou de lazy loading peuvent empêcher le script du widget de s'exécuter. Si vous utilisez une plateforme comme WordPress, videz tout le cache du site (serveur et plugin) après avoir ajouté le snippet. Si possible, excluez le script du widget des règles de minification ou combinez-le uniquement avec des scripts essentiels. Tester avec tous les plugins d'optimisation désactivés aide à isoler la cause.
Recréer la boîte de réception et reconnecter
Lorsque la boîte d'origine a été supprimée ou que l'historique de configuration a été perdu, la voie la plus sûre est d'en créer une nouvelle. Le processus est le même que lors de l'installation initiale : créez la boîte de type Site, copiez le nouveau snippet et remplacez-le dans le code du site. Ensuite, associez les agents et vérifiez que le widget se charge dans une fenêtre de navigation privée. L'ancien snippet cesse de fonctionner automatiquement dans ce cas.
À qui ce guide est utile
- Entreprises qui viennent d'installer le widget et ne le voient pas apparaître.
- Opérations qui ont changé de thème ou effectué des mises à jour sur le site et ont remarqué la disparition du chat.
- Équipes qui ont hérité d'un site avec le snippet déjà inséré et doivent diagnostiquer pourquoi le widget ne se charge pas.
- Ceux qui veulent éviter la perte de leads à cause d'un canal de service invisible.
Questions fréquentes (FAQ)
Le widget n'apparaît pas seulement pour moi, mais mes clients le voient. Pourquoi ?
Il s'agit probablement du cache de votre navigateur ou d'une extension bloquant les scripts sur votre appareil. Testez dans une fenêtre de navigation privée ou sur un autre appareil. Si le widget apparaît, le problème est local et n'affecte pas les visiteurs.
J'ai installé le snippet, mais le widget n'apparaît pas sur certaines pages. Que faire ?
Vérifiez si le code a été collé dans le template qui alimente toutes les pages (par exemple, le footer.php sous WordPress) et non seulement sur une page isolée. S'il existe des règles conditionnelles d'affichage dans le thème, il peut être nécessaire de les ajuster pour inclure le bon domaine.
Dois-je recréer la boîte de réception pour corriger le widget ?
Pas toujours. Si la boîte existe encore et possède des agents associés, il suffit généralement de réinstaller le snippet. Recréer la boîte est l'alternative lorsqu'elle a été supprimée ou lorsque le script original a été perdu et que vous ne pouvez pas le récupérer.
Mon site utilise WordPress, y a-t-il quelque chose de spécifique à vérifier ?
Oui. Les plugins de cache (comme WP Rocket, W3 Total Cache) et les outils de minification peuvent bloquer le script du widget. Videz le cache, désactivez temporairement ces plugins pour tester et, si nécessaire, excluez le script du widget des optimisations. Lisez aussi le guide complet sur l'installation sous WordPress.
Le widget apparaissait et a disparu soudainement. Que s'est-il passé ?
Des modifications du thème du site, des mises à jour de plugins ou une migration de serveur peuvent supprimer le snippet. Il est également possible que la boîte de réception du site ait été supprimée du panneau Papo. Vérifiez les deux possibilités : le code source et la liste des boîtes de réception.
Comment tester si le snippet fonctionne sans publier sur le site officiel ?
Vous pouvez ajouter le script à une page de test dans un environnement de pré-production ou sur une page cachée du site lui-même. Tant que l'URL indiquée dans la boîte de réception correspond au domaine où le script est inséré, le widget se chargera normalement pour que vous puissiez valider.
À lire aussi
- Comment intégrer le chat du site Papo dans WordPress
- Comment vérifier si votre canal est connecté à Papo et que faire en cas de déconnexion
Commencez gratuitement et installez le widget en quelques minutes →
Avec Papo, vous offrez un support directement sur votre site et gardez tout le service centralisé dans le même panneau.