1. Mailjet
  2. Ayuda
  3. Documentación

Passport para Emails Transaccionales

Resumen

Introducción

Ya seas responsable de marketing, diseñador o programador, trabajar de forma conjunta para crear emails transaccionales atractivos nunca ha sido fácil... hasta hoy con Passport:

Los diseñadores de emails y los responsables de marketing pueden diseñar ahora fantásticas e impactantes plantillas transaccionales sin conocimientos de programación:

  • Diseña tus emails transaccionales con la función arrastrar y soltar.
  • Previsualiza tus emails en tiempo real en múltiples dispositivos.
  • Gestiona tus plantillas en la librería online de tu empresa.

Los desarrolladores también podrán usar funciones avanzadas para crear plantillas enriquecidas que adaptan sus contenidos a las características de los destinatarios:

  • Crea secciones condicionales gracias a las variables enviadas a Send API.
  • Usa bloques de código HTML.
  • Añade bucles condicionales y arrays usando el lenguaje de plantillas de Mailjet.
  • Convierte secciones diseñadas a lenguaje de plantillas en un solo clic.
  • Accede a muestras de código (Curl, PHP, Ruby, Java, …) para el proceso de prueba e integración.
  • Descarga cualquier plantilla en HTML.

Y recuerda, las plantillas creadas con Passport presentan un diseño adaptativo.

Crear una plantilla transaccional

Selecciona Transaccional → Mis Plantillas Transaccionales en el menú principal

Haz clic en el botón ‘Crear nueva plantilla’ para continuar.

El próximo paso es seleccionar una plantilla como base para diseñar tu email. Introduce un nuevo nombre para la plantilla y haz clic en 'Usar esta plantilla’.

Introduce el remitente principal y la información del email:

Recuerda: la información introducida aquí se usa para generar la muestra de código al final del proceso de creación de la plantilla y no se guarda con esta última. Deberás introducirla cada vez que utilices la plantilla en Send API.

Cuando hayas introducido todos los datos, haz clic en 'Guardar y diseñar tu plantilla'

Ahora empieza lo divertido: ¡personalizar tu plantilla con Passport! Para obtener información detallada sobre cómo utilizar todas las funciones de Passport, consulta nuestra guía de Passport.

Echemos un vistazo a las funciones avanzadas con las que podrás codificar emails transaccionales complejos...

[top]

Bloque de HTML

El bloque de HTML es una forma sencilla de diseñar un bloque de la forma que quieras y visualizarlo en tiempo real en tu plantilla de email. Arrastra el bloque de HTML a tu plantilla.

Haz clic en el bloque para seleccionarlo y después haz clic en el botón 'HTML' en la barra de herramientas para abrir la ventana del editor de HTML y empieza a codificar.



{IF} Lenguaje de plantillas

El bloque de lenguaje de plantillas permite introducir funciones avanzadas de plantillas en tu plantilla transaccional, como bucles, sentencias condicionales, arrays y mucho más.

El lenguaje de plantillas de Mailjet se basa en sintaxis de plantillas populares (como Django y Twig) y te permite añadir elementos lógicos a tu email para incluir o eliminar secciones. La Guía de referencia sobre lenguaje de plantillas completa está disponible en dev.mailjet.com en Transactional Templating.

Basta con hacer clic en el bloque de lenguaje de plantillas {IF} y arrastrarlo a tu plantilla.

¡Y ya puedes empezar a codificar!

En este ejemplo, queremos enviar un código de descuento a cualquier cliente que haya realizado al menos 5 pedidos con anterioridad. Con la variable “totalorders”, que se transmitirá a Send API, podrás crear la sentencia condicional simple:

{% if var:PedidosTotales> "5" %}
¡Usa el código de descuento #1CUST para disfrutar de un 10% de descuento en tu próximo pedido!
{% endif %}

Cuando hayas terminado de codificar, haz clic en 'Validar código’. El bloque de lenguaje de plantillas no se puede visualizar en tiempo real en Passport: siempre aparecerá como un bloque negro con el número total de líneas de código y de variables.

[arriba]

Secciones condicionales

Con las secciones condicionales, podrás mostrar secciones de contenido en tu email según el valor de la variable enviada con Send API.

Por ejemplo, quieres enviar una oferta especial exclusiva para los clientes que vivan en Nueva York con el email de confirmación de su pedido. Básicamente, si la ciudad (la variable enviada a Send API) equivale a Nueva York (el valor definido en tu plantilla transaccional), se mostrará la sección de la oferta especial exclusiva cuando se envíe el email.

Pasa el ratón por encima de una sección para ver sus condiciones actuales.

Por defecto, las secciones no tienen condiciones: 'Mostrar siempre esta sección'.

Para crear una condición, haz clic en la sección que deseas y a continuación en 'Añadir condición'.

Después, rellena los campos:

1) Clic Solo si.
2) Nombre de la variable: el nombre del parámetro que se enviará a Send API.
3) Selecciona un operador de la lista desplegable (iguales, no iguales, etc.).
4) Introduce un valor (verdadero, falso, valor alfanumérico, etc.).

