Solución de problemas de integración de temas
Integrar ShopGuide con un tema va bien la mayoría de las veces, pero cuando no lo hace, la causa suele ser una de unas pocas cosas predecibles.
El bloque de chat no está apareciendo
Ya sea que no esté en la categoría de aplicaciones del editor de temas, o simplemente no aparezca en las páginas en vivo, haga esto en orden:
- Confirmar ShopGuide se ha instalado y su suscripción o prueba está activa (ShopGuide Admins → Settings/Billing)
- Confirme que su tema es Online Store 2.0 los temas más antiguos no admiten los bloques de aplicaciones en absoluto; ver Shopify Basics de la edición de temas
- Confirmar el ShopGuide Chat bloque se añade a la página o plantilla que está mirando un bloque sólo se hace donde se ha colocado
- Confirmar Pausa chat frente a la tienda no está encendido (ShopGuide Admin → Configuración)
- Eliminar el cache del navegador y el refresco duro (Ctrl + F5 / Cmd + Shift + R)
Si realmente falta en la plantilla, añade de nuevo: Añadir sección → aplicaciones → ShopGuide ChatSi el bloqueo está ahí pero nada se da, compruebe la consola del navegador para detectar errores de JavaScript, y pruebe un navegador diferente o una ventana incógnito para descartar una extensión.
Problemas de estilo
Los colores no coinciden con su marca, el contraste débil o la burbuja superpuesta otro elemento fijo en la página (un cajón de carrito, barra de complementos pegajosa, banner de cookies, navegación móvil) todos remontan a las mismas correcciones: ajustar los colores y la plantilla de estilo en la página Apariencia (ver Apariencia y marca de chat), intenta la esquina opuesta o activa "La tienda tiene barra de navegación móvil" (ver Posicionamiento y diseño de chat), o alcanzar a Custom CSS con los selectores reales del widget para cualquier cosa que las configuraciones no cubran (ver Estilo avanzado de chat).
Se abre el chat pero no responde.
Compruebe que el límite de visitantes de su plan no ha sido alcanzado (ShopGuide Admin → facturación), compruebe su propia conexión, luego abra la consola del navegador (F12) y busque errores de JavaScript o de red.
Algunas peculiaridades específicas del navegador
Los bloqueadores de anuncios y las extensiones de privacidad bloquean ocasionalmente el script del chat o sus solicitudes de red el modo incógnito con las extensiones apagadas es la forma más rápida de descartar esto. La protección de seguimiento de Safari y Firefox puede interferir con cualquier cosa que dependa del consentimiento de análisis, como los mensajes proactivos, que solo se cargan una vez que se otorga el consentimiento que es el comportamiento esperado vinculado a ShopifyLa privacidad del cliente APIY vale la pena confirmar que estás en una versión razonablemente actual del navegador antes de escalar algo más.
En móvil específicamente
Una burbuja que es demasiado pequeña para tocar cómodamente, o que se superpone a una barra de navegación inferior, por lo general sólo necesita una mayor Tamaño de burbuja La respuesta más lenta en dispositivos más antiguos o de gama baja vale la pena probar en un par de teléfonos reales en lugar de confiar solo en la vista previa móvil del editor de temas.
Compatibilidad de temas
Online Store 2.0 Se requiere los bloques de aplicaciones no existen en las arquitecturas de temas más antiguas. Dawn y otros temas de la tienda de temas actuales funcionan fuera de la caja. Un tema muy personalizado o heredado puede necesitar una actualización antes de que el bloque pueda agregarse en absoluto; ver Shopify Basics de la edición de temas.
Después de cualquier actualización del tema, vale la pena confirmar tres cosas: el bloque todavía está conectado donde se espera, la burbuja todavía aparece y se abre correctamente, y el estilo todavía coincide actualizaciones del tema ocasionalmente restablecer personalizado CSS inyectado en otro lugar.
Cavar más profundo
En la consola del navegador (F12 en Chrome/Firefox, Desarrollar → Mostrar Consola JavaScript en Safari), buscar errores en ShopGuideSus propios guiones secure-chat-core.js, chat-styles.css, ab-test-engine-bundle.jsEn la pestaña Red, filtra las solicitudes a la tienda /apps/proxy/... o /apps/ai-agent-proxy/... las vías; una solicitud fallida o lenta allí suele indicar un problema de suscripción, límite de tarifa o conectividad en lugar de algo relacionado con el tema.
Si nada de esto lo resuelve, comuníquese con ShopGuide apoyo con la tienda .myshopify.com domNo, tu nombre de tema y si es Online Store 2.0, su navegador y la versión, cualquier mensaje de error de consola o capturas de pantalla, y los pasos para reproducirlo.