Solución de mensajes de error de plantillas de correo electrónico
Objetivos del artículo
Si encuentras errores o advertencias en una plantilla de correo electrónico, es posible que debas resolverlos antes de enviar el mensaje. Busca en este recurso el mensaje de error o la advertencia que estés viendo para encontrar consejos para resolver el problema.
Advertencias de envío de campañas
- Encontramos # bloques en tu correo electrónico que todavía tienen el texto predeterminado sin modificar o están en blanco. Revisa tu correo electrónico antes de continuar.
Si aparece esta advertencia, busca bloques vacíos o contenido de marcador de posición (p. ej., “Este es un bloque de texto. Presiona aquí para editarlo.”) en tu plantilla. Revisa las versiones de escritorio y móvil de la plantilla. Si no encuentras un bloque vacío o contenido de marcador de posición, envíate un mensaje de vista previa y revísalo tanto en escritorio como en móvil. Si la vista previa se ve bien, es seguro enviar el mensaje e ignorar esta advertencia. - Posibles problemas de contenido del correo electrónico. No parece que haya ningún enlace en el correo electrónico. ¿Se te olvidó agregarlos al correo electrónico?
Esta advertencia aparece si tu correo electrónico de texto sin formato o HTML personalizado no incluye ningún enlace. Revisa el mensaje para asegurarte de que se haya agregado todo el contenido, incluidos enlaces para cualquier llamado a la acción. Si no quieres incluir ningún enlace en el correo electrónico (además del enlace de cancelación de suscripción), puedes ignorar esta advertencia. - Enlace de cancelación de suscripción. No pudimos encontrar un enlace de cancelación de suscripción en el correo electrónico. Klaviyo agregará automáticamente un enlace de cancelación de suscripción al enviar el correo electrónico si no agregas uno.
Esta advertencia aparece si no agregaste una etiqueta de cancelación de suscripción a tu mensaje (p. ej., {% unsubscribe %} o {% unsubscribe_link %}). Agrega un enlace de cancelación de suscripción para evitar que se agregue el pie de página predeterminado de Klaviyo al mensaje.
Errores de vista previa
Al previsualizar un mensaje, es posible que encuentres este mensaje de error:
Mensaje mostrado sin etiquetas ni variables
Corrige las etiquetas de plantilla o variables no válidas para previsualizar el mensaje con perfiles y eventos reales.
Este error significa que hay una sintaxis no válida en algún lugar del mensaje. Para localizar el origen del error, revisa el asunto y el contenido del cuerpo del mensaje para ver si hay variables, etiqueta o declaraciones condicionales (es decir, cualquier cosa en la plantilla rodeada de llaves {}) que no sigan el formato descrito en los recursos del centro de ayuda de Klaviyo. A continuación, se incluyen algunos consejos para localizar el error:
- Revisa las versiones de escritorio y móvil del mensaje.
- Si tu mensaje contiene un cupón único, asegúrate de que el nombre del cupón sea correcto y de que el cupón se haya configurado en la pestaña cupón.
Errores de plantilla HTML personalizada
- No pudimos encontrar las siguientes imágenes: ... Asegúrate de que estén incluidas en el archivo zip que subiste.
Verifica que hayas escrito correctamente todas las rutas de origen de las imágenes y que coincidan con los nombres de archivo de las imágenes que subiste. Si en el mensaje de error no se proporcionan rutas de imágenes, revisa el archivo HTML para ver si hay atributos de fondo vacíos (p. ej., background=””) - Se requiere una etiqueta de {% cancelar la suscripción %}.
Agrega una etiqueta para cancelar la suscripción de Klaviyo al pie de página del mensaje para resolver este error. - No se pudo analizar el resto: 'Z' de 'XYZ'.
Este error significa que una de tus etiquetas (cualquier elemento rodeado por {% %}) no es reconocida por Klaviyo. Consulta nuestra guía de referencia de personalización de mensajes para ver las etiquetas aceptadas.
Errores del catálogo
Si la plantilla usa una etiqueta de búsqueda de catálogo, es posible que aparezca el error No se puede encontrar el artículo con el código: __. Es posible que se haya eliminado.
Si ves este error, significa que no reconocemos el ID del artículo incluido en la pestaña. Asegúrate de que:
- Estás previsualizando con un evento que contiene IDs de artículos (si el ID del artículo hace referencia de forma dinámica a los datos del evento).
- La referencia al ID de artículo de los datos del evento tiene el formato correcto.
- El ID del artículo de los datos del evento coincide con lo que está en el catálogo de Klaviyo.
Errores de plantillas de Shopify
- Error de sintaxis de Liquid en el HTML del cuerpo: etiqueta desconocida 'cancelar la suscripción'
Error de sintaxis de Liquid en el HTML del cuerpo: etiqueta desconocida 'web_view'
Estos errores, y otros similares, significan que se agregó una etiqueta específica de Klaviyo a tu plantilla antes de exportarla a Shopify. Shopify no admite los enlaces de cancelar la suscripción, administrar preferencias o vista web de Klaviyo. - Error de sintaxis de Liquid en el cuerpo Html: etiqueta desconocida "Load"
Shopify no puede admitir la función de bloque de productos de Klaviyo. Si añades un bloque de productos en tu plantilla de notificación de Shopify y luego importas esa plantilla a Shopify, aparecerá este error. Elimina el bloque de productos, exporta el HTML de la plantilla e impórtalo en Shopify. - Error de sintaxis de Liquid en el HTML del cuerpo: etiqueta 'elsif' desconocida
Error de sintaxis de Liquid en el HTML del cuerpo: la etiqueta 'if' nunca se cerró
Error de sintaxis de Liquid en el HTML del cuerpo: la etiqueta 'X' nunca se cerró
Muchas de las plantillas de notificaciones de Shopify de Klaviyo incluyen declaraciones condicionales, que hacen que el mensaje sea dinámico según el estado del pedido del cliente. Si se elimina parte de una declaración condicional, verás un error como los de arriba.
Para resolverlo, abre la plantilla en Klaviyo y elimina los elementos restantes de la declaración condicional. Busca etiquetas que comiencen con:- { % for item in...
- {% endfor %}
- {% if...
- {% elsif...
- {% else %}
- {% endif %}