Solucionar la extensión de tema de Shopify

Problemas habituales y soluciones al usar el bloque de tema del formulario de contacto de SupportRetriever en Shopify.

Problemas habituales

Problema 1: El bloque del formulario no aparece en el editor de tema

Síntomas:

• No encuentras "Formularioulario de contacto" en Apps al añadir bloques
• SupportRetriever no aparece en la lista de apps
• El editor de tema no muestra la opción del bloque

Posibles causas:

1. La app no está instalada en la tienda Shopify
2. El tema no admite bloques de apps (temas muy antiguos)
3. Caché del navegador
4. Tipo de sección incorrecto

Soluciones:

Solución 1: Comprobar la instalación de la app

1. Ve al admin de Shopify → Apps
2. Comprueba si SupportRetriever está en las apps instaladas
3. Si no, instálala desde la tienda de aplicaciones de Shopify
4. Actualiza el editor de tema

Solución 2: Comprobar compatibilidad del tema

1. Asegúrate de usar un tema Shopify 2.0 (la mayoría de 2021 en adelante)
2. Prueba a añadir el bloque en distintos tipos de sección:
   • Plantillas de página
   • Plantillas de producto
   • Secciones personalizadas
3. Si el tema es muy antiguo, valora actualizar a uno más reciente

Solución 3: Borrar la caché del navegador

1. Borra caché y cookies del navegador
2. Cierra sesión en el admin de Shopify
3. Vuelve a iniciar sesión e inténtalo de nuevo
4. Prueba otro navegador o modo incógnito

Solución 4: Usar el enlace directo

1. Inicia sesión en SupportRetriever
2. Ve a Ajustes → Integración con Shopify
3. Haz clic en el botón "Abrir editor de tema"
4. Se abrirá la ubicación correcta

---

Problema 2: El formulario sale en blanco o "Formularioulario no encontrado"

Síntomas:

• El bloque está añadido pero se ve un espacio en blanco
• Aparece el mensaje "Formularioulario no encontrado"
• Error 404 dentro del iframe

Posibles causas:

1. URL del formulario no configurada
2. URL incorrecta (error tipográfico)
3. El formulario se eliminó en SupportRetriever
4. RLS (seguridad a nivel de fila) bloqueando el acceso

Soluciones:

Solución 1: Añadir la URL del formulario

1. Haz clic en el bloque Formularioulario de contacto en el editor de tema
2. Mira el panel de ajustes a la derecha
3. Pega la URL de tu formulario en el campo "URL del formulario"
4. Obtén la URL en: SupportRetriever → Gestión de formularios

Solución 2: Verificar la URL del formulario

1. Copia la URL desde SupportRetriever
2. Pégala en una nueva pestaña del navegador
3. Comprueba que el formulario carga bien
4. Si no carga, la URL es incorrecta
5. Formularioato esperado: https://supportretriever.com/form/[id]

Solución 3: Comprobar que el formulario sigue existiendo

1. Inicia sesión en SupportRetriever
2. Ve a Gestión de formularios
3. Comprueba que tu formulario aparece en la lista
4. Si no, puede que se haya eliminado
5. Crea un nuevo formulario y actualiza la URL

Solución 4: Problemas de RLS (poco frecuente)

Si el formulario carga al abrirlo directamente pero no en Shopify:

1. Contacta con el soporte de SupportRetriever
2. Indica el ID de tu formulario
3. El soporte puede revisar los permisos RLS

---

Problema 3: El formulario se corta (muy bajo)

Síntomas:

• Solo se ve la parte superior del formulario
• El botón de envío no se ve
• Hay que desplazarse en un área pequeña

Causa: La altura configurada es demasiado baja

Solución:

1. Haz clic en el bloque Formularioulario de contacto en el editor de tema
2. Busca el control "Altura del formulario" en los ajustes
3. Aumenta la altura (recomendado 1000px)
4. Guarda y revisa la vista previa

Alturas recomendadas:

• Mínimo: 600px
• Cómodo: 800px
• Formularioulario completo: 1000px

---

Problema 4: No se pueden enviar mensajes de prueba

Síntomas:

• El botón de envío parece inactivo
• Los mensajes no se envían
• No hay confirmación al hacer clic en enviar

Posibles causas:

• Problema de conexión
• Configuración incorrecta del formulario
• Límite de tasa (demasiados envíos de prueba)

Solución:

1. Comprueba tu conexión a internet
2. Verifica que la URL del formulario en los ajustes del bloque sea correcta
3. Espera unos minutos si has enviado muchos mensajes de prueba (límite de tasa)
4. Revisa el panel de SupportRetriever para confirmar que el formulario está activo

