¿Qué son las etiquetas Liquid (y cómo puede utilizarlas en TicketingHub?)

¿Alguna vez ha querido personalizar cada correo electrónico o ticket que reciben sus clientes sin tener que reescribirlo todo cada vez? Ahí es precisamente donde destacan las etiquetas Liquid. Esta guía está dirigida a los usuarios de TicketingHub que desean enviar mensajes inteligentes y dinámicos que extraigan información en tiempo real de cada reserva.

Tanto si quiere dar la bienvenida a sus clientes por su nombre como cambiar el mensaje según el idioma o ajustar los detalles en función del día de la semana, las etiquetas Liquid le ayudan a automatizar el proceso sin perder el toque personal. No se requieren conocimientos de programación.

¿Qué es exactamente una etiqueta Liquid?

Las etiquetas Liquid son marcadores de posición: pequeños fragmentos de código que insertan automáticamente información personalizada de la reserva de un cliente en sus correos electrónicos, tickets o mensajes automatizados.

Por ejemplo, si escribe:

Hello {{ customer.first_name }}, your tour is confirmed!

Su cliente recibirá:

Hello Carl, your tour is confirmed!

Importante: Todas las etiquetas Liquid de TicketingHub utilizan dobles llaves {{ }} para las variables de salida y {% %} para la lógica. Utilice siempre este formato; no utilice llaves simples { }.

Nota sobre las herramientas de IA: Si pide a ChatGPT, Gemini u otro asistente de IA que escriba plantillas de etiquetas Liquid, la sintaxis que sugiera podría no coincidir con la implementación de TicketingHub. Compruebe el cuadro emergente de la insignia Liquid Supported cuando aparezca y utilice como referencia los ejemplos de esta página.

Tipos de etiquetas Liquid que puede utilizar

TicketingHub admite dos tipos principales de etiquetas Liquid:

Etiquetas de salida

Muestran detalles específicos de la reserva, como nombres, fechas e información del producto.

Hello {{ customer.first_name }}, your tour on {{ booked_for_date }} is confirmed.

Etiquetas de lógica

Permiten crear reglas y mostrar contenido diferente en función de determinadas condiciones, como el idioma de la reserva, el tipo de ticket o el día de la semana.

