Aplica a: EnvíaloSimple Transaccional · Tiempo estimado: 15 min
¿Qué vas a lograr?
Crear plantillas de email transaccional para usarlas a través de la API, con soporte para personalización simple con variables y personalización avanzada con Twig.
Antes de empezar
Las plantillas de Email Transaccional están diseñadas exclusivamente para usarse a través de la API. No es posible usarlas directamente en clientes de correo como Thunderbird, Outlook o Gmail.
Crear una plantilla
En el menú lateral, andá a Plantillas y hacé clic en Crear plantilla
Asigná un nombre, agregá etiquetas opcionales para encontrarla más fácilmente y elegí una estructura base
Hacé clic en Crear
En el editor podés incluir textos (títulos, párrafos, listas), imágenes, botones, espaciadores, código HTML y redes sociales.
En la sección Asunto y Cabeceras completá el asunto, remitente y email para poder enviar pruebas.
Al terminar, hacé clic en Guardar.
Personalización simple
Podés insertar variables en el asunto, en bloques de texto y en código HTML usando la sintaxis {{nombre}}. Por ejemplo: {{nombre}}, {{ciudad}}, {{producto}}.
También podés agregarlas desde el botón de personalización incluido en la barra de acciones del componente texto.
Personalización avanzada con Twig
Twig es un motor de plantillas que permite personalización dinámica más compleja. Solo un subconjunto de operaciones están soportadas.
Variables simples y objetos:
twig
{{ usuario.nombre }}
{{ producto.precio }}
Expresiones:
twig
{{ variable + 1 }}
{{ precio * cantidad }}
Tags disponibles: autoescape, for, do, if, set, verbatim
twig
{% if stock > 0 %}
<p>¡Producto disponible! Quedan {{ stock }} unidades en stock.</p>
{% else %}
<p>¡Producto agotado!</p>
{% endif %}{% for producto in productos %}
<li>{{ producto.nombre }} - ${{ producto.precio }}</li>
{% endfor %}Filtros disponibles: abs, batch, capitalize, date, date_modify, default, escape, first, format, join, keys, last, length, lower, merge, nl2br, number_format, raw, replace, reverse, slice, sort, split, title, trim, upper, url_encode, filter
twig
{{ texto | upper }}
{{ fecha | date("d/m/Y") }}Funciones disponibles: attribute, range, cycle, date, random
twig
{{ random() }}
{{ range(1, 10) }}El código Twig puede incluirse en el asunto, en bloques de texto y en código HTML.
Vista previa y envío de prueba
Hacé clic en Vista previa para acceder a dos solapas: Vista previa y Enviar prueba.
Vista previa
Si la plantilla usa contenido dinámico, activá Ver contenido dinámico y configurá los valores de las variables desde el botón Configurar variables.
Todas las variables usadas en el contenido aparecen listadas para completar — los valores quedan guardados para la próxima prueba.
Para configurar las variables tenés tres vistas disponibles: Árbol, Formulario y Código.
Enviar prueba
Acá se completan los campos del destinatario para enviar el email.
Para que se habilite esta funcionalidad no deben existir errores en tu plantilla.
Cuando esto suceda aparecerá el botón Con errores en donde podrá verse un detalle de donde está el problema.
Los errores se dan cuando sucede alguna de las siguientes situaciones:
Errores de sintaxis en el contenido.
En Asunto y cabeceras faltan completar datos requeridos o no son válidos.