Para probar el formulario:

1. Abre la URL del formulario directamente en una nueva pestaña
2. Envía un mensaje de prueba
3. Comprueba que aparece en tu bandeja de SupportRetriever

---

Problema 5: Los envíos no funcionan en el sitio en vivo

Síntomas:

• El formulario se ve bien
• El botón de envío está activo
• Pero no pasa nada al hacer clic en enviar
• O aparece un mensaje de error

Posibles causas:

1. Turnstile (protección anti-bots) no carga
2. Límite de correos superado
3. El navegador bloquea el envío
4. El correo destinatario del formulario no está verificado

Soluciones:

Solución 1: Esperar a Turnstile

El formulario incluye protección anti-bots que tarda un momento en cargar:

1. Espera 3-5 segundos después de cargar la página
2. Busca una pequeña marca de verificación o indicador
3. Luego envía el formulario

Solución 2: Comprobar límites de correo

1. Inicia sesión en SupportRetriever
2. Ve a Ajustes → Cuenta
3. Revisa el uso de correo
4. Si has llegado al límite, actualiza el plan o espera al reinicio

Solución 3: Desactivar extensiones del navegador

Algunas extensiones bloquean envíos:

1. Prueba en modo incógnito/privado
2. Desactiva bloqueadores de anuncios temporalmente
3. Revisa la consola del navegador por errores (F12)

Solución 4: Verificar el correo destinatario

1. Ve a SupportRetriever → Ajustes
2. Revisa el campo "Correo destinatario"
3. Asegúrate de que el correo esté verificado (revisa la bandeja el correo de verificación)
4. Reenvía la verificación si hace falta

---

Problema 6: El pie "Powered by SupportRetriever" no aparece

Síntomas:

• El formulario funciona pero no muestra el pie de SupportRetriever

Es normal:

El pie de marca de SupportRetriever se oculta automáticamente cuando el formulario está insertado en tiendas Shopify. El formulario detecta si se muestra en un iframe de tienda Shopify y oculta la marca para cumplir las políticas de marca de Shopify.

Dónde aparece la marca:

• ✅ Cuando el formulario se abre directamente (no en iframe)
• ✅ Cuando se inserta en sitios que no son Shopify
• ❌ Cuando se inserta en tiendas Shopify (se oculta por detección del referrer)

Cómo funciona: El formulario comprueba si está en un iframe y si la página padre está en un dominio .myshopify.com o shopify.com. En ese caso, la marca se oculta.

No hace falta hacer nada — es el comportamiento esperado.

---

Problema 7: El formulario se ve pero con problemas de estilo

Síntomas:

• Los colores no coinciden
• La maquetación se ve mal
• El texto no se lee bien
• El logo no aparece

Posibles causas:

1. El formulario no está personalizado en SupportRetriever
2. Problemas de contraste de color
3. URL del logo incorrecta
4. Compatibilidad del navegador

Soluciones:

Solución 1: Personalizar en SupportRetriever

La apariencia se controla en SupportRetriever, no en Shopify:

1. Inicia sesión en SupportRetriever
2. Ve a Gestión de formularios
3. Baja hasta "Apariencia del formulario"
4. Configura color de fondo, botón y texto
5. Añade la URL del logo si quieres
6. Guarda los cambios

Solución 2: Revisar el contraste

Asegura que el texto sea legible:

• Texto oscuro sobre fondo claro
• O texto claro sobre fondo oscuro
• Prueba con herramientas de accesibilidad

Solución 3: Corregir el logo

Si el logo no aparece:

1. Comprueba que la URL del logo sea correcta
2. Asegúrate de que la imagen sea accesible públicamente
3. Tamaño recomendado: 200px × 60px
4. Formularioatos PNG o JPG

---

Problema 8: Funciona en escritorio pero no en móvil

Síntomas:

• El formulario se ve y funciona en escritorio
• En móvil no se ve o no funciona
• Problemas de maquetación en pantallas pequeñas

Posibles causas:

1. La sección del tema no es responsive
2. Altura demasiado pequeña en móvil
3. Problemas concretos del tema en móvil

Soluciones:

Solución 1: Revisar ajustes del tema

1. Asegúrate de que la sección del formulario esté a ancho completo en móvil
2. Revisa la vista previa móvil del editor de tema
3. Comprueba que no haya ajustes de móvil que entren en conflicto

Solución 2: Ajustar la altura en móvil

El formulario es responsive, pero conviene una altura adecuada:

1. En móvil suele ir bien 600-800px
2. Prueba en la vista previa móvil del editor
3. Ajusta si hace falta

Solución 3: Probar en dispositivos reales

