Dépannage
La plupart des problèmes se ramènent à une poignée de causes. Repérez votre symptôme ci-dessous et suivez les vérifications dans l’ordre.
Le widget de chat ne s’affiche pas
- Regardez dans une fenêtre de navigation privée. Le widget est masqué pour les administrateurs connectés. Si vous n’avez vérifié que dans le navigateur où vous êtes connecté à WordPress, le widget fonctionne probablement. C’est la cause la plus fréquente.
- Vérifiez l’affichage automatique. Sous Paramètres → Comportement → Fonctionnalités, Injection automatique sur toutes les pages doit être sur Actif, sauf si vous placez vous-même le widget avec le shortcode
[ecomai_chatbot]. - Absent uniquement sur la page de paiement ? Activez Show on Checkout (afficher sur la page de paiement) dans la même section.
- Videz vos caches. Si vous utilisez une extension de cache ou un CDN, purgez-le après avoir activé l’extension ou modifié ces réglages ; vos visiteurs reçoivent peut-être encore une copie de la page enregistrée auparavant.
- Écartez un conflit de scripts. Ouvrez la page dans une fenêtre de navigation privée, ouvrez la console de développement du navigateur et rechargez. Si une erreur JavaScript en rouge provenant d’une autre extension ou de votre thème apparaît avant le chargement du widget, corrigez ou désactivez ce script. Si votre extension d’optimisation combine, diffère ou retarde le JavaScript, excluez-en le script du chat
chat.jset refaites le test. - Vérifiez la position. Un bandeau de cookies ou un autre bouton flottant peut recouvrir la bulle du chat. Essayez l’autre coin sous Paramètres → Design → Position du widget.
L’IA ne répond pas ou affiche une erreur
- Testez la connexion. Ouvrez Paramètres → Fournisseur IA et cliquez sur Tester la connexion. Le statut affiche soit Connexion OK, soit Dernier test échoué avec le message d’erreur du fournisseur lui-même, qui désigne généralement la cause.
- « Aucune clé API enregistrée pour ce fournisseur ». Collez votre clé et cliquez sur Enregistrer la clé. Une clé est enregistrée par fournisseur : après un changement de fournisseur, il vous faut donc la clé de celui-ci.
- La clé est refusée. Vérifiez que vous avez copié la clé en entier et sans espace, qu’elle n’a pas été révoquée dans la console du fournisseur et qu’elle appartient bien au fournisseur sélectionné à l’écran.
- Erreurs de quota ou de facturation. Une clé valide mais sans crédit, ou qui a atteint son plafond de dépenses, échoue également. Vérifiez la facturation dans la console du fournisseur.
- « La clé API pour … n’a pas pu être déchiffrée. Veuillez la réenregistrer. » Les clés sont chiffrées avec les clés secrètes WordPress de votre site. Après une migration ou une modification des clés de salage dans
wp-config.php, saisissez de nouveau la clé et enregistrez. - Le modèle n’existe plus. Les fournisseurs retirent des modèles. Cliquez sur l’icône d’actualisation à côté de Modèle d’IA, choisissez un modèle actuel et enregistrez.
- Des réponses lentes qui expirent. Augmentez Délai d’attente de la requête (secondes) dans les Paramètres avancés. Si votre hébergeur bloque les connexions sortantes, demandez-lui d’autoriser les requêtes HTTPS vers l’API de votre fournisseur.
- Panne du fournisseur. Avec un fournisseur de secours Pro, le chat bascule automatiquement.
Vos clients voient « I’m taking a short break right now »
Ce message (« Je fais une courte pause pour le moment ») venait de la limite de conversations des versions antérieures à la 2.9.0. Depuis la 2.9.0, l’extension n’a plus aucune limite de conversations, en Free comme en Pro. Si vous le voyez encore, mettez l’extension à jour.
« Trop de messages. Veuillez patienter un instant. »
Un visiteur a envoyé en une minute plus de messages que votre limite ne l’autorise. Cela protège votre budget IA. Si de vrais clients l’atteignent, augmentez Limite de débit (messages/minute) sous Paramètres → Comportement → Limites et langue.
L’IA reste muette dans une seule conversation
C’est normal lorsque la conversation a été escaladée ou qu’un conseiller l’a prise en main : l’IA ne répond pas tant qu’une personne s’en occupe. Ouvrez-la sous Inbox → Conversations, puis répondez ou cliquez sur Rendre au bot. Voir Conseillers et prise en main.
Problèmes avec les extensions de cache
Le symptôme typique est un widget qui s’ouvre normalement mais répond « Votre session a expiré. Veuillez rafraîchir la page pour continuer la discussion. » Chaque page contient un jeton de sécurité à durée de vie courte pour le chat. Si un cache de page sert la même page enregistrée plus longtemps que la durée de vie de ce jeton, les visiteurs reçoivent un jeton expiré et leurs messages sont refusés.
- Confirmez la cause. Purgez le cache de page et rechargez la page dans une fenêtre de navigation privée. Si le chat fonctionne de nouveau, le cache est en cause.
- Réduisez la durée de vie du cache de page. Dans votre extension de cache, fixez la durée de vie des pages en cache à 10 heures ou moins. C’est la recommandation habituelle pour toute fonctionnalité WordPress qui utilise des jetons de sécurité.
- Vérifiez aussi le cache du serveur et du CDN. Si votre hébergeur ou votre CDN met en cache des pages HTML complètes, appliquez-y la même durée de vie.
- Ne mettez pas en cache les requêtes du chat. Assurez-vous que les requêtes vers
/wp-admin/admin-ajax.phpet/wp-json/sont exclues du cache. La plupart des extensions de cache les excluent par défaut ; une règle CDN personnalisée, pas forcément. - Des changements de design invisibles ? Purgez le cache après avoir enregistré sur l’écran Design, puis rechargez dans une fenêtre de navigation privée.
La licence ne s’active pas
L’activation se fait sous Paramètres → Licence. Le message d’erreur affiché sur cet écran vous indique le cas qui s’applique.
- « Clé de licence introuvable » ou « La clé de licence est invalide » : copiez de nouveau la clé depuis votre e-mail d’achat, tirets compris, sans espace avant ni après. Le format est
WAI-XXXX-XXXX-XXXX-XXXX. - « Cette licence est déjà activée sur un autre site » : une clé est liée à un seul site. Libérez d’abord l’autre site, dans son écran Licence ou sur la page de compte, puis activez la clé ici. Cela vaut aussi après le passage d’une adresse de préproduction à votre domaine définitif. Voir déplacer l’extension vers un autre domaine.
- « Cette licence a expiré » ou « Cet abonnement a été résilié » : l’abonnement a pris fin. Renouvelez-le pour réactiver Pro. Vos données et vos réglages sont toujours là.
- « Cette licence a été remboursée » ou « a été désactivée » : la clé n’est plus valide. Si vous pensez qu’il s’agit d’une erreur, contactez le support.
- « Ce site n’est plus enregistré pour cette licence » : cliquez sur Désactiver ce site, puis activez de nouveau la clé.
- « Impossible de joindre le service de licence » : votre serveur n’a pas pu effectuer la requête HTTPS sortante. Réessayez dans quelques minutes. Si l’échec persiste, demandez à votre hébergeur si un pare-feu bloque les connexions sortantes de WordPress.
Si les fonctionnalités Pro sont toujours verrouillées juste après un renouvellement, ouvrez l’écran Licence et cliquez sur Valider maintenant pour actualiser le statut.
Autres questions fréquentes
L’assistant donne une réponse fausse ou vague
Ajoutez un extrait contenant la bonne réponse, puis consultez Que sait actuellement l’IA ? en bas de l’écran Base de connaissances pour vérifier qu’il est bien pris en compte. Voir Base de connaissances.
Un déclencheur de relance de panier ne se déclenche pas
Vérifiez que Activer le chat proactif est activé, que la règle est sur Actif et que vous testez dans une fenêtre de navigation privée. L’intention de sortie ne se déclenche pas sur mobile et ne se déclenche qu’une fois par session. Voir Relance de panier.
Les e-mails d’escalade n’arrivent pas
Utilisez Envoyer une alerte d’escalade de test sous Paramètres → Comportement → Paramètres d’escalade. Ouvrez ensuite Paramètres → Integrations → Diagnostic d’envoi des e-mails, qui affiche les tentatives d’envoi récentes et indique si une extension SMTP est détectée. Les sites WordPress sans envoi SMTP correctement configuré voient souvent leurs e-mails rejetés comme spam.
Ce qu’il faut nous envoyer
Si rien de tout cela ne vous aide, contactez le support en indiquant l’adresse de la page où le problème se produit, le message d’erreur exact et le résultat de Tester la connexion. N’envoyez pas votre clé API ni votre clé de licence complètes par e-mail, sauf si nous vous le demandons par un canal sécurisé.
Toujours bloqué ?
Consultez le guide de dépannage, ou contactez le support en nous indiquant ce que vous avez déjà essayé.