¿Cómo uso condiciones para mostrar u ocultar contenido?

SecureMailMerge usa plantillas Liquid, así que puedes envolver bloques de tu asunto o cuerpo en etiquetas {% if %} … {% endif %} para mostrarlos u ocultarlos según los valores de las columnas del destinatario. Combina condiciones con operadores de comparación, ramas else/elsif y la palabra clave contains para tener control total.

SecureMailMerge personaliza tus correos electrónicos con plantillas Liquid. Además de tokens simples como {{FirstName}}, puedes usar condiciones para mostrar, ocultar o cambiar bloques de contenido según los datos de cada destinatario.

Las condiciones funcionan tanto en la línea de asunto como en el cuerpo del correo.

Básico if / endif

Envuelve el contenido que quieres hacer opcional entre una etiqueta de apertura {% if %} y una etiqueta de cierre {% endif %}. La condición se verifica contra el valor en la columna nombrada para cada destinatario.

{% if Country == "Germany" %}
  Versand erfolgt aus unserem Lager in Berlin.
{% endif %}

El bloque solo se incluye para los destinatarios cuya columna Country es igual a Germany. Todos los demás no ven nada en su lugar.

Los valores de texto deben ir entre comillas ("Germany" o 'Germany'). Los números se escriben sin comillas.

Añadiendo una rama else

Usa {% else %} para proporcionar contenido alternativo cuando la condición es falsa.

{% if Plan == "Premium" %}
  Gracias por ser un cliente Premium — tu línea de soporte prioritario es +1 555 0100.
{% else %}
  ¿Necesitas ayuda? Responde a este correo y te ayudaremos.
{% endif %}

Varias ramas con elsif

Encadena varias condiciones con {% elsif %}. La primera rama que coincida gana.

{% if Tier == "Gold" %}
  Has desbloqueado nuestros beneficios Gold.
{% elsif Tier == "Silver" %}
  Estás en el plan Silver.
{% else %}
  ¡Bienvenido a bordo!
{% endif %}

Operadores de comparación

Puedes comparar los valores de las columnas con cualquiera de estos operadores:

{% if OrderTotal >= 100 %}
  ¡Calificas para envío gratis!
{% endif %}

Combinar condiciones con and / or

Usa and y or para probar más de una columna a la vez.

{% if Country == "USA" and Plan == "Premium" %}
  Tus beneficios Premium en EE. UU. están activos.
{% endif %}

Comprobar si una celda tiene un valor

En Liquid, una celda vacía sigue siendo “verdadera”, así que {% if Notes %} no es una forma confiable de comprobar si hay un valor. Usa blank en su lugar — coincide con celdas vacías y celdas que solo contienen espacios:

{% if Notes != blank %}
  Una nota de tu gestor de cuenta: {{Notes}}
{% endif %}

Para hacer lo contrario — mostrar contenido solo cuando una celda está vacía — invierte la comparación:

{% if PhoneNumber == blank %}
  No tenemos un número de teléfono registrado. Responde para agregar uno.
{% endif %}

Nombres de columnas con espacios

Si el encabezado de tu columna contiene espacios (u otros caracteres especiales), refiérelo con la notación de corchetes, de la misma manera que lo harías con un token normal:

{% if ["Account Status"] == "Active" %}
  Tu cuenta está en buen estado.
{% endif %}

Coincidencia de parte de un valor con contains

contains verifica si un valor de texto incluye una subcadena.

{% if Email contains "@gmail.com" %}
  Consejo: agréganos a tus contactos de Gmail para que no terminemos en Promociones.
{% endif %}

Invertir una condición con unless

{% unless %} es lo opuesto a {% if %} — el bloque se muestra solo cuando la condición es falsa.

{% unless Country == "USA" %}
  Se aplican tarifas de envío internacional.
{% endunless %}

Elegir uno entre varios valores con case / when

Cuando necesitas cambiar entre varios valores fijos, {% case %} es más limpio que una larga cadena de elsif.

{% case Language %}
  {% when "de" %}
    Vielen Dank für Ihre Bestellung!
  {% when "fr" %}
    Merci pour votre commande !
  {% else %}
    Thank you for your order!
{% endcase %}

Consejos

• Las condiciones pueden envolver cualquier contenido: texto, enlaces, imágenes o incluso otros tokens.
• Los espacios en blanco y los saltos de línea dentro de los bloques {% if %} se mantienen, así que coloca tus etiquetas con cuidado para evitar líneas en blanco en el correo final.
• Puedes combinar condiciones con el filtro de valor predeterminado para texto de respaldo, y con el de formato de fecha para fechas.
• Siempre cierra cada etiqueta: {% if %} necesita {% endif %}, {% unless %} necesita {% endunless %}, y {% case %} necesita {% endcase %}. La falta de una etiqueta de cierre causa un error de sintaxis liquid.