1. Publica los cambios
2. Visita el sitio en vivo desde un móvil
3. Prueba el envío
4. Prueba en varios dispositivos si puedes

---

Problema 9: El formulario carga lento

Síntomas:

• Espacio en blanco donde debería estar el formulario
• El formulario aparece al cabo de varios segundos
• Los clientes pueden no esperar a que cargue

Posibles causas:

1. Latencia de red
2. Página muy cargada
3. Tema de Shopify lento
4. Extensiones del navegador

Soluciones:

Solución 1: Optimizar la página

1. Quita apps/scripts innecesarios de la página
2. Optimiza las imágenes de la página
3. Usa un tema más rápido si es posible

Solución 2: Añadir indicador de carga

Puedes añadir un mensaje de carga encima del bloque en el contenido:

• "Cargando formulario de contacto..."
• Así el cliente sabe que está cargando

Solución 3: Probar la velocidad de red

1. Prueba en distintas conexiones
2. Comprueba si el problema es constante
3. Si va lento para todos, contacta con el soporte de SupportRetriever

---

Problema 10: No se puede editar ni quitar el bloque

Síntomas:

• El bloque aparece en el editor pero no se puede seleccionar
• No se puede eliminar el bloque
• No aparecen los ajustes

Soluciones:

Solución 1: Actualizar el editor de tema

1. Guarda los cambios
2. Sal del editor de tema
3. Vuelve a la página de Temas
4. Haz clic de nuevo en Personalizar

Solución 2: Editarar desde la sección

1. Haz clic en la sección que contiene el formulario
2. Usa los controles de la sección para gestionar bloques
3. Elimina o reordena desde la vista de sección

Solución 3: Borrar la caché del navegador

1. Borra caché y cookies
2. Reinicia el navegador
3. Vuelve a intentarlo

---

Problema 11: La URL del formulario cambia sin esperarlo

Síntomas:

• El formulario funcionaba y ahora muestra "Formularioulario no encontrado"
• La URL en los ajustes no es la esperada

Causa: El formulario se eliminó y se creó otro, generando una URL nueva

Solución:

Prevención:

• No elimines formularios sin necesidad
• Actualiza los ajustes en lugar de recrear

Corrección:

1. Inicia sesión en SupportRetriever
2. Obtén la URL actual en Gestión de formularios
3. Actualiza la URL en todos los bloques del tema de Shopify
4. Guarda y publica

---

Lista de diagnóstico

Usa esta lista para revisar los problemas de forma ordenada:

• La URL del formulario está pegada en los ajustes del bloque
• La URL es correcta (pruébala en el navegador directamente)
• El formulario existe en la cuenta SupportRetriever
• La altura del formulario es al menos 800px
• El correo destinatario está verificado en SupportRetriever
• No has superado el límite de uso de correo
• Has probado en otro navegador
• Has probado con las extensiones del navegador desactivadas
• Los cambios del editor están guardados y publicados
• Has probado en el sitio en vivo (no solo en el editor)

Obtener más ayuda

Si has probado las soluciones anteriores y sigues con problemas:

Estado de SupportRetriever

1. Visita la [página de estado de SupportRetriever]
2. Comprueba si hay incidencias
3. Revisa incidencias recientes

Contactar con soporte

Indica esta información al contactar:

• Descripción del problema: Qué ocurre y qué debería ocurrir
• URL del formulario: La URL concreta de tu formulario
• URL de la tienda Shopify: La dirección .myshopify.com de tu tienda
• Pasos realizados: Qué has probado ya
• Navegador/dispositivo: Con qué estás probando
• Capturas: Si el problema es visual

Soporte de Shopify

Para temas o editor de tema de Shopify:

1. Contacta con el soporte de Shopify
2. Indica que usas una extensión de tema de app
3. Nombre de la app: SupportRetriever

Recursos de la comunidad

• Documentación de SupportRetriever
• Documentación de extensiones de tema de Shopify
• Foros de la comunidad de Shopify

Buenas prácticas para evitar problemas

1. No elimines formularios: Mejor actualiza los ajustes
2. Prueba antes de publicar: Usa la vista previa del editor
3. Ten las URLs a mano: Guarda la URL del formulario en un sitio seguro
4. Revisa los límites de correo: Comprueba el uso con frecuencia
5. Actualiza poco a poco: Prueba los cambios antes de publicar
6. Documenta la configuración: Anota cómo tienes todo configurado
7. Pruebas periódicas: Envía mensajes de prueba de vez en cuando

Temas relacionados

• Instalar el bloque de tema del formulario de contacto
• Obtener la URL de tu formulario
• Personalizar la apariencia del bloque de tema
• El formulario no recibe envíos
• Problemas de entrega de correo