MailingCore
DocumentacionVariables en plantillas

Variables en plantillas

Sintaxis {{var}}, unsubscribeUrl y variables declaradas.

Usa marcadores en HTML y asunto. Al enviar, MailingCore los sustituye por valores de tu payload o URLs generadas por el sistema.

Sintaxis

Doble llave, sensible a mayusculas:

<p>Hola {{firstName}},</p>
<p>Tu pedido {{orderId}} se envia el {{shipDate}}.</p>

Declara variables en la version (array variables) para el editor y validacion:

{
  "name": "firstName",
  "type": "string",
  "fallback": "amigo"
}

Tipos admitidos: string, number, boolean, url, email, image, color.

Variable de sistema: {{unsubscribeUrl}}

En emails de newsletter y campanas, incluye enlace de baja con un clic:

<a href="{{unsubscribeUrl}}">Darse de baja</a>

MailingCore genera una URL firmada por destinatario (/u/:token). La pagina hospedada admite ?lang= para textos localizados (unsubscribeLang en envio o campana).

Pasar valores al enviar

En envios transaccionales con templateVersionId, pasa variables en metadata o campos soportados por tu integracion. En campanas, mapea campos del contacto (p. ej. firstName desde atributos) en la configuracion de la campana.

Patrones habituales:

PatronEjemplo
Saludo{{firstName}} con fallback "amigo"
Enlace profundo{{ctaUrl}} tipo url
Pie de baja{{unsubscribeUrl}} en toda plantilla de marketing
Color de marca{{brandColor}} tipo color

Buenas practicas

  1. Declara todas las variables custom con fallback razonables.
  2. Incluye siempre {{unsubscribeUrl}} en plantillas de marketing (requisito legal en muchas jurisdicciones).
  3. Evita JavaScript o logica en plantillas — calcula valores en tu app antes del envio.
  4. Nombres alfanumericos (firstName, order_id).

Relacionado