Para qué sirve#
Las variables personalizan cada correo con los datos del contacto que lo recibe (su nombre, su correo, un campo propio…). Las condiciones («Mostrar solo si…») hacen que una fila o un bloque aparezca solo para los contactos que cumplen ciertas reglas. Ambas se evalúan al enviar a cada persona.
Quién puede usarlo y cómo llegar#
Se usan dentro del Editor de templates (Menú Difusiones y formularios → Plantillas de correo), con el mismo permiso que el editor.
Variables#
Una variable se escribe entre dobles llaves, por ejemplo {{nombre}}. No hace falta escribirla a mano: en el editor se inserta desde un menú y se muestra como una etiqueta verde legible (por ejemplo «Nombre»). En el correo guardado queda el texto con llaves.
Cómo insertar una variable#
- En un Texto o Título: pulsa { } Variable en la barra de formato del panel derecho y elige una opción.
- En el Asunto y en los campos Texto y Enlace del bloque Botón: pulsa el botón { } que está junto al campo.
Variables disponibles#
| Opción del menú | Variable | Qué muestra |
|---|---|---|
| Nombre | {{nombre}} | El primer nombre del contacto (la primera palabra de su nombre). |
| Apellidos | {{apellidos}} | Los apellidos. |
| Nombre completo | {{nombre_completo}} | Nombre y apellidos. |
| Correo | {{correo}} | El correo del contacto. |
| Teléfono | {{telefono}} | El teléfono. |
| Tipo de contacto | {{tipo_contacto}} | El tipo de contacto (por ejemplo, Cliente). |
| Fecha de hoy | {{fecha}} | La fecha del envío en formato dd/mm/aaaa. |
| Enlace para darse de baja | {{url_baja}} | El enlace para que el contacto se dé de baja. |
| Campo: nombre del campo | {{campo:clave}} | El valor de un campo personalizado del contacto. Aparece una opción por cada campo personalizado activo. |
| Enlace al formulario: nombre | {{formulario:slug}} | Un enlace personal al formulario público (uno por cada formulario publicado). |
Variables de pedidos, oportunidades y compras#
También puedes insertar datos del negocio del contacto. Aparecen en el mismo menú, con el nombre del grupo delante (por ejemplo «Pedido: número»).
| Grupo | De dónde salen los datos | Variables |
|---|---|---|
| Pedido | El último pedido del contacto que no esté cancelado ni en borrador | {{pedido:numero}}, estado, estado_pago, estado_entrega, productos, referencias (las referencias de los precios de los productos del pedido, separadas por coma, p. ej. 8,13,29; si una línea llegó solo con nombre desde la tienda web, la referencia se busca en el catálogo por su nombre «Producto — descripción del precio»; los adicionales no cuentan), tabla, total, pagado, saldo, fecha, fuente, guia y las del último pago: pago_monto, pago_metodo, pago_fecha, pago_referencia |
| Oportunidad | Su oportunidad abierta más reciente (si no tiene, la última) | {{oportunidad:titulo}}, etapa, embudo, estado, valor, producto, cierre |
| Compra | Su última compra y el resumen de sus compras (sección «Compras» de la ficha) | {{compra:producto}}, productos, fecha, valor, cantidad, estado, total (número de compras) |
Medio de pago y datos de la cuenta: {{pedido:complemento_correo}} incrusta el bloque HTML que el sistema que crea el pedido envió por la API en el campo complemento_correo (por ejemplo, el banco, el tipo y número de cuenta y el titular, o la llave Bre-B). Si el pedido no trae ese bloque, la variable queda vacía.
Tabla de productos: {{pedido:tabla}} inserta una tabla con cada producto del pedido (cantidad, precio, descuento y total; los adicionales van indentados) y al pie el subtotal, los descuentos, el envío, el IVA y el total. Se escribe sola en una línea del texto del correo; no admite valor de respaldo.
Los montos salen con su moneda (por ejemplo «$ 238.000»). Si el contacto no tiene pedido, oportunidad o compra, la variable queda vacía: usa un valor de respaldo (por ejemplo {{pedido:numero|tu pedido}}). En la vista previa del editor se muestran datos de ejemplo.
Si escribes una variable que no existe, se deja tal cual en el correo.
Valor de respaldo#
Si el contacto no tiene el dato, puedes indicar un texto alternativo. Haz clic sobre la variable ya insertada y escribe el texto en «Si el contacto no tiene el dato, escribir» (por ejemplo «Estimado cliente»), luego Aceptar. Queda como {{nombre|Estimado cliente}}. Con Quitar variable la eliminas. Los caracteres {, } y | no se admiten en el respaldo.
Hola {{nombre|amigo}}: así ningún correo sale con un espacio vacío si al contacto le falta el nombre.En la Vista previa puedes elegir «Sin datos (valores de respaldo)» para ver cómo queda el correo cuando faltan datos, o un contacto de ejemplo para ver sus datos reales.
Condiciones: «Mostrar solo si…»#
Cada fila y cada bloque tiene en su panel de propiedades el interruptor Mostrar solo si….
- Selecciona la fila o el bloque.
- En el panel derecho, activa Mostrar solo si…. Se crea una primera regla.
- Elige si deben cumplirse todas las reglas o alguna («Se cumplen todas las reglas» / «Se cumple alguna regla»).
- Configura cada regla y usa Agregar regla para sumar más. La × quita una regla.
El elemento con condición se marca en el lienzo con la etiqueta naranja Condicional. Si activas el interruptor pero no dejas ninguna regla, el contenido se muestra a todos («Agrega al menos una regla; mientras no haya, se muestra a todos.»).
Reglas disponibles#
| Se evalúa | Operadores | Valor |
|---|---|---|
| Tipo de contacto | es, no es | Un tipo de contacto de la lista |
| Metadato | tiene, no tiene | Un metadato de la lista |
| Nombre, Apellidos, Correo, Teléfono | es, no es, contiene, está vacío, tiene valor | Un texto (no se pide con «está vacío» ni «tiene valor») |
| Campo: … (cada campo personalizado activo) | es, no es, contiene, está vacío, tiene valor | Un texto |
- Las comparaciones de texto no distinguen mayúsculas de minúsculas.
- «contiene» busca el texto dentro del dato; sin texto, la regla no se cumple.
- Una regla nueva empieza como «Tipo de contacto es …» con el primer tipo de la lista; si no hay tipos, como «Correo tiene valor».
Ejemplo#
Para mostrar un párrafo solo a clientes: selecciona el bloque de texto, activa Mostrar solo si… y deja la regla «Tipo de contacto → es → Cliente».
Reglas y comportamientos#
- Las condiciones se evalúan en el servidor al enviar a cada persona; el contacto nunca ve el contenido que no le corresponde.
- Las condiciones pueden anidarse (una fila condicional con un bloque condicional adentro).
- En Enviar prueba, las condiciones se evalúan como un contacto sin tipo ni metadatos; usa la Vista previa con un contacto de ejemplo para ver las demás combinaciones.
- La Vista previa muestra hasta 8 contactos de ejemplo: los más recientes que están activos y tienen correo.
<!-- Fuente: tenant-app/public/templates/editor.js, tenant-app/public/templates/render.js, tenant-app/public/api/correo_editor.php, shared/src/Core/DifusionCorreo.php -->