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 con el contenido del correo electrónico. Parece que no hay ningún enlace en el correo electrónico. ¿Olvidaste agregarlos al correo electrónico?
Esta advertencia aparece si el 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 los enlaces de cualquier llamado a la acción. Si no quieres incluir ningún enlace en el correo electrónico (excepto el enlace de cancelación de suscripción), puedes ignorar esta advertencia. - Enlace de cancelación de suscripción. No se encontró un enlace de cancelación de suscripción en esta plantilla. Klaviyo añadirá automáticamente un enlace de cancelación de suscripción al enviar el correo electrónico.
Esta advertencia aparece si no agregaste una etiqueta de cancelar la 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 a tu mensaje el pie de página predeterminado de Klaviyo.
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 mensaje significa que Klaviyo no pudo renderizar una etiqueta de plantilla o una variable. Para ubicar el origen del error, revisa el asunto y el contenido del cuerpo del mensaje para ver si hay variables, etiquetas o declaraciones condicionales (es decir, cualquier elemento de la plantilla entre {{ }} or {% %}) que no sigan el formato descrito en la referencia de personalización de mensajes. A continuación se incluyen algunos consejos para ubicar el error:
- Revisa las versiones de escritorio y móvil del mensaje.
- Si el 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 Cupones.
Después de corregir el problema, vuelve a previsualizar el mensaje con un perfil o un evento que contenga los datos que usa la plantilla. Confirma que las variables se completen antes de enviar un email de prueba.
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.
Revisa 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 no se proporcionan rutas de imagen en el mensaje de error, revisa el archivo HTML para ver si hay atributos background vacíos (por ejemplo,background=""). Elimina los atributos background vacíos y luego vuelve a subir el archivo HTML corregido. - 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 Klaviyo no pudo leer parte de una expresión de plantilla. Revisa la expresión citada en el error para identificar comillas mal colocadas o repetidas, espacios en los nombres de las propiedades o sintaxis de filtro incorrecta. El problema puede estar dentro de las variables {{ }} o las etiquetas {% %}. Consulta la referencia de personalización de mensajes para ver la sintaxis compatible y ejemplos.
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 etiqueta. 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).
- Si el ID del artículo proviene de los datos del evento o de una propiedad del perfil, la referencia tiene el formato correcto.
- El ID del artículo en la etiqueta, los datos del evento o la propiedad del perfil coincide con un artículo en el catálogo de Klaviyo.
Errores de plantillas de Shopify
- Body html Liquid syntax error: Unknown etiqueta 'cancelar la suscripción'
Body html Liquid syntax error: Unknown etiqueta 'web_view'
Estos errores y otros similares significan que se agregó una etiqueta específica de Klaviyo a la plantilla antes de exportarla a Shopify. Shopify no es compatible con los enlaces de cancelar la suscripción, administrar preferencias o ver en el navegador de Klaviyo. Elimina esos enlaces específicos de Klaviyo de la plantilla de notificación de Shopify antes de exportarla de nuevo. - Error de sintaxis Liquid en el HTML del cuerpo: etiqueta desconocida "Load"
Este error indica que el HTML exportado contiene una etiqueta específica de Klaviyo que Shopify no admite. Si la plantilla de notificación de Shopify contiene un bloque de producto de Klaviyo, elimínalo, 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 instrucciones condicionales, que hacen que tu mensaje sea dinámico según el estado del pedido del cliente, y bucles, que repiten el contenido para los artículos de un pedido. Si se elimina parte de una instrucción o bucle, puedes ver un error como los anteriores.
Para resolver esto, abre la plantilla en Klaviyo y restaura las etiquetas faltantes. Cada {% if ... %} necesita un {% endif %} correspondiente, y cada {% for ... %} necesita un {% endfor %} correspondiente. Mantén {% elsif ... %} y {% else %} dentro de su instrucción correspondiente. Si eliminas intencionalmente una instrucción o un bucle, elimina todo el bloque, incluido el contenido, para que no queden etiquetas sin correspondencia ni variables de artículos. Busca estas etiquetas de apertura, bifurcación y cierre:- {% for item in...
- {% endfor %}
- {% if...
- {% elsif...
- {% else %}
- {% endif %}
Después de realizar cambios, exporta la plantilla actualizada e impórtala en Shopify. Vista previa y prueba la notificación en Shopify antes de guardarla. Las variables de notificación de Shopify se completan en Shopify; una vista previa de Klaviyo solo te permite revisar el estilo.