O que são as Liquid Tags (e como utilizá-las no TicketingHub?)

Já quis personalizar todos os e-mails ou bilhetes que os seus clientes recebem, sem ter de reescrever tudo de cada vez? É precisamente aí que as Liquid Tags são úteis. Este guia destina-se aos utilizadores do TicketingHub que pretendem enviar mensagens inteligentes e dinâmicas, que obtêm informações em tempo real de cada reserva.

Quer esteja a dar as boas-vindas aos clientes pelo nome, a alterar a mensagem com base no idioma ou a ajustar os detalhes consoante o dia da semana, as Liquid Tags ajudam a automatizar o processo, mantendo o toque pessoal. Não é necessário ter conhecimentos de programação.

O que é exatamente uma Liquid Tag?

As Liquid Tags são marcadores de posição — pequenos trechos de código que inserem automaticamente informações personalizadas da reserva de um cliente nos seus e-mails, bilhetes ou mensagens automatizadas.

Por exemplo, se escrever:

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

O cliente receberá:

Hello Carl, your tour is confirmed!

Importante: Todas as Liquid Tags no TicketingHub utilizam chavetas duplas {{ }} para variáveis de saída e {% %} para lógica. Utilize sempre este formato — não utilize chavetas simples { }.

Nota sobre ferramentas de IA: Se pedir ao ChatGPT, Gemini ou a outro assistente de IA para criar modelos de Liquid Tags, a sintaxe sugerida poderá não corresponder à implementação do TicketingHub. Consulte o popover do indicador Liquid Supported, quando este for apresentado, e utilize os exemplos desta página como orientação.

Tipos de Liquid Tags que pode utilizar

O TicketingHub suporta dois tipos principais de Liquid Tags:

Tags de saída

Apresentam detalhes específicos da reserva, como nomes, datas e informações do produto.

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

Tags de lógica

Permitem criar regras e apresentar conteúdos diferentes consoante determinadas condições — como o idioma da reserva, o tipo de bilhete ou o dia da semana.

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

Como verificar se uma área suporta Liquid Tags

Não existe um interruptor de ativação. A funcionalidade Liquid funciona num editor ou campo onde seja apresentado o indicador Liquid Supported. Também é suportada nas mensagens de reserva de bilhetes e vouchers, bem como nos rodapés dos bilhetes.

Passe o cursor sobre o indicador Liquid Supported para abrir o respetivo popover. Utilize-o como referência atualizada para essa área, mas não assuma que o popover apresenta todos os campos possíveis. Pré-visualize ou teste a mensagem antes de a enviar aos clientes.

Onde utilizar Liquid Tags no TicketingHub

As Liquid Tags funcionam em:

• Editores e campos assinalados com o indicador Liquid Supported
• Mensagens compatíveis de reserva de bilhetes e de vouchers
• Rodapés dos bilhetes
• Modelos compatíveis de e-mails de produtos e de contas

Nem todas as variáveis estão disponíveis em todos os locais. Os e-mails de reserva podem utilizar detalhes de uma única reserva, enquanto os recibos, as faturas, os reembolsos e os pedidos de pagamento abrangem a encomenda completa e dispõem de um conjunto diferente de detalhes. Se uma tag ficar em branco, consulte o popover do indicador e as orientações de contexto abaixo e, em seguida, teste com um exemplo real.

Adicionar Liquid a um e-mail de produto

1. Abra o produto e aceda a E-mails.
2. Localize o modelo que pretende alterar e selecione Ver e, em seguida, Editar.
3. Adicione saída ou lógica Liquid compatível à mensagem.
4. Guarde o modelo.
5. Utilize Enviar e-mail de teste, quando disponível, e verifique o resultado apresentado antes de utilizar o modelo com os clientes.

Personalizar por idioma

Se tiver clientes internacionais e locais, pode adaptar as suas mensagens com base no idioma selecionado no momento da reserva.

Atualização: A variável {{ order.language }} capta agora corretamente o idioma escolhido pelo cliente no widget de reserva. A lógica condicional por idioma funcionará de forma fiável em todas as novas reservas.

{% 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 bilhete

Quer apresentar mensagens especiais a clientes VIP ou estudantes? Utilize tags condicionais para personalizar a mensagem com base no tipo de bilhete.

{% 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 %}

Alterar o ponto de encontro consoante o dia da semana

Se o local de encontro mudar em determinados dias, pode configurar uma regra para apresentar automaticamente as informações corretas.

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

Condições avançadas por idioma

Muitos operadores organizam visitas para públicos internacionais. Estes exemplos mantêm a saída como um marcador de posição em inglês, para que possa substituí-la pela sua tradução revista.

Mensagem da direita para a esquerda:

{% 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 %}

Mensagem específica por 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 %}

Sugestão profissional: Pode combinar condições relativas ao tipo de bilhete, ao idioma e ao dia numa única mensagem. Consulte o indicador Liquid Supported quando este for apresentado e pré-visualize sempre o resultado.

Verificar o suporte antes de publicar

Não assuma que a funcionalidade Liquid funciona em todos os campos de texto. Se não existir um indicador Liquid Supported e o campo não for uma mensagem compatível de reserva de bilhete ou voucher, nem um rodapé de bilhete, teste-o antes de depender de conteúdo dinâmico.

