{{name}}, resuelta para cada destinatario en el momento del envío.
Una sola sintaxis. Las plantillas usan
{{name}}. La sintaxis *|TAG|* de Mailchimp se
convierte cuando guardas una plantilla pegada: nunca es una segunda sintaxis que mantener.Etiquetas de combinación admitidas
Este es el vocabulario integrado completo. Los campos de contacto de tu organización se suman a él, bajocustom.: consulta Campos personalizados más abajo. Cualquier otra cosa se señala como desconocida.
| Etiqueta | Se resuelve como | Ejemplo de resultado |
|---|---|---|
{{firstName}} | Nombre del contacto | Camille |
{{lastName}} | Apellido del contacto | Dubois |
{{email}} | Dirección de email del contacto | camille@exemple.fr |
{{unsubscribeUrl}} | Enlace de baja único para este destinatario | https://app/u/a1b2c3 |
{{currentYear}} | Año en el momento de la generación | 2026 |
{{today}} | Fecha de hoy, en formato largo | 22 de agosto de 2026 |
{{postalAddress}} | Dirección postal de tu organización | 12 rue des Lilas, 59000 Lille |
{{topicOptOutUrl}} | Enlace de rechazo del tema del envío (opcional) | https://app/t/d4e5f6 |
{{poweredBy}} | Un pequeño enlace "Sent with AgentsMail.io" | Sent with AgentsMail.io |
{{previewText}} | El texto de vista previa; alias compatible de {{preheader}} | Tres novedades este mes |
{{preheader}} | El texto de vista previa de la campaña o del paso | Tres novedades este mes |
{{today}} y {{currentYear}} se calculan en el momento de la generación, en la zona horaria y
el idioma de la organización que envía. Ambos vienen de Ajustes → Envío. El mismo instante
produce una fecha distinta para una organización en París y otra en Nueva York: esa es la idea.
Los valores que se pasen para ellos en una llamada a la API se ignoran: igual que
{{unsubscribeUrl}}, los decide AgentsMail.| Idioma | {{today}} muestra |
|---|---|
| Francés | 22 août 2026 |
| Inglés | August 22, 2026 |
| Español | 22 de agosto de 2026 |
En una secuencia automatizada,
{{today}} se resuelve cuando el paso se envía realmente, no
cuando se publicó la versión de la secuencia. Por lo demás, un paso publicado es una instantánea
congelada, así que esto es lo único que se mueve en él.{{poweredBy}} es la única etiqueta de combinación que inserta un enlace por ti. Todas las
demás se resuelven como texto: con {{unsubscribeUrl}}, tu plantilla escribe el <a> a su
alrededor. Esta llega lista: un enlace pequeño y discreto, sin subrayado, del color del texto que
lo rodea, para que quede en un pie sin competir con nada. Como ya es un enlace, no la pongas
dentro de un atributo (href="{{poweredBy}}" produce HTML roto): colócala en una línea propia.Es totalmente opcional: nada la exige, nada te impide eliminarla y nunca se añade a tu
plantilla a tus espaldas. Las plantillas de la galería la llevan en el pie; quítala y la plantilla
se sigue enviando.Sigue el idioma de email de tu organización, y no cuenta como enlace con seguimiento: nunca
aparece en las estadísticas de clics de tu campaña.{{previewText}} y {{preheader}} muestran el mismo texto de vista previa. El texto de vista previa es la línea que la bandeja de entrada muestra
justo después del asunto. Lo escribes junto al asunto (en la pantalla de la campaña, en un paso de
secuencia o mediante previewText (alias compatible: preheader) en la API de campañas) y la plantilla decide dónde vive: un bloque
oculto que lleva {{previewText}} o {{preheader}}, normalmente justo después de <body>. Todas las plantillas de la galería incluyen
uno; la plantilla inicial también.Dos consecuencias que conviene conocer:- Un texto de vista previa sin la etiqueta no va a ninguna parte. No se inserta nada en tu HTML
por ti. El envío sale igualmente, y la generación señala la advertencia
missing_preheader_shortcodepara que sepas que la línea se descartó: la bandeja de entrada recurre entonces al primer texto visible de tu email. - La etiqueta sin texto de vista previa es inofensiva. El bloque oculto simplemente queda vacío.
{{ firstName }} funciona igual que {{firstName}}.
Las etiquetas de combinación se resuelven tanto en la línea de asunto como en el cuerpo HTML.
{{unsubscribeUrl}} es obligatoria. Una plantilla cuyo HTML generado no contiene el enlace de
baja se rechaza en el momento de la generación, con un error explícito. No se añade ningún pie en
silencio a tu HTML: el enlace tiene que estar en algún lugar de tu plantilla.Campos personalizados
Cada campo personalizado que define tu organización está disponible como{{custom.<clave>}}, donde <clave> es la clave del campo (letras minúsculas, dígitos y _, empezando por una letra).
html
<p>Tu plan: {{custom.plan}}</p>
<p>Hola {{custom.apodo | "amigo"}},</p>{{custom.<clave>}}muestra el valor del contacto, o nada cuando no tiene.{{custom.<clave> | "alternativa"}}muestra el texto alternativo cuando el contacto no tiene valor. Dentro de un atributo HTML, el editor guarda las comillas como":{{custom.ciudad | "Madrid"}}funciona igual.- El texto alternativo solo existe para los campos personalizados:
{{firstName | "amigo"}}no es una etiqueta de combinación.
| Tipo | Se muestra como | Ejemplo de resultado |
|---|---|---|
| Texto | El valor tal como se escribió | Oro |
| Número | El número, sin formato | 1234.5 |
| Fecha | Fecha larga, en el idioma del contacto | 1 de marzo de 2026 |
| Booleano | sí / no, en el idioma del contacto | sí |
<b>VIP</b> se muestra como ese texto, nunca como marcado: un valor importado o enviado por la API no puede inyectar HTML en tu email. En el asunto, que es texto, el valor aparece tal como se guardó.
Una clave desconocida nunca bloquea un envío. Una clave que tu organización no ha definido muestra su texto alternativo, o nada, y se señala como custom.<clave> en el panel de vista previa y en los unknownVariables del endpoint de renderizado. A diferencia de una etiqueta integrada desconocida, nunca se deja visible en el email.
Las vistas previas y el archivo público nunca muestran el valor de un contacto real. La vista previa del editor, los envíos de prueba, el endpoint de renderizado y la página pública de una campaña enviada no tienen destinatario: cada etiqueta personalizada muestra su texto alternativo, o nada. Solo un envío real de campaña o de secuencia usa los valores del destinatario.
Una etiqueta de combinación dentro de la dirección de un enlace con seguimiento no se sustituye: el enlace se reescribe para el seguimiento de clics antes de resolver las etiquetas. Ocurre con todas las etiquetas,
{{firstName}} incluida. Mantén las etiquetas personalizadas en el texto de tu email, no en la URL de los enlaces.Etiquetas de Mailchimp convertidas al guardar
Pega una plantilla de Mailchimp y guárdala: estas se reescriben automáticamente.| Etiqueta de Mailchimp | Se convierte en |
|---|---|
*|UNSUB|* | {{unsubscribeUrl}} |
*|FNAME|* | {{firstName}} |
*|LNAME|* | {{lastName}} |
*|EMAIL|* | {{email}} |
*|CURRENT_YEAR|* | {{currentYear}} |
No admitidas
Cualquier otra*|TAG|* se deja intacta en el HTML y se señala en el editor al guardar. Nunca se envía en silencio a los destinatarios.
| Etiqueta de Mailchimp | Por qué no se admite |
|---|---|
*|DATE:d F Y|* | Lleva una cadena de formato. Las etiquetas de combinación sustituyen, no formatean: convertirla tiraría tu formato en silencio. Usa {{today}} (fecha larga) o {{currentYear}} (solo el año); no se admite un formato arbitrario. |
*|IF:…|* etc. | Los bloques condicionales requieren un motor de plantillas, no una sustitución. |
*|ARCHIVE|* | Sin etiqueta. Las campañas enviadas tienen una página pública cuando el archivo público está activado. |
*|LIST:NAME|* | Los metadatos de la lista y de la cuenta no se exponen a las plantillas. |
*|MERGE1|*, … | No se convierte: los campos numerados de Mailchimp no corresponden a tus claves de campo. Sustituye cada uno por {{custom.<clave>}}. |
Reglas de comportamiento
Una etiqueta conocida sin valor se muestra vacía. Si un contacto no tiene nombre,Salut {{firstName}}, se muestra como Salut ,. Redacta teniéndolo en cuenta, o deja la etiqueta fuera de una frase que se rompe sin ella.
Una etiqueta desconocida se deja visible y se señala. {{fistName}} (errata) se queda en el resultado como {{fistName}} y aparece como variable desconocida en el panel de vista previa, para que la detectes antes de enviar, no después. Una clave {{custom.…}} desconocida es la excepción: muestra su texto alternativo o nada, y se sigue señalando.
La vista previa usa datos de ejemplo. El panel de vista previa genera tu plantilla con valores de ejemplo y una URL de baja provisional, así que lo que ves es lo que realmente produce un envío real.
Ejemplo
html
<td>Salut {{firstName}}, voici les nouvelles du mois.</td>
<!-- … -->
<a href="{{unsubscribeUrl}}">Se désinscrire</a>html
<td>Salut Camille, voici les nouvelles du mois.</td>
<!-- … -->
<a href="https://agentsmail.io/unsubscribe/a1b2c3">Se désinscrire</a>