Dépannage des problèmes d'intégration de thèmes
L'intégration de ShopGuide à un thème se passe sans problème la plupart du temps, mais quand ce n'est pas le cas, la cause est généralement l'une des rares choses prévisibles. Voici comment les utiliser.
Le bloc chat ne se montre pas
Que ce soit dans la catégorie Apps de l'éditeur de thèmes ou simplement que ce soit absent sur les pages en direct, il faut le faire dans l'ordre suivant :
- Confirmez que ShopGuide est installé et que votre abonnement ou essai est actif (ShopGuide admin → Paramètres/facturation)
- Confirmez que votre thème est Online Store 2.0 — les thèmes plus anciens ne prennent pas le tout en charge les blocs d'applications; voir Shopify les bases de l'éditeur de thèmes
- Confirmer que le bloc ShopGuide Chat est en fait ajouté à la page ou au modèle que vous regardez — un bloc ne rend que l'endroit où il a été placé
- Confirmer pause chat boutiquefront-wide n'est pas activé (ShopGuide admin → Paramètres)
- Effacer le cache de votre navigateur et le rafraîchir (Ctrl+F5 / Cmd+Shift+R)
Si le modèle manque vraiment, re-ajoutez-le : Ajouter une section → Apps → ShopGuide Chat. Si le bloc n'est pas rendu, vérifiez la console du navigateur pour les erreurs JavaScript et essayez un navigateur différent ou une fenêtre incognito pour exclure une extension.
Problèmes de stylisation
Les couleurs ne correspondent pas à votre marque, à un faible contraste ou à la bulle qui chevauche un autre élément fixe sur la page (un tiroir de panier, une barre ad-to-cart collante, une bannière de cookies, un nav mobile) tous les traces de retour à la même quelques corrections : ajuster les couleurs et le modèle de style sur la page Apparence (voir Exposition de Chat & Branding), essayer le coin opposé ou activer « Store has mobile navigation bar » (voir Position de Chat & Layout), ou atteindre pour Custom CSS avec les vrais sélecteurs du widget pour tout ce que les paramètres ne couvrent pas (voir Conception de chat avancé).
Le chat s'ouvre mais ne répond pas
Vérifiez que la limite de visiteur de votre plan n'a pas été atteinte (ShopGuide admin → Facturation), vérifiez votre propre connexion, puis ouvrez la console du navigateur (F12) et recherchez des erreurs JavaScript ou réseau. Les tests effectués dans un navigateur différent, et avec d'autres applications ou bloqueurs publicitaires en front de magasin temporairement désactivés, éliminent un conflit.
Quelques écuries spécifiques à un navigateur
Les bloqueurs de publicités et les extensions de confidentialité bloquent parfois le script du chat ou ses requêtes réseau — le mode incognito avec des extensions off est le moyen le plus rapide pour exclure cela. Safari et Firefox protection de suivi peut interférer avec tout ce qui dépend du consentement analytique, comme les messages proactifs, qui ne chargent une fois le consentement accordé — qui est le comportement attendu lié à la confidentialité du client Shopify API, pas un bug. Et il est utile de confirmer que vous êtes sur une version du navigateur raisonnablement à jour avant d'escalader quoi que ce soit.
Sur mobile spécifiquement
Une bulle trop petite pour pouvoir taper confortablement, ou qui chevauche une barre de navigation inférieure, a généralement besoin d'un réglage plus grand ** Taille de bulle** (Paramètres → Bubble) ou "Store has mobile navigation bar" activé. Une réponse plus lente sur les appareils plus anciens ou les appareils bas de gamme vaut la peine d'être testé sur quelques téléphones réels plutôt que de ne compter que sur l'aperçu mobile de l'éditeur de thème.
Compatibilité des thèmes
Online Store 2.0 est nécessaire — les blocs d'applications n'existent pas sur les architectures de thèmes plus anciennes. Dawn et d'autres thèmes actuels Theme Store fonctionnent hors de la boîte. Un thème fortement personnalisé ou legs peut avoir besoin d'une mise à jour avant que le bloc puisse être ajouté du tout; voir Shopify les bases de l'éditeur de thèmes.
Après toute mise à jour thématique, il vaut la peine de confirmer trois choses : le bloc est toujours attaché là où vous vous attendez, la bulle apparaît et s'ouvre toujours correctement, et le style correspond toujours – mises à jour thématiques réinitialisent occasionnellement CSS personnalisé injecté ailleurs.
Plonger plus profondément
Dans la console du navigateur (F12 sur Chrome/Firefox, Develop → Afficher la console JavaScript sur Safari), recherchez les erreurs des propres scripts de ShopGuide — secure-chat-core.js, chat-styles.css, ab-test-engine-bundle.js. Dans l'onglet Réseau, filtrez les requêtes sur les chemins /apps/proxy/... ou /apps/ai-agent-proxy/... de votre boutique; une requête lente ou ratée indique généralement un problème d'abonnement, de limite tarifaire ou de connectivité plutôt que tout autre problème lié à un thème.
Si rien de cela ne le résout, contactez le support ShopGuide avec le domaine .myshopify.com de votre magasin, votre nom de thème et si c'est Online Store 2.0, votre navigateur et votre version, tout message d'erreur de console ou des captures d'écran, et les étapes pour le reproduire.