As tags não compatíveis podem aparecer em branco ou permanecer tal como foram introduzidas. Envie um e-mail de teste ou crie um bilhete ou voucher de teste antes de publicar alterações destinadas aos clientes.

Por que utilizar Liquid Tags?

Porque ajudam a:

• Personalizar automaticamente as mensagens para os clientes com dados reais das reservas
• Enviar e-mails no idioma dos seus clientes sem manter modelos separados
• Evitar edições manuais e reduzir o risco de erro humano
• Apresentar informações precisas e dinâmicas para cada reserva — pontos de encontro, horários de recolha, detalhes do guia e muito mais

Liquid Tags comuns

As tags utilizadas com mais frequência estão agrupadas por categoria abaixo. A disponibilidade depende do local onde as utiliza e esta referência poderá não incluir todos os campos possíveis. Utilize o popover do indicador Liquid Supported, quando este for apresentado, e consulte Que tags são suportadas por cada e-mail abaixo para obter informações sobre o contexto dos e-mails.

Encomenda e 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 }}

Voucher

{{ 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.

Produto

{{ 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 }}

Época, variante e opção

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

Cliente

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

Participante

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

Recolha

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

Fornecedor

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

Guia

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

Canal e revendedor

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

Pagamento e reembolso

{{ amount }}
{{ payment_link }}

Mercadoria

{{ merchandise.name }}

Outros

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

Que tags são suportadas por cada e-mail

Nem todas as tags funcionam em todos os e-mails. Uma tag que não seja suportada num determinado e-mail poderá ser apresentada em branco, por isso teste os modelos antes de os utilizar. Quando apresentado, o popover do indicador Liquid Supported é a referência atualizada para esse modelo, embora possa não listar todos os campos possíveis.

Importante — detalhes da reserva vs. detalhes da encomenda: Tags como {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} e {{ guide.* }} descrevem uma única reserva e funcionam apenas em e-mails de reserva. Os e-mails de recibo, fatura, reembolso e pedido de pagamento abrangem a encomenda completa, que pode conter várias reservas, pelo que essas tags não estão disponíveis nesses e-mails — utilize {{ customer.first_name }} na saudação.

E-mails de reserva

Confirmação de reserva de bilhete, Confirmação de reserva de voucher, Lembrete de reserva, Reserva alterada, Reserva cancelada, Feedback sobre a reserva, Recuperação de reserva abandonada.

Suportadas: encomenda e reserva, voucher, produto, época/variante/opção, cliente, participante, recolha, fornecedor, guia, canal e revendedor, outros.

E-mails de recibo e fatura

Recibo (enviado quando a encomenda está totalmente paga) e fatura/fatura proforma (enviada quando existe um depósito ou saldo por liquidar).

Suportadas: cliente, fornecedor, encomenda.

Nestes e-mails, a encomenda é o assunto da mensagem, por isso escreva os campos da encomenda sem o prefixo order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-mails de reembolso

Enviados quando é emitido um reembolso.

Suportadas: cliente, fornecedor, encomenda, {{ amount }}.

E-mails de pedido de pagamento

Enviados quando solicita a um cliente o pagamento de um saldo pendente.

Suportadas: encomenda, {{ amount }}, {{ payment_link }}.

Nestes e-mails, o cliente e o fornecedor estão aninhados na encomenda — utilize {{ order.customer.first_name }} e {{ order.supplier.name }}.

E-mails de cartões-presente

Enviados quando um cliente compra um cartão-presente.

Suportadas: cliente, fornecedor, {{ reference }}, {{ merchandise.name }}.

Erros comuns a evitar

1. Utilizar chavetas simples em vez de chavetas duplas

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

2. Confundir product e tour nos nomes das variáveis

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

O TicketingHub utiliza product — este é o erro de sintaxe mais comum que encontramos.

3. Confiar na sintaxe de tags gerada por IA

O ChatGPT e o Gemini poderão sugerir formatos de Liquid Tags que não correspondem à implementação do TicketingHub. Consulte o indicador Liquid Supported, quando este for apresentado, e compare a sugestão com os exemplos desta página.

4. Utilizar Liquid Tags sem verificar o suporte

Procure o indicador Liquid Supported ou utilize uma mensagem compatível de reserva de bilhete ou voucher, ou um rodapé de bilhete. Pré-visualize o resultado antes de publicar.

5. Variável indisponível nesse tipo de e-mail

Algumas variáveis só estão disponíveis em tipos específicos de e-mail. Se uma tag não for apresentada, consulte Que tags são suportadas por cada e-mail acima — a variável poderá não ser suportada nesse e-mail.

Liquid Tags de forma simples

As Liquid Tags podem parecer técnicas, mas, assim que se familiarizar com elas, tornar-se-ão uma ferramenta extremamente útil. São perfeitas para operadores ocupados que pretendem automatizar a comunicação sem perder o toque pessoal.

E, se alguma vez tiver dúvidas sobre como estruturar uma tag, estamos aqui para ajudar — basta entrar em contacto connosco!