Utiliza el lenguaje de plantillas de Brevo para personalizar tus mensajes con datos específicos de contactos o eventos, ocultar o mostrar contenido a destinatarios específicos y ajustar cómo se formatean los valores.
💬 Variables
Las variables, también conocidas como marcadores de posición o etiquetas personalizadas, son etiquetas que puedes insertar en tus mensajes para personalizarlos. Cuando envías un mensaje, cada variable se reemplaza automáticamente con la información del contacto correspondiente.
Las variables deben estar entre llaves dobles, como {{ ... }} o {{...}}. Se pueden utilizar para inserciones simples o combinarse con declaraciones condicionales y filtros para una personalización avanzada.
| Tipo de variable | Caso de uso |
|---|---|
| 👤 Variables de contacto | Atributos de contacto estáticos (nombre, email…) |
| ⚡ Variables de evento | Datos de una acción activada |
| 🛢️ Variables de feed de datos | Datos en tiempo real de una fuente externa |
| 🛒 Variables del feed de productos | Listados dinámicos de productos |
| 📦 Variables de objeto | Atributos de objeto personalizados |
| 📅 Variable de fecha | Sello temporal de envío |
| 🔗 Variables de enlace y vista previa de email | Enlaces de espejo, cancelación de suscripción, actualización de perfil y confirmación doble |
👤 Variables de contacto
| Disponible para: | ✅ SMS | ✅ Push |
La sintaxis es {{ contact.ATTRIBUTE }}, donde debes reemplazar ATTRIBUTE por el nombre exacto del atributo de contacto tal y como aparece en la página Contact attributes (Atributos de contacto). Se admiten tanto los atributos predeterminados como los personalizados.
Por ejemplo:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ contact.EMAIL }} | Dirección de email (predeterminada) | abby@the-green-yoga.com |
| {{ contact.FIRSTNAME }} | Nombre (predeterminado) | Abby |
| {{ contact.SMS }} | Número de teléfono (predeterminado) | +12152688872 |
| {{ contact.LANGUAGE }} | Idioma (personalizado) | Inglés |
➡️ Para obtener más información, consulta nuestros artículos al respecto:
⚡ Variables de evento
| Disponible para: | ✅ Email (solo activado) |
✅ SMS (solo activado) |
✅ WhatsApp (solo activado) |
✖️ Push |
Las variables de evento te permiten mostrar datos de eventos específicos activados por las acciones de un contacto, como el precio del último artículo comprado o el nombre de la reunión que reservó.
Para identificar las variables disponibles, consulta tu llamada API o los logs de eventos en Brevo. Los ejemplos que se muestran a continuación se basan en la siguiente estructura JSON:
|
data es el objeto raíz que contiene las siguientes propiedades:
|
El objeto raíz (data arriba) es obligatorio. El resto de propiedades son opcionales y pueden nombrarse según sea necesario.
Según dónde se almacenen tus datos en la estructura JSON, la sintaxis varía:
Los datos almacenados directamente en el objeto raíz suelen contener detalles clave de eventos, como información del carrito, y se pueden recuperar sin necesidad de recorrer matrices.
La sintaxis es {{ params.property }}, donde debes reemplazar property por el nombre exacto de la propiedad que se encuentra en el objeto raíz en tu estructura JSON.
Dada la estructura JSON anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ params.id }} | ID del carrito | cart:1234 |
| {{ params.total }} | Total del carrito | 280 |
| {{ params.currency }} | Divisa del carrito | USD |
| {{ params.url }} | URL del carrito | http://www.ejemplo.com |
Las matrices almacenadas en el objeto raíz, como la matriz items anterior, pueden contener varios elementos, cada uno con sus propias propiedades. Utiliza la indexación para hacer referencia a elementos específicos, o un bucle for para iterar sobre todos ellos.
Utilizar la indexación para hacer referencia a elementos específicos
La sintaxis para la indexación es {{ params.array.index.property }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- array debe reemplazarse por el nombre exacto de la matriz que se encuentra en el objeto raíz en tu estructura JSON.
- index con la posición del elemento que quieres referenciar, empezando desde 0 para el primer elemento.
- property por el nombre exacto de la propiedad que se encuentra dentro del elemento de la matriz, tal como aparece en tu estructura JSON.
Dada la estructura JSON anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ params.items.0.name }} | Nombre del primer elemento | Zapatos negros |
| {{ params.items.1.name }} | Nombre del segundo elemento | Camisa blanca |
Utilizar un bucle for para iterar sobre todos los elementos
La sintaxis del bucle for es {% for item in params.array %} {{ item.property }} {% endfor %}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- array debe reemplazarse por el nombre exacto de la matriz que se encuentra en el objeto raíz en tu estructura JSON.
- property por el nombre exacto de la propiedad que se encuentra dentro del elemento de la matriz, tal como aparece en tu estructura JSON.
Dada la estructura JSON anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {% for item in params.items %} {{ item.name }} {% endfor %} | Todos los nombres de los elementos |
Zapatos negros Camisa blanca |
➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.
🛢️ Variables de feed de datos
| Disponible para: | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Las variables de feed de datos te permiten incorporar datos en tiempo real de una fuente externa o una API directamente en tus mensajes. Para identificar las variables disponibles, ve a Settings (Configuración) > Data management (Gestión de datos) > Data feeds (Feed de datos) y comprueba la estructura de tu archivo de origen:
Según la complejidad de la estructura de tu feed de datos, el formato varía:
Los datos almacenados directamente en el objeto raíz suelen contener la entidad más relevante e inmediata de tu feed, como el próximo evento o el producto más reciente, y se pueden recuperar sin necesidad de recorrer las matrices.
La sintaxis es {{ feed.feedalias.variable }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- feedalias con el nombre de alias exacto de tu feed de datos, con la misma ortografía y mayúsculas y minúsculas que aparece en la página Data feeds (Feeds de datos).
- variable con el nombre de campo o variable específico que quieres mostrar.
Dado el feed de datos anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ feed.next_yoga_class.class_name }} | Nombre de la clase | Sunrise Vinyasa |
| {{ feed.next_yoga_class.studio_location }} | Ubicación del estudio | Estudio en el centro |
| {{ feed.next_yoga_class.date }} | Fecha de la clase | 2025-03-07 |
| {{ feed.next_yoga_class.time }} | Horario de la clase | 06:30 AM |
Las matrices almacenadas en el objeto raíz pueden contener varios elementos, cada uno con sus propias propiedades. Utiliza la indexación para hacer referencia a elementos específicos o un bucle for para iterar sobre todos ellos.
Utilizar la indexación para hacer referencia a elementos específicos
La sintaxis para la indexación es {{ feed.feedalias.array.index.variable }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- feedalias con el nombre de alias exacto de tu feed de datos, con la misma ortografía y mayúsculas y minúsculas que aparece en la página Data feeds (Feeds de datos).
- array con el nombre de la matriz que contiene los valores de cada artículo.
- index con la posición del elemento específico que quieres mostrar, empezando desde 0 para el primer elemento.
- variable con el nombre de campo o variable específico que quieres mostrar, por ejemplo, nombre, precio o fecha.
Dado el feed de datos anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ feed.yoga_classes.following_classes.0.class_name }} | Nombre de la primera clase | Power Flow Yoga |
| {{ feed.yoga_classes.following_classes.1.class_name }} | Nombre de la segunda clase | Evening Restorative |
Utilizar un bucle for para iterar sobre todos los elementos
La sintaxis del bucle for es {% for item in feed.feedalias.array %} {{ item.variable }} {% endfor %}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- feedalias con el nombre de alias exacto de tu feed de datos, con la misma ortografía y mayúsculas y minúsculas que aparece en la página Data feeds (Feeds de datos).
- array con el nombre de la matriz que contiene los valores de cada artículo.
- variable con el nombre de campo o variable específico que quieres mostrar, por ejemplo, nombre, precio o fecha.
Dado el feed de datos anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes %} {{ item.class_name }} {% endfor %} | Todos los nombres de clases |
Power Flow Yoga Evening Restorative Fundamentos del Hatha Yoga Yin Yoga y Meditación ... |
➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.
🛒 Variables del feed de productos
| Disponible para: | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Las variables de feed de productos te permiten mostrar una lista dinámica de productos de tu tienda online, incluidos detalles como el nombre, la descripción, los precios, las imágenes y la disponibilidad.
La sintaxis es {{ feed.feedalias.products.variable }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- feedalias con el nombre exacto de tu feed de productos, con la misma ortografía y mayúsculas y minúsculas que aparece en la página Product feeds (Feeds de productos).
- variable con el nombre del campo que quieres mostrar.
Dado el feed de productos anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ feed.mats_bestseller.products.imageUrl }} | Imagen del producto | |
| {{ feed.mats_bestseller.products.name }} | Nombre del producto | Esterilla de yoga antideslizante - 6 mm |
| {{ feed.mats_bestseller.products.url }} | URL del producto | https://thegreenyoga.com/non-slip/black-mat.html |
Utilizar un bucle for para iterar sobre todos los elementos
La sintaxis del bucle for es {% for item in feed.feedalias.products %} {{ item.variable }} {% endfor %}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- feedalias con el nombre de alias exacto de tu feed de datos, con la misma ortografía y mayúsculas y minúsculas que aparece en la página Data feeds (Feeds de datos).
- variable con el nombre de campo o variable específico que quieres mostrar, por ejemplo, nombre, precio o fecha.
Dado el feed de productos anterior:
| Entrada | Descripción | Resultado |
|---|---|---|
|
{% for item in feed.mats_bestseller.products %} {{ item.name }} {% endfor %} |
Todos los nombres de productos |
Esterilla de yoga antideslizante - 6 mm Bloque de yoga - 4 pulgadas Pantalones de yoga de cintura alta y pierna ancha |
➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.
📦 Variables de objeto
| Disponible para: | ✅ Email (solo automatización) |
✅ SMS (solo automatización) |
✖️ WhatsApp | ✖️ Push |
Las variables de objeto te permiten incluir detalles sobre tus objetos personalizados o sus objetos asociados en tus mensajes. Solo se pueden utilizar en automatizaciones, ya que dependen de que un registro de objeto específico sea el disparador de la automatización.
Para crear variables de objeto, necesitarás el nombre del objeto y los ID de atributos de la página Custom objects settings (Configuración de objetos personalizados). Según los datos que quieras mostrar, la sintaxis varía:
Las variables de datos de objeto te permiten mostrar atributos del registro de objeto personalizado que activó la automatización, como el importe de una cotización o la fecha de creación.
La sintaxis es {{ feed.object.attributes.variable }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- object con el nombre en singular de tu objeto personalizado, tal y como lo definiste al crearlo.
- variable con el ID del atributo que quieres mostrar, por ejemplo, nombre, importe o fecha. Puedes encontrar los ID de atributos haciendo clic en el nombre del objeto en la página Custom objects settings (Configuración de objetos personalizados).
Pongamos como ejemplo un objeto de presupuesto con los atributos importe, fecha, id_presupuesto y pagado:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ feed.quote.attributes.amount }} | Importe del presupuesto | 350 |
| {{ feed.quote.attributes.date }} | Fecha de creación del presupuesto | 2025-03-29T00:04:11+00:00 |
| {{ feed.quote.attributes.paid }} | Estado del pago | true |
| {{ feed.quote.attributes.id_quote }} | ID del presupuesto | OQPPBDCSSZQ9 |
Las variables de datos de objetos asociados te permiten mostrar atributos de objetos vinculados al objeto personalizado que activó la automatización. Utiliza la indexación para hacer referencia a registros específicos o un bucle for para iterar sobre todos ellos.
Utilizar la indexación para hacer referencia a elementos específicos
La sintaxis de indexación es {{ feed.object.associations.associatedobject.index.variable }}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- object con el nombre en singular de tu objeto personalizado, tal y como lo definiste al crearlo.
- associatedobject con el nombre en singular de tu objeto asociado que se encuentra en la pestaña Associations (Asociaciones) al seleccionar un objeto personalizado en la página Custom objects settings (Configuración de objetos personalizados).
- index con la posición del registro de objeto asociado que quieres mostrar, empezando desde 0 para el primer registro.
- variable con el ID de atributo que quieres mostrar, que encontrarás en la pestaña Associations (Asociaciones) al seleccionar un objeto personalizado en la página Custom objects settings (Configuración de objetos personalizados).
Pongamos como ejemplo un objeto de presupuesto asociado a registros de vehículos que contienen un atributo de marca:
| Entrada | Descripción | Resultado |
|---|---|---|
| {{ feed.quote.associations.vehicle.0.brand }} | Marca del primer vehículo | Renault |
| {{ feed.quote.associations.vehicle.1.brand }} | Marca del segundo vehículo | Toyota |
Utilizar un bucle for para iterar sobre todos los elementos
La sintaxis del bucle for es {% for item in feed.object.associations.associatedobject %} {{ item.variable }} {% endfor %}, donde debes reemplazar cada marcador de posición de la siguiente manera:
- object con el nombre en singular de tu objeto personalizado, tal y como lo definiste al crearlo.
- associatedobject con el nombre en singular de tu objeto asociado que se encuentra en la pestaña Associations (Asociaciones) al seleccionar un objeto personalizado en la página Custom objects settings (Configuración de objetos personalizados).
- variable con el ID de atributo que quieres mostrar, que encontrarás en la pestaña Associations (Asociaciones) al seleccionar un objeto personalizado en la página Custom objects settings (Configuración de objetos personalizados).
Pongamos como ejemplo un objeto de presupuesto asociado a registros de vehículos que contienen un atributo de marca:
| Entrada | Descripción | Resultado |
|---|---|---|
|
{% for item in feed.quote.associations.vehicle %} {{ item.brand }} {% endfor %} |
Marca de todos los registros de vehículos asociados |
Renault Toyota Audi ... |
➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.
📅 Variable de fecha
| Disponible para: | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Inserta un sello temporal con la fecha y hora exactas en que se envió el mensaje, según la zona horaria de tu cuenta de Brevo. Por defecto se establece en UTC si no se ha configurado ninguna zona horaria.
La sintaxis es {{ time_now }}.
Por ejemplo:
| Entrada | Descripción | Resultado |
|---|---|---|
| Hoy es {{ time_now }} | Sello temporal completo | Hoy es 2025-03-11 15:10:20.823713502 +0100 CET |
| Hoy es {{ time_now |date:"Monday, Jan 2, 2006" }} | Fecha con formato utilizando el filtro date | Hoy es martes 11 de marzo de 2025 |
➡️ Para obtener más información sobre cómo ajustar el formato de las fechas, consulta nuestro artículo dedicado Modificar el formato de tu marcador de posición con filtros.
🔗 Variables de enlace y vista previa de email
| Disponible para: | ✖️ SMS | ✖️ WhatsApp | ✖️ Push |
Coloca estas variables dentro de una etiqueta HTML <a> para que los destinatarios puedan ver tu email en un navegador, cancelar su suscripción o gestionar sus preferencias.
Las siguientes variables de enlace y vista previa de email están disponibles:
| Entrada | Descripción | Resultado |
|---|---|---|
| <a href="{{ mirror }}">Ver en el navegador</a> | Enlace de espejo | Ver en el navegador |
| Si ya no quieres <a href="{{ unsubscribe }}">Cancelar suscripción</a> | Enlace de cancelación de suscripción | Cancelar suscripción |
| <a href="{{ update_profile }}">Actualizar tus preferencias</a> | Enlace de actualización del perfil | Actualizar tus preferencias |
| <a href="{{ doubleoptin }}">Confirmo mi suscripción</a> | Enlace de confirmación doble | Confirmo mi suscripción |
➡️ Para obtener más información, consulta nuestros artículos al respecto:
- Insertar un enlace "Ver en el navegador" en las campañas
- Insertar un enlace de cancelación de suscripción en tus campañas
- Actualizar sus datos y preferencias de contactos (formulario de actualización de perfil)
- Crear una plantilla de email personalizada de confirmación doble para un formulario de suscripción creado en Brevo
📢 Declaraciones condicionales
| Disponible para: | ✖️ SMS | ✖️ WhatsApp | ✖️ Push |
Visualización condicional (declaraciones if)
Utiliza una declaración if para mostrar u ocultar partes de un email en función de los datos de cada destinatario.
➡️ Para obtener más información, consulta nuestro artículo dedicado [Manual] Mostrar u ocultar contenido en los emails mediante declaraciones if.
Secciones repetibles (bucles for)
Utiliza un bucle for para mostrar de forma dinámica todos los elementos de una matriz, sin hacer referencia manualmente a cada índice.
➡️ Para obtener más información, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.
🪄 Filtros
| Disponible para: | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Los filtros modifican el resultado de una variable y se colocan entre llaves dobles, separados por una barra vertical |. Puedes encadenar varios filtros.
Por ejemplo:
| Entrada | Descripción | Resultado |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes|slice:'0:3' %} | Limita el número de elementos que se muestran en un bucle for |
Power Flow Yoga Evening Restorative Fundamentos del Hatha Yoga |
| {{ contact.FIRSTNAME|upper }} | Convierte el nombre del destinatario a mayúsculas (originalmente: Abby). | ABBY |
| {{ params.TOTAL|floatformat:2 }} | Muestra el total del carrito con dos decimales (originalmente: 49.995). | 49.99 |
| {{ time_now|date:"02/01/2006" }} | Aplica formato a la fecha actual como dd/MM/yyyy (originalmente: 2025-03-11 15:10:20.823713502 +0100 CET). | 11/03/2025 |
➡️ Para obtener más información, consulta nuestro artículo dedicado Modificar el formato del marcador de posición con filtros.
🤔 ¿Tiene alguna duda?
Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.
Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.