Chuleta de etiquetas de combinación

Las plantillas son HTML puro. Todo lo dinámico pasa por una etiqueta de combinación escrita {{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, bajo custom.: consulta Campos personalizados más abajo. Cualquier otra cosa se señala como desconocida.
EtiquetaSe resuelve comoEjemplo de resultado
{{firstName}}Nombre del contactoCamille
{{lastName}}Apellido del contactoDubois
{{email}}Dirección de email del contactocamille@exemple.fr
{{unsubscribeUrl}}Enlace de baja único para este destinatariohttps://app/u/a1b2c3
{{currentYear}}Año en el momento de la generación2026
{{today}}Fecha de hoy, en formato largo22 de agosto de 2026
{{postalAddress}}Dirección postal de tu organización12 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 pasoTres 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és22 août 2026
InglésAugust 22, 2026
Español22 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_shortcode para 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.
El bloque oculto también mantiene el texto de vista previa fuera de la versión en texto plano del email, para que nunca se lea dos veces.
Se permiten espacios dentro de las llaves: {{ 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 &quot;: {{custom.ciudad | &quot;Madrid&quot;}} funciona igual.
  • El texto alternativo solo existe para los campos personalizados: {{firstName | "amigo"}} no es una etiqueta de combinación.
Cada tipo de campo se muestra como texto:
TipoSe muestra comoEjemplo de resultado
TextoEl valor tal como se escribióOro
NúmeroEl número, sin formato1234.5
FechaFecha larga, en el idioma del contacto1 de marzo de 2026
Booleanosí / no, en el idioma del contactosí
El idioma es el del contacto, cuando es francés, inglés o español; si no, el idioma de los emails de tu organización, definido en Configuración → Envío. Una fecha es el día del calendario guardado: nunca se desplaza con una zona horaria. Los valores se escapan en el cuerpo HTML. Un valor como <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 MailchimpSe 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 MailchimpPor 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>}}.
Si pegas una plantilla que usa una de estas, corrígela en el editor: sustituye la etiqueta por texto estático, o quítala.

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>
Generado para un contacto llamado Camille:
html
<td>Salut Camille, voici les nouvelles du mois.</td>
<!-- … -->
<a href="https://agentsmail.io/unsubscribe/a1b2c3">Se désinscrire</a>