Plantillas y editor de correos
Una plantilla es un mensaje listo para un canal: correo electrónico, mensaje de Telegram, SMS, Web Push, webhook y otros. Una misma plantilla la usan los recorridos, las campañas y el envío manual desde la ficha del perfil. Las variables insertan en el texto el nombre del cliente, el importe del pedido y otros datos.
La sección está en el menú Comunicaciones → Plantillas. Todos los roles pueden ver las plantillas; pueden crearlas y modificarlas los roles «Gestor» y superiores.
Creación de una plantilla
- Abra Plantillas. Arriba a la derecha hay un botón para cada canal activado en el proyecto, por ejemplo Correo electrónico o Telegram. Pulse el que necesite.
- Complete los campos generales (tabla siguiente).
- Complete el bloque Contenido. Los campos dependen del canal. En un correo son Asunto, Preencabezado (el texto que aparece junto al asunto en la lista de correos), Editor de correo electrónico o HTML, y la Versión de texto sin formato. Si no completa la versión de texto, se generará a partir del HTML.
- Pulse Guardar. Con cada guardado aumenta el número de versión («Versión 3»).
| Campo | Qué significa |
|---|---|
| Nombre | Solo se ve en la interfaz: en las listas de plantillas, recorridos y campañas |
| Canal | Se elige al crear la plantilla y no se puede cambiar después |
| Tema de suscripción | Por ejemplo, marketing o news. El cliente puede darse de baja solo de este tema |
| Mensaje transaccional | Se envía sin comprobar la suscripción, la frecuencia ni el horario de silencio, pero no a un canal cerrado para el destinatario: el buzón o el número no existen, el bot está bloqueado. Úselo solo para confirmaciones de pedido, restablecimientos de contraseña y mensajes similares; consulte Mensajes transaccionales y envíos en cascada |
Para eliminar una plantilla, pulse el icono de la papelera en su fila de la lista.
Variables
Las plantillas se escriben en el lenguaje Twig. Una variable se escribe entre llaves dobles. La lista completa con ejemplos se abre al desplegar el bloque Variables, debajo del contenido.
| Variable | Qué se inserta |
|---|---|
profile.email, profile.phone, profile.user_id |
Identificadores del cliente |
traits.first_name y otros traits.* |
Atributos del perfil |
event.name, event.properties.amount |
El evento que lanzó el mensaje |
context.data.*, context.nodes.* |
Datos del recorrido: los enviados al entrar mediante la API y la respuesta del nodo «Webhook» |
project.name, unsubscribe_url |
Nombre del proyecto y enlace de baja |
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url |
Cuenta en el programa de fidelización: saldo, nivel, puntos que caducan y su fecha, enlace de invitación |
promo_code('welcome') |
Código promocional del cliente del grupo welcome: se emite al enviar; en la vista previa, un ejemplo |
order.number, order.amount, order.tracking_url |
Pedido del correo de la tienda: número, importe, enlace de seguimiento; el importe con moneda es {{ order.amount|money(order.currency) }} |
product('SKU-1') |
Producto del catálogo en el idioma del correo: name, url, image, price, old_price, currency, available, stock, en el momento del envío (precios y disponibilidad de productos) |
¡Hola, {{ traits.first_name|default('cliente') }}!
{% if event.properties.amount > 5000 %}El envío es gratuito.{% endif %}
Las plantillas se ejecutan en un entorno aislado seguro. Admite condiciones if, bucles for, set, las funciones date, min, max y los filtros default, date, upper, lower, capitalize, number_format, round, join, replace, striptags, entre otros. Si una variable no existe, se inserta una cadena vacía, así que use default en los puntos importantes. Si usa una construcción prohibida, al guardar aparecerá el error «La plantilla usa una construcción prohibida». El mensaje final no puede superar los 512 KB.
Vista previa y envío de prueba
- En el panel Vista previa, introduzca el ID del perfil, el correo electrónico o el user_id y pulse el icono del ojo. Si deja el campo vacío, los datos se tomarán del perfil con la actividad más reciente.
- En un correo, cambie entre los modos Escritorio, Teléfono y Modo oscuro.
- En el panel Envío de prueba, elija la integración. Indique su propia dirección o chat id; de lo contrario, el mensaje se enviará a la dirección del perfil. Pulse Enviar prueba: bajo el botón aparecerá el estado del mensaje.
El envío de prueba está disponible para los roles «Gestor» y superiores. En él no se comprueban la suscripción, la frecuencia ni el horario de silencio. En la vista previa no hay evento disparador, por lo que las variables event.* quedarán vacías. Si no tiene permiso para ver datos personales, el correo electrónico y el teléfono aparecerán enmascarados.
Versiones de idioma
Una plantilla puede tener versiones en varios idiomas. Cada destinatario recibe la versión en el idioma de su perfil (el atributo language) o, si no existe, la principal. Los idiomas disponibles se configuran en los ajustes del proyecto.
- Encima del bloque Contenido, haga clic en Añadir idioma y elija un idioma. La versión nueva empieza como copia de la abierta: el diseño, las imágenes y los enlaces ya están, solo hay que traducir los textos.
- Cambie de versión con los botones de idioma. La versión principal está marcada como «principal».
- Para que los destinatarios sin versión propia reciban otro idioma, abra esa versión y haga clic en Hacer principal. Eliminar versión quita la versión abierta.
- Haga clic en Guardar. Cada versión se comprueba por separado; la que tiene errores lleva un icono de advertencia.
Borrador de traducción
Para no traducir una versión desde cero a mano, ábrala y haga clic en Borrador de traducción. OneTrace.ru traducirá la versión principal al idioma de la pestaña abierta: el asunto, el preencabezado, los textos de los bloques del generador, la versión de texto y los textos de SMS, push y mensajeros. Las variables como {{ traits.first_name }}, los enlaces, las imágenes y el diseño no cambian.
El borrador solo se inserta en el formulario. Léalo, corrija las formulaciones y haga clic en Guardar. Si algún campo no se ha podido traducir sin perder las variables, se quedará en el idioma de origen y OneTrace.ru mostrará cuántos campos son. Si la versión ya difiere de la principal, antes de reemplazarla aparecerá una pregunta.
El número de borradores al mes está limitado por el plan; consulte Planes. El botón no aparece si la traducción no está conectada en su instalación.
La versión se elige así: primero la coincidencia exacta del idioma, después el idioma sin región (un cliente con pt-BR recibe la versión pt) y después otra variante del mismo idioma. La vista previa y el envío de prueba muestran la versión abierta, y la variable {{ language }} contiene el idioma de la versión enviada.
Editor de correos
En una plantilla de correo electrónico, pulse Abrir el editor en el campo «Editor de correo electrónico». Si la plantilla ya tiene HTML, el editor empezará el correo desde cero y el código anterior se sustituirá al guardar. OneTrace.ru genera por sí mismo al guardar el código para los clientes de correo, incluidos Outlook y los teléfonos.
A la derecha del lienzo hay tres pestañas:
- Bloques: añadir un bloque. Se colocará después del bloque seleccionado o al final del correo, antes del pie.
- Bloque: configuración del bloque seleccionado en el lienzo. Los bloques se pueden subir, bajar, arrastrar, duplicar y eliminar.
- Correo: fondo, fondo del correo, colores del texto y de los enlaces, fuente, ancho del correo (480–800 px), márgenes y forma de mostrar las imágenes.
| Bloque | Para qué sirve |
|---|---|
| Encabezado, Texto | Texto con formato y variables, por ejemplo {{ traits.first_name }} |
| Imagen | Imagen de la mediateca: texto alternativo, enlace, ancho del 10 al 100 % |
| Botón | Texto, enlace, colores y radio de las esquinas |
| Separador, Espaciador | Una línea y un espacio vacío |
| Columnas | 2–3 columnas con encabezados, texto, imágenes, botones y espaciadores. En el teléfono, las columnas se apilan una debajo de otra |
| Productos | Una selección de recomendaciones: personalizados, populares, «Vistos juntos», «Similares», etc. Se pueden mostrar de 1 a 12 productos en 1–4 columnas, con precio y botón. Si no hay productos adecuados, el bloque no se incluye en el correo |
| Pedido | Pedido de un correo de la tienda: productos, importes, seguimiento del envío y direcciones. En los correos sin pedido, el bloque no aparece |
| HTML | Su propio código tal cual |
| Pie | Texto y enlace de baja |
El botón Cambiar a HTML de la pestaña «Correo» convierte el correo en código normal. Después ya no se puede volver al editor.
Enlace o adjunto
| Enlace (CDN) | Adjunta al correo | |
|---|---|---|
| Peso del correo | Ligero | Mayor, según el tamaño de las imágenes |
| Visualización | La imagen se carga al abrir el correo. Si el cliente de correo bloquea las imágenes, solo se ve el texto alternativo | La imagen se ve de inmediato |
La forma por defecto se define en el campo Visualización de imágenes por defecto de la pestaña «Correo». Para una imagen concreta se puede cambiar en el campo Visualización. Todos los adjuntos de un mismo correo no pueden superar 1 MB en total. Si los enlaces públicos no están configurados en la instalación, solo están disponibles los adjuntos.
Importar un email ya diseñado
Si el email ya está diseñado en otro servicio, no hace falta volver a crearlo. En la página Plantillas, pulse Importar email (IA):
- Elija Archivo y suba un email guardado desde su programa de correo (
.eml) o una página.html. O elija Código HTML y pegue el código del email. - Pulse Importar. La IA suele tardar hasta un minuto en procesar el email.
- Se abre el editor con una nueva plantilla de email: el email está dividido en bloques del editor, las imágenes se copian a la mediateca, el nombre del destinatario se sustituye por la variable
{{ traits.first_name }}y el enlace de baja pasa al bloque «Pie». Los textos y enlaces quedan como en el email. - Revise la plantilla y pulse Guardar. Hasta que la guarde, la plantilla no existe.
Si una parte del email no se pudo trasladar, aparece una lista sobre el formulario: qué imágenes no se copiaron o qué bloques se omitieron. Si el email no se puede dividir en bloques, se importa como un único bloque «HTML». Los píxeles de seguimiento y el enlace «Ver en el navegador» no se importan.
La importación está disponible en los planes «Crecimiento» y «Empresa»; el número de importaciones al mes depende del plan: consulte Planes. En el plan «Inicio», el botón indica a partir de qué plan está disponible la función.
Mediateca
La mediateca se abre al añadir un bloque «Imagen» o al pulsar Elegir imagen.
- Subir admite JPEG, PNG, GIF, WebP y AVIF de hasta 10 MB. Las imágenes anchas se reducen a 1200 px. Las WebP y AVIF se recodifican, porque no todos los clientes de correo las muestran. Los GIF se mantienen tal cual, con su animación.
- Si sube el mismo archivo otra vez, no se creará una copia.
- Una imagen que se usa en una plantilla no se puede eliminar hasta que la quite de la plantilla.
- El espacio ocupado por las imágenes cuenta para el límite del plan.