En el ejemplo mencionado anteriormente, esta es la sección condicional 'Oferta especial exclusiva' para los clientes que viven en Nueva York:

Aunque tu límite sea una condición simple “if”, puedes imitar una sentencia “if else” al crear una condición en otra sección con el valor contrario.

Para ver la condición solo tendrás que pasar el ratón por encima de la sección o hacer clic en ella.

Para suprimir una condición, haz clic en la sección que deseas y a continuación en ‘Editar’.

A continuación selecciona la opción 'Siempre'.

[arriba]

Modo de previsualización en tiempo real

Para previsualizar tu plantilla, haz clic en ‘Previsualizar email’.

El modo de previsualización avanzado permite definir los valores de tus variables para previsualizar en tiempo real tus emails transaccionales en diferentes dispositivos (móvil, ordenador).

En la ventana 'Previsualización de variables', Passport ha identificado las variables presentes en tu email, incluidas todas las variables definidas en las secciones condicionales y en los bloques de lenguaje de plantillas.

Recuerda: las secciones condicionales no pueden ejecutarse en el modo de previsualización. Para ver el resultado final de email transaccional, puedes enviarte a ti mismo un mensaje de prueba.

[arriba]

Enviar una prueba

Puedes enviar un email de prueba para ver el comportamiento de tu email con las secciones condicionales.

Hay dos opciones de tests posibles:

  • Enviar un email de prueba (igual que enviar una campaña de prueba)
    Antes de enviar un email de prueba, ve a ‘Previsualizar email’ e introduce los marcadores de posición de las variables que tengas.
  • Utilizar la API de envío
    Si seleccionas usar la API de envío para hacer un test, aparecerá un modal en el que se mostrará el atributo de la versión de la plantilla que necesitas añadir a tu llamada API, con muestras de código que puedes copiar fácilmente.

Solución de problemas sobre emails de prueba

Al usar las funciones del lenguaje de creación de plantillas en Passport, es posible cometer errores de sintaxis que pasen inadvertidos. Si se identifica un error de sintaxis en tus emails de prueba, Mailjet no enviará el mensaje.

Estos son algunos errores de sintaxis habituales:

  • Una variable no tiene valor predeterminado en la plantilla, pero se usa al llamar a la API.
  • Falta una variable en la solicitud Send API.

Es fundamental poder solucionar los problemas de la plantilla transaccional antes de usarla en producción. Con Passport, puedes recibir un mensaje de error si la plantilla contiene un error de sintaxis.

En realidad, cuando se produce un error de sintaxis, el motor de procesamiento del lenguaje de creación de plantillas puede identificar el problema. Se enviará un mensaje desde templating-language-error@mailjet.com a la dirección indicada, incluyendo el mensaje de error en el cuerpo de y un archivo adjunto con la fuente del mensaje original.

Aquí pueden verse algunos de errores comunes:

expression parsing error ## Unknown identifier: var:day ## near ## {{var:day ##
Falta una variable en “Vars”; para solucionarlo, añade un valor predeterminado al “Var” de la plantilla

not valid template ## near ## y}} ##
Falta el final si ({% if var:day %}{{var:day}})

"var:day" is not an array value
Intentando crear un bucle en un sin matriz “var”

Una vez detectado y corregido el problema de sintaxis, solo tienes que enviar otro mensaje de prueba.

Si la plantilla se ha aprobado por completo y está lista para su producción, recuerda que también puedes utilizar este sistema de informes de error para ti. Solo tienes que añadir los siguientes encabezados a tu solicitud de envío de API:

  • MJ-TemplateErrorReporting: Dirección de email a la que se envía una copia de carbón con el mensaje de error.
  • MJ-TemplateErrorDeliver: Define si el mensaje se entrega al destinatario aunque se detecte un error en el lenguaje de creación de plantillas.

De forma predeterminada, la entrega de un mensaje con errores al destinatario está desactivada.

Echa un vistazo a nuestra Guía Transactional Templating Guide para obtener más información.

Utilizar tu plantilla

Haga clic en ‘Guardar y publicar’.

Enhorabuena, has creado tu nueva plantilla transaccional. Para ayudarte a integrarla rápidamente en tus entornos, te proponemos varias muestras de código: Curl, PHP, Node, Ruby, Python, Go, Java, C#.

Recuerda que debes definir los valores de las variables en la muestra de código. Te recomendamos probar la plantilla en un entorno de preproducción para definir los valores de las variables y visualizar los datos finales de tus emails transaccionales.

Y eso es todo, ¡ya puedes utilizar tu plantilla en producción!

    Si tienes alguna pregunta sobre cómo utilizar Passport para crear emails transaccionales, contacta con nuestro equipo de asistencia.

    [arriba]

¿Quiere probar Mailjet ahora?
Abrir una cuenta - sin compromiso ni tarifas ocultas