Le widget ne s'affiche pas sur mon site

Diagnostic en 3 minutes

Vous avez collé le code d’intégration sur votre site. Vous rechargez. Et… rien. Pas de bulle. Pas de bouton.

Avant de paniquer, lisez les vérifications dans l’ordre — la cause est presque toujours l’une des cinq qui suivent.

1. Vous regardez la bonne page ?

Évidence à vérifier : le code est-il bien sur la page que vous regardez ? Beaucoup de CMS (WordPress, Shopify) ont des règles pour insérer un script « sur toutes les pages » ou « sur certaines pages ». Vérifiez que votre page est concernée.

Test rapide : faites un clic droit sur la page → Afficher la source. Cherchez sens-ai.work (Cmd+F / Ctrl+F). Si vous le trouvez, le script est là. Sinon, l’intégration n’a pas pris.

2. Le navigateur a mis en cache l’ancienne version ?

Très, très fréquent. Votre navigateur affiche encore la page d’il y a 2 heures, sans le code que vous venez d’ajouter.

Solution :

• Ouvrez la page en navigation privée (Ctrl+Shift+N sur Chrome, Cmd+Shift+N sur Mac, équivalent sur Firefox/Safari).
• Si la bulle apparaît en navigation privée mais pas en mode normal : c’est juste un cache. Videz le cache du navigateur (Cmd+Shift+Delete) ou rechargez avec Ctrl+F5 (Cmd+Shift+R sur Mac).

Si la bulle n’apparaît même pas en navigation privée, continuez les étapes suivantes.

3. Une erreur dans la console du navigateur ?

C’est l’étape la plus efficace pour diagnostiquer.

1. Ouvrez votre site.
2. Faites un clic droit → Inspecter (ou F12).
3. Cliquez sur l’onglet Console.
4. Rechargez la page (F5).
5. Regardez s’il y a des messages en rouge (erreurs) ou en jaune (avertissements).

Les messages typiques :

Un message « Content Security Policy »

Le navigateur refuse de charger le script, par exemple « Refused to load the script ‘https://api.sens-ai.work/widget.js’ because it violates the following Content Security Policy directive… ». Votre site a une politique de sécurité (CSP) qui bloque les ressources externes : vous devez autoriser api.sens-ai.work.

Solution : ajoutez https://api.sens-ai.work dans votre Content-Security-Policy :

script-src 'self' https://api.sens-ai.work;
connect-src 'self' https://api.sens-ai.work;
img-src 'self' https://api.sens-ai.work;
frame-src https://api.sens-ai.work;

• script-src charge le widget, connect-src lui permet d’envoyer et de recevoir les messages.
• img-src affiche le logo et l’avatar que vous avez téléversés. Si vous avez indiqué l’adresse d’une image hébergée ailleurs, ou si votre agent affiche des images dans ses réponses, ajoutez aussi le domaine de ces images.
• frame-src ouvre la fenêtre d’appel de la Voix web.
• Si votre politique limite aussi les styles (style-src), ajoutez-y 'unsafe-inline' : le widget insère sa propre feuille de style.

Si vous ne savez pas où changer ça, demandez à votre développeur ou hébergeur. C’est généralement dans les en-têtes HTTP du serveur ou dans une balise <meta> dans le <head>.

[Sens-AI] bot introuvable

L’identifiant du bot dans votre code n’est pas bon : le widget ne s’affiche pas. Vérifiez :

1. Dans Sens Ai, ouvrez votre agent puis, dans son menu de gauche, Canaux › Chat web.
2. Dans Code d’intégration, cliquez sur Copier le code.
3. Recollez-le dans votre site (en remplaçant l’ancien).

[Sens-AI] origine non autorisée pour ce widget

Vous avez renseigné des Origines autorisées pour votre agent (dans Canaux › Chat web) et l’adresse de la page actuelle n’est pas dans la liste : le widget ne s’affiche pas.

Solution :

• Dans Canaux › Chat web, carte Origines autorisées, saisissez le domaine actuel dans Ajouter une origine, cliquez sur Ajouter, puis sur Publier.
• Les origines doivent commencer par https:// : une adresse en http:// est refusée (« L’URL doit utiliser HTTPS (https://). »). Pour tester en local, ajoutez https://localhost, avec le port si besoin (par exemple https://localhost:5173).

[Sens-AI] configuration du widget indisponible

Le widget n’a pas pu lire sa configuration, même après une nouvelle tentative 30 secondes plus tard (coupure réseau ou incident passager). Rechargez la page un peu plus tard, et consultez Statut des services dans le menu de votre avatar. Si le message persiste, écrivez-nous.

4. Le script est chargé mais le widget reste invisible ?

La console est propre, mais la bulle n’apparaît pas. Causes possibles :

Z-index de votre site trop élevé

Votre site a peut-être un menu fixe ou un cookie banner avec un z-index énorme (genre z-index: 999999) qui passe par-dessus le widget. Le widget est techniquement là, juste recouvert.

Solution : ouvrez les outils de développement → Éléments → cherchez <div id="sensai-widget"> dans le HTML. Si vous le trouvez, c’est qu’il est bien chargé. Vérifiez qu’aucun autre élément ne l’écrase.

Un autre widget de chat installé en même temps

Vous avez Crisp, Intercom, Tawk.to, ou un autre chat sur la même page ? Ils peuvent se superposer ou s’écraser.

Solution : retirez le concurrent au moins le temps de tester. Si vous voulez en garder plusieurs, contactez-nous pour qu’on configure des positions différentes.

Votre site est en HTTP (pas HTTPS)

Le Chat web s’affiche aussi sur une page en HTTP. En revanche, le micro ne fonctionne que sur une page en HTTPS : sur une page HTTP, la Voix web ne peut pas démarrer. Et si vous avez renseigné des Origines autorisées, elles ne peuvent être qu’en https://.

Solution : passez votre site en HTTPS (la plupart des hébergeurs offrent un certificat SSL gratuit via Let’s Encrypt). Si vous testez en local, utilisez https://localhost avec un certificat auto-signé.

5. Le bot est désactivé côté Sens Ai

Dans le menu de gauche de votre agent, ouvrez Canaux › Chat web et regardez le badge à côté du titre :

• Actif — tout va bien côté Sens Ai.
• Désactivé — le widget a été coupé : le code peut rester sur votre site, il n’affiche plus rien. Réactivez l’interrupteur Canal actif, en haut à droite : le widget revient au prochain chargement de page.
• Suspendu — abonnement inactif — votre agent ne répond plus car votre abonnement n’est pas actif ; voir Paiement échoué.

Si rien ne marche

Écrivez-nous à [email protected] avec :

1. L’URL où vous avez essayé d’intégrer le widget.
2. Une capture d’écran de la console du navigateur (F12 → Console).
3. Le nom du bot concerné.

On regarde dans les heures qui suivent.

Étape suivante (quand ça marche enfin)

Personnaliser l’apparence du widget : Personnalisation.