Dépannage — INOCHAT

DépannageLe widget échoue toujours en silence : c'est une qualité sur votre site, et une gêne quand on cherche pourquoi il ne s'affiche pas. Voici comment le faire parler.La bulle n'apparaît pas du toutOuvrez la console du navigateur (F12), onglet Réseau, rechargez la page, et filtrez sur inochat.Aucune requête inochat.jsLa balise n'est pas exécutée.

Est-elle bien avant </body> ? Une balise après </body> est ignorée par certains navigateurs.

Un plugin de cache a-t-il combiné les scripts ? La combinaison réécrit la balise et perd data-site : le widget ne peut plus savoir à quel site il appartient. Excluez inochat.js de la combinaison.

Un bloqueur de publicité ? Testez en navigation privée, extensions désactivées.

inochat.js chargé (200), mais rien ne s'afficheLe script s'exécute et s'arrête tout de suite. Deux causes, dans cet ordre :

data-site ou data-endpoint absent ou vide. Le script s'arrête à la première ligne, volontairement. Vérifiez le code source de la page (clic droit → Afficher le code source), pas votre fichier de thème : c'est ce que le navigateur reçoit qui compte.

L'appel /api/inochat/public/config échoue. Voir ci-dessous.

L'appel de configuration échoueToujours dans l'onglet Réseau, cherchez public/config.403 — origine refusée

Le domaine depuis lequel vous appelez n'est pas dans la liste autorisée.

C'est de loin la cause la plus fréquente. La comparaison est stricte :

Déclaré	Vous appelez depuis	Résultat
`https://votresite.com`	`https://www.votresite.com`	❌ refusé
`https://votresite.com`	`http://votresite.com`	❌ refusé
`https://votresite.com`	`https://preprod.votresite.com`	❌ refusé
`https://votresite.com`	`https://votresite.com`	✅

Demandez à INOVERTIX d'ajouter toutes les variantes que vous utilisez réellement, y compris votre environnement de préproduction.401 — clé refuséeQuatre causes, et CONTROL sait les distinguer : demandez à INOVERTIX de coller votre clé dans INOCHAT → Paramètres → Diagnostic d'une clé. Il obtiendra la raison exacte en une seconde :

clé absente ou marqueur du snippet non remplacé (INOCHT_PUB_votre_cle_publique laissé tel quel) ;

clé d'un autre module (une clé INODSK_PUB_… collée dans un widget INOCHAT : les deux se ressemblent beaucoup) ;

clé révoquée ;

clé inconnue — souvent un espace ou un retour à la ligne recopié avec.

404 — mauvais point d'accèsVérifiez data-endpoint : il se termine par /api/inochat, sans barre finale et sans /public.La bulle s'affiche, mais l'assistant ne répond jamaisIl répond « Je n'ai pas cette information sous la main »Ce n'est pas une panne : c'est la règle du produit. L'assistant ne dit que ce que sa base contient. Il n'invente jamais, même quand la réponse « semble » évidente.La question que vous avez posée n'a pas de réponse dans les articles. Signalez-la à INOVERTIX : elle apparaît déjà dans l'écran « Questions sans réponse » de CONTROL, et un article la couvrira.Il propose un formulaire à la place de répondreLe widget est passé en mode formulaire. Quatre causes possibles, toutes visibles côté CONTROL :

le plafond de messages du jour est atteint ;

le plafond de coût du mois est atteint ;

le service de discussion est momentanément indisponible ;

vos messages sont partis trop vite les uns après les autres.

Dans les quatre cas, le message déposé crée une vraie demande avec un numéro de suivi : rien n'est perdu.Il répond « Un instant… je traite vos messages précédents »Vous écrivez plus vite que la limite anti-abus. Attendez quelques secondes. C'est volontairement poli : la conversation continue, elle n'est pas coupée.Le suivi de commande ne trouve jamais rienL'assistant exige le numéro de commande ET le téléphone, toujours. Il ne dira jamais lequel des deux est faux — c'est ce qui empêche de retrouver la commande de quelqu'un d'autre en essayant des numéros à la suite.Vérifiez avec INOVERTIX :

que votre boutique est bien reliée au site (sans quoi l'assistant ne propose même pas le suivi) ;

que le téléphone essayé est bien celui saisi lors de la commande — les formats 90112233, +228 90 11 22 33 et 00228 90112233 sont tous acceptés, mais un autre numéro ne l'est pas.

La conversation repart de zéro à chaque pageLe jeton de conversation vit dans le localStorage de votre domaine.

En navigation privée, il est effacé à la fermeture : c'est normal.

Si vous passez de votresite.com à www.votresite.com, ce sont deux stockages différents : le fil repart. Redirigez systématiquement vers une seule des deux formes (bonne pratique SEO par ailleurs).

Certains navigateurs effacent le localStorage des domaines tiers après quelques jours d'inactivité : la conversation repart, sans erreur visible.

Le panneau est déformé, ou passe sous un autre élémentLe panneau vit dans un Shadow DOM : aucune règle CSS de votre site ne peut l'atteindre, et aucune des nôtres ne peut fuir chez vous. S'il passe sous un élément de votre site, c'est que cet élément a un z-index supérieur à 2147483000 — une valeur qui n'a pas lieu d'être. Baissez-la.Sur mobile, le clavier recouvre la zone de saisieLe panneau utilise 100dvh (hauteur dynamique du viewport), précisément pour éviter cela. Si le problème persiste, indiquez à INOVERTIX votre modèle de téléphone et la version de votre navigateur : c'est un cas à corriger dans le widget, pas chez vous.Rien de tout cela ?Transmettez à INOVERTIX :

l'URL exacte de la page,

une capture de l'onglet Réseau filtré sur inochat,

le code de statut et le corps de la réponse de public/config.

Ces trois éléments suffisent presque toujours.