Themaintegratie probleemoplossing
Integratie ShopGuide met een thema gaat meestal soepel, maar als het niet, de oorzaak is meestal een van een handvol voorspelbare dingen. Hier is hoe te werken door middel van hen.
Het chatblok komt niet opdagen.
Of het ontbreekt in de categorie apps van de thema-editor, of gewoon niet verschijnt op live-pagina's, werk dit door in volgorde:
- Bevestigen ShopGuide is geïnstalleerd en uw abonnement of proefversie is actief (ShopGuide admin → Instellingen/Billing)
- Bevestig uw thema is Online Store 2.0 Shopify thema-editor basis
- Bevestig de ShopGuide Gesprek blok wordt eigenlijk toegevoegd aan de pagina of sjabloon die u kijkt naar
- Bevestigen pauze chat-opslaan-breed is niet ingeschakeld (ShopGuide admin → Instellingen)
- Uw browsercache wissen en hard-reverse (Ctrl+F5 / Cmd+Shift+R)
Als het echt ontbreekt in het sjabloon, voeg het dan opnieuw toe: Sectie → Apps toevoegen → ShopGuide Gesprek. Als het blok er is maar niets rendert, controleer de browser console voor JavaScript fouten, en probeer een andere browser of een incognito venster om een extensie uit te sluiten.
Stylingproblemen
Kleuren die niet overeenkomen met uw merk, zwakke contrast, of de bel overlappen een ander vast element op de pagina (een cart lade, kleverige add-to-cart bar, cookie banner, mobiele navigatie) alle terug te traceren naar dezelfde paar fixes: aanpassen van kleuren en de stijl template op de Uiterlijk pagina (zie Chatten-uitstraling en branding), probeer de tegenovergestelde hoek of schakel "Store heeft mobiele navigatiebalk" (zie Chattenpositionering & layout), of bereik voor Custom CSS met de echte keuzemogelijkheden van het widget voor alles wat de instellingen niet dekken (zie Geavanceerde chatstijl).
Chat opent maar reageert niet
Controleer of de bezoekerlimiet van uw plan niet is geraakt (ShopGuide admin → Billing), controleer uw eigen verbinding, open dan de browserconsole (F12) en zoek naar JavaScript of netwerkfouten. Testen in een andere browser, en met andere opslagapps of advertentieblokkers tijdelijk uitgeschakeld, sluit een conflict uit. Ook een snelle controle waard: de store-brede pauze schakelen.
Een paar browser-specifieke eigenaardigheden
Ad-blokkers en privacy-extensies soms blokkeren de chat script of zijn netwerkverzoeken Shopify's Customer Privacy APIEn het is de moeite waard om te bevestigen dat je op een redelijk actuele browser versie voordat escaleren verder.
Op mobiel specifiek
Een bubbel die te klein is om comfortabel te tikken, of een die een onderste navigatiebalk overlapt, meestal gewoon een grotere nodig heeft Bubbelgrootte instelling (Settings → Bubble) of "Store has mobile navigation bar" ingeschakeld. Een tragere reactie op oudere of low-end apparaten is het testen waard op een paar echte telefoons in plaats van alleen te vertrouwen op de mobiele preview van de thema-editor.
Themacompatibiliteit
Online-opslag 2.0 is vereist . app blokken bestaan niet op oudere thema-architecturen. Dawn en andere huidige thema's van de Thema Store werken uit de doos. Een sterk aangepaste of legacy thema kan een upgrade nodig hebben voordat het blok kan worden toegevoegd op alle; zie Shopify thema-editor basis.
Na elke thema-update, het is de moeite waard om drie dingen te bevestigen: het blok is nog steeds verbonden waar je verwacht, de bel verschijnt nog steeds en opent correct, en styling nog steeds overeenkomt met . . thema-updates soms reset aangepaste CSS elders geïnjecteerd.
Graven dieper
In de browser console (F12 op Chrome/Firefox, Ontwikkel → JavaScript Console op Safari tonen), zoek naar fouten van ShopGuide's eigen scripts secure-chat-core.js, chat-styles.css, ab-test-engine-bundle.js. Filter in het tabblad Netwerk voor verzoeken naar uw winkel /apps/proxy/... of /apps/ai-agent-proxy/... paden; een mislukt of traag verzoek daar wijst meestal op een abonnement, tarief-limit, of connectiviteit probleem in plaats van iets thema-gerelateerd.
Als dit alles niet oplost, contacteer dan ShopGuide ondersteuning met uw winkel .myshopify.com domein, uw themanaam en of het Online Store is 2.0, uw browser en versie, elke console foutmelding of schermafbeeldingen, en de stappen om het te reproduceren.