Plantillas Liquid
Joryio usa Liquid para personalizar mensajes: inserta datos de usuarios, aplica filtros, crea ramificaciones según condiciones e incorpora registros de entidades y productos.
Hola {{ user.firstName | default: "" }}, el total de tu carrito es {{ cart.total | currency }}.
Qué puedes usar
- Variables:
{{ user.firstName }},{{ user.email }}, atributos personalizados mediante{{ user.custom.plan }}y, en recorridos, datos del evento o desencadenante como{{ event.name }}o la última respuesta del contacto con{{ reply.text }}. Funciona tanto con respuestas de WhatsApp como de SMS. - Filtros: transforman valores, por ejemplo:
{{ user.firstName | upcase }},{{ price | currency }}y{{ "now" | date: "%Y" }}. - Condicionales y bucles:
{% if %}/{% for %}para crear ramificaciones e iterar. - Valores de reserva: protege siempre con
default:{{ user.firstName | default: "hola" }}. - Fuentes de catálogo: incorpora registros de entidades o productos en un mensaje. Consulta Entidades personalizadas.
- Bloques de contenido: inserta un fragmento reutilizable con
{{ blocks.slug }}. Consulta Bloques de contenido. - Enlaces de suscripción: añade un enlace funcional de baja o preferencias con
{{ unsubscribe_url }},{{ preferences_url }}o{{ resubscribe_url }}. Consulta más abajo.
Enlaces de suscripción
Añade al cuerpo de un mensaje un enlace de baja o al centro de preferencias específico para cada destinatario:
{{ unsubscribe_url }}: baja con un clic; excluye al contacto.{{ preferences_url }}: enlace al centro de preferencias alojado, donde el contacto gestiona las categorías que recibe.{{ resubscribe_url }}: centro de preferencias configurado de antemano para volver a suscribirse.
Estos enlaces se resuelven en email, SMS y WhatsApp (respuestas libres o de sesión). Cada uno es único por destinatario y caduca después de 90 días. No se renderizan en mensajes Push ni in-app.
Notas por canal:
- SMS: un enlace funciona, pero el estándar legal y de los operadores para darse de baja por SMS
es la palabra clave STOP (responder STOP / BAJA / etc.), que siempre funciona incluyas o no un enlace.
Un enlace consume caracteres, por lo que muchos remitentes usan STOP y emplean
{{ preferences_url }}solo cuando quieren ofrecer una página de preferencias gestionada. - WhatsApp: los enlaces se resuelven en respuestas libres de sesión. Los mensajes de plantilla usan marcadores fijos aprobados previamente por Meta y no pueden incluir un enlace dinámico. Para las plantillas, usa la baja mediante STOP o un botón URL estático de «gestionar preferencias» aprobado con la plantilla.
- Al hacer clic en un enlace de baja de SMS o WhatsApp, el contacto queda excluido por número de teléfono: se aplica a todos los registros de contacto que compartan ese número, igual que al enviar STOP por mensaje.
Dónde funciona
El mismo Liquid - variables, filtros, fuentes de catálogo de productos o entidades y bloques de contenido - se renderiza de forma idéntica en todos los canales: email, SMS, Push, WhatsApp e in-app, tanto en campañas como en recorridos. Escribe una plantilla una vez y se comportará igual donde la uses.
Insertarlo sin escribirlo
No tienes que memorizar la sintaxis. Cada editor incluye un botón Personalizar: debajo del cuerpo
del mensaje en los editores de SMS, Push y WhatsApp, y en la barra de herramientas en los editores de
email e in-app. Elige una variable - atributo de usuario, atributo personalizado, fuente de catálogo de
producto o entidad, bloque de contenido o enlace de suscripción - , define un valor de reserva opcional y
el fragmento {{ ... }} ya preparado se insertará por ti.