{% if order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

Cómo comprobar si un área admite etiquetas Liquid

No existe ningún interruptor de activación. Liquid funciona en un editor o campo donde aparece la insignia Liquid Supported. También se admite en los mensajes de reserva de tickets y vales, así como en los pies de página de los tickets.

Pase el cursor sobre la insignia Liquid Supported para abrir su cuadro emergente. Utilícelo como referencia actualizada para esa área, pero no dé por sentado que el cuadro emergente incluye todos los campos posibles. Previsualice o pruebe el mensaje antes de enviarlo a sus clientes.

Dónde utilizar etiquetas Liquid en TicketingHub

Las etiquetas Liquid funcionan en:

• Editores y campos marcados con la insignia Liquid Supported
• Mensajes compatibles de reserva de tickets y vales
• Pies de página de los tickets
• Plantillas compatibles de correos electrónicos de productos y cuentas

No todas las variables están disponibles en todas las ubicaciones. Los correos electrónicos de reserva pueden utilizar detalles de una sola reserva, mientras que los recibos, las facturas, los reembolsos y las solicitudes de pago abarcan el pedido completo y tienen un conjunto de detalles diferente. Si una etiqueta aparece en blanco, compruebe el cuadro emergente de la insignia y las indicaciones sobre el contexto que aparecen a continuación; después, pruébela con un ejemplo real.

Añadir Liquid a un correo electrónico de producto

1. Abra el producto y vaya a Emails.
2. Busque la plantilla que desea modificar y seleccione View y, después, Edit.
3. Añada al mensaje lógica o elementos de salida Liquid compatibles.
4. Guarde la plantilla.
5. Cuando esté disponible, utilice Send Test Email y compruebe el resultado renderizado antes de utilizar la plantilla con sus clientes.

Personalizar por idioma

Si tiene clientes internacionales y locales, puede adaptar sus mensajes en función del idioma seleccionado durante la reserva.

Actualización: La variable {{ order.language }} ahora captura correctamente el idioma que el cliente eligió en el widget de reserva. La lógica condicional del idioma funcionará de forma fiable en todas las reservas nuevas.

{% if order.language == "es" %}
  Add your Spanish-language message here.
{% elsif order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

Personalizar por tipo de ticket

¿Quiere enviar mensajes especiales a clientes VIP o estudiantes? Utilice etiquetas condicionales para personalizar el contenido según el tipo de ticket.

{% if tier_names contains "VIP" %}
  Welcome VIP! Enjoy your complimentary welcome drink.
{% elsif tier_names contains "Student" %}
  Don't forget to bring your student ID.
{% else %}
  Thanks for booking! Please arrive on time and enjoy the tour.
{% endif %}

Cambiar el punto de encuentro según el día de la semana

Si el lugar de encuentro cambia determinados días, puede configurar una regla para mostrar automáticamente la información correcta.

{% assign weekday = booked_for_date | date: '%a' %}
{% if weekday == 'Mon' %}
  Please meet at our annex building.
{% else %}
  Please meet at our main office.
{% endif %}

Condiciones de idioma avanzadas

Muchos operadores organizan tours para públicos internacionales. Estos ejemplos mantienen el resultado como un marcador de posición en inglés para que pueda sustituirlo por su traducción revisada.

Mensaje de derecha a izquierda:

{% if order.language == "he" %}
<p style="direction: rtl; text-align: right;">
  Add your reviewed right-to-left message for {{ customer.first_name }} here.<br>
  <strong>Product:</strong> {{ product.name }}
</p>
{% else %}
  Hello {{ customer.first_name }}! Thank you for your booking.
{% endif %}

Mensaje específico del idioma:

{% if order.language == "ja" %}
  Add your Japanese-language message for {{ customer.first_name }} here.
  Product: {{ product.name }}
{% else %}
  Hello {{ customer.first_name }}, thank you for your booking.
  Tour: {{ product.name }}
{% endif %}

Consejo profesional: Puede combinar condiciones para el tipo de ticket, el idioma y el día en un solo mensaje. Compruebe la insignia Liquid Supported cuando aparezca y previsualice siempre el resultado.

Compruebe la compatibilidad antes de publicar

No dé por sentado que Liquid funciona en todos los campos de texto. Si no aparece la insignia Liquid Supported y el campo no es un mensaje compatible de reserva de tickets o vales ni un pie de página de ticket, pruébelo antes de confiar en el contenido dinámico.

Las etiquetas no compatibles pueden aparecer en blanco o permanecer tal como se han escrito. Envíe un correo electrónico de prueba o cree un ticket o vale de prueba antes de publicar cambios dirigidos a los clientes.

¿Por qué utilizar etiquetas Liquid?

Porque le ayudan a:

• Personalizar automáticamente los mensajes de los clientes con datos reales de la reserva
• Enviar correos electrónicos en el idioma de sus clientes sin mantener plantillas independientes
• Evitar ediciones manuales y reducir los errores humanos
• Mostrar información precisa y dinámica para cada reserva: puntos de encuentro, horas de recogida, datos del guía y mucho más

Etiquetas Liquid habituales

Las siguientes etiquetas de uso frecuente están agrupadas por categoría. La disponibilidad depende de dónde las utilice, y esta referencia podría no incluir todos los campos posibles. Utilice el cuadro emergente de la insignia Liquid Supported cuando aparezca y consulte Qué etiquetas admite cada correo electrónico más abajo para conocer el contexto de los correos electrónicos.

Pedido y reserva

{{ reference }}
{{ order.reference }}
{{ order.language }}         — Language selected by the customer in the booking widget.
{{ order.referral_code }}
{{ order.checkout_url }}
{{ booked_for_date }}
{{ size }}                   — Number of people in the booking.
{{ group_booking }}
{{ questions_with_answers }}
{{ extra_names }}

Vale

{{ voucher }}                — Note: returns true or false indicating whether this is a voucher
                               booking. It does not contain a voucher or reference code — use
                               {{ reference }} for the booking reference.

Producto

{{ product.name }}
{{ product.address.name }}
{{ product.address.building }}
{{ product.address.street }}
{{ product.address.city }}
{{ product.address.region }}
{{ product.address.postal_code }}
{{ product.address.country }}
{{ product.address.google_maps_url }}
{{ product.formatted_address }}

Temporada, variante y opción

{{ season.name }}
{{ variant.name }}
{{ tier_names }}
{{ option.name }}
{{ option.time }}

Cliente

{{ customer.first_name }}
{{ customer.last_name }}
{{ customer.full_name }}
{{ customer.company }}
{{ customer.email }}

Asistente

{{ attendee.first_name }}
{{ attendee.last_name }}
{{ attendee.full_name }}
{{ attendee.company }}
{{ attendee.email }}

Recogida

{{ pickup.location }}
{{ pickup.time }}
{{ pickup.note }}
{{ pickup.map }}

Proveedor

{{ supplier.name }}
{{ supplier.logo }}
{{ supplier.logo_url }}
{{ supplier.website }}
{{ supplier.telephone }}
{{ supplier.email }}

Guía

{{ guide.name }}
{{ guide.first_name }}
{{ guide.last_name }}
{{ guide.telephone }}

Canal y revendedor

{{ channel.name }}
{{ reseller.name }}

Pago y reembolso

{{ amount }}
{{ payment_link }}

Mercancía

{{ merchandise.name }}

Otros

{{ notes }}
{{ manage_booking_url }}
{{ smartwaiver_url }}
{{ tickets_download_url }}     — Link for the customer to download their tickets.

Qué etiquetas admite cada correo electrónico

No todas las etiquetas funcionan en todos los correos electrónicos. Una etiqueta que no sea compatible con un correo determinado puede aparecer en blanco, por lo que debe probar las plantillas antes de utilizarlas. El cuadro emergente de la insignia Liquid Supported es la referencia actualizada de esa plantilla cuando aparece, aunque puede no incluir todos los campos posibles.

Importante: detalles de la reserva frente a detalles del pedido: Etiquetas como {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} y {{ guide.* }} describen una sola reserva y solo funcionan en correos electrónicos de reserva. Los correos de recibo, factura, reembolso y solicitud de pago abarcan el pedido completo, que puede contener varias reservas, por lo que esas etiquetas no están disponibles en ellos. Utilice {{ customer.first_name }} para el saludo.

Correos electrónicos de reserva

Confirmación de reserva de ticket, confirmación de reserva de vale, recordatorio de reserva, reserva modificada, reserva cancelada, comentarios sobre la reserva y recuperación de reservas abandonadas.

Compatibles: Pedido y reserva, Vale, Producto, Temporada/Variante/Opción, Cliente, Asistente, Recogida, Proveedor, Guía, Canal y revendedor, Otros.

Correos electrónicos de recibos y facturas

Recibo, enviado cuando el pedido se ha pagado por completo, y factura o factura proforma, enviadas cuando queda pendiente un depósito o saldo.

Compatibles: Cliente, Proveedor, Pedido.

En estos correos el pedido es el objeto del mensaje, por lo que debe escribir los campos del pedido sin el prefijo order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Correos electrónicos de reembolso

Se envían cuando se emite un reembolso.

Compatibles: Cliente, Proveedor, Pedido, {{ amount }}.

Correos electrónicos de solicitud de pago

Se envían cuando solicita al cliente que pague un saldo pendiente.

Compatibles: Pedido, {{ amount }}, {{ payment_link }}.

En estos correos, el cliente y el proveedor están anidados dentro del pedido. Utilice {{ order.customer.first_name }} y {{ order.supplier.name }}.

Correos electrónicos de tarjetas regalo

Se envían cuando un cliente compra una tarjeta regalo.

Compatibles: Cliente, Proveedor, {{ reference }}, {{ merchandise.name }}.

Errores habituales que debe evitar

1. Utilizar llaves simples en lugar de llaves dobles

Wrong:   { customer.first_name }
Correct: {{ customer.first_name }}

2. Confundir product y tour en los nombres de las variables

Wrong:   {{ tour.name }}
Correct: {{ product.name }}

TicketingHub utiliza product; este es el error de sintaxis más habitual que vemos.

3. Confiar en la sintaxis de etiquetas generada por la IA

ChatGPT y Gemini pueden sugerir formatos de etiquetas Liquid que no coincidan con la implementación de TicketingHub. Compruebe la insignia Liquid Supported cuando aparezca y compare la sugerencia con los ejemplos de esta página.

4. Utilizar etiquetas Liquid sin comprobar la compatibilidad

Busque la insignia Liquid Supported o utilice un mensaje compatible de reserva de tickets o vales o un pie de página de ticket. Previsualice el resultado antes de publicarlo.

5. Variable no disponible en ese tipo de correo electrónico

Algunas variables solo están disponibles en determinados tipos de correo electrónico. Si una etiqueta no se muestra, consulte Qué etiquetas admite cada correo electrónico más arriba; es posible que la variable no sea compatible con ese correo.

Etiquetas Liquid de forma sencilla

Las etiquetas Liquid pueden parecer algo técnico, pero una vez que se familiarice con ellas, cambiarán por completo su forma de trabajar. Son perfectas para operadores ocupados que desean automatizar las comunicaciones sin perder el toque personal.

Y si alguna vez no está seguro de cómo estructurar una etiqueta, estamos aquí para ayudarle: solo tiene que ponerse en contacto con nosotros.