Que sont les balises Liquid (et comment les utiliser dans TicketingHub) ?

Vous avez toujours voulu personnaliser chaque e-mail ou billet reçu par vos clients, sans devoir tout réécrire à chaque fois ? C’est précisément là que les balises Liquid se révèlent utiles. Ce guide s’adresse aux utilisateurs de TicketingHub qui souhaitent envoyer des messages intelligents et dynamiques, capables de récupérer les informations en temps réel de chaque réservation.

Que vous souhaitiez accueillir vos clients par leur nom, adapter vos messages en fonction de la langue ou modifier certains détails selon le jour de la semaine, les balises Liquid vous aident à automatiser le processus tout en conservant une touche personnalisée. Aucune connaissance en programmation n’est requise.

Qu’est-ce qu’une balise Liquid exactement ?

Les balises Liquid sont des espaces réservés — de petits éléments de code qui insèrent automatiquement dans vos e-mails, billets ou messages automatisés des informations personnalisées provenant de la réservation d’un client.

Par exemple, si vous écrivez :

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

Votre client recevra :

Hello Carl, your tour is confirmed!

Important : toutes les balises Liquid de TicketingHub utilisent des doubles accolades {{ }} pour les variables de sortie et {% %} pour la logique. Utilisez toujours ce format — n’utilisez pas d’accolades simples { }.

Remarque concernant les outils d’IA : si vous demandez à ChatGPT, Gemini ou à un autre assistant d’IA de rédiger des modèles de balises Liquid, la syntaxe proposée peut ne pas correspondre à l’implémentation de TicketingHub. Lorsque le badge Liquid Supported est affiché, consultez son popover et utilisez les exemples de cette page comme référence.

Types de balises Liquid disponibles

TicketingHub prend en charge deux principaux types de balises Liquid :

Balises de sortie

Elles affichent des détails précis de la réservation, tels que les noms, les dates et les informations sur le produit.

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

Balises logiques

Elles vous permettent de créer des règles et d’afficher un contenu différent selon certaines conditions, comme la langue de la réservation, le type de billet ou le jour de la semaine.

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

Comment vérifier qu’une zone prend en charge les balises Liquid

Il n’existe aucun bouton d’activation. Liquid fonctionne dans un éditeur ou un champ où le badge Liquid Supported est affiché. Cette fonctionnalité est également prise en charge dans les messages de réservation de billets et de bons, ainsi que dans les pieds de page des billets.

Survolez le badge Liquid Supported pour ouvrir son popover. Utilisez-le comme référence actualisée pour cette zone, mais ne partez pas du principe qu’il répertorie tous les champs possibles. Prévisualisez ou testez votre message avant de l’envoyer à vos clients.

Où utiliser les balises Liquid dans TicketingHub

Les balises Liquid fonctionnent dans :

les éditeurs et champs portant le badge Liquid Supported ;
les messages pris en charge pour la réservation de billets et de bons ;
les pieds de page des billets ;
les modèles d’e-mails pris en charge pour les produits et les comptes.

Toutes les variables ne sont pas disponibles dans chaque emplacement. Les e-mails de réservation peuvent utiliser les détails d’une seule réservation, tandis que les reçus, factures, remboursements et demandes de paiement portent sur l’ensemble de la commande et disposent d’un autre ensemble de détails. Si une balise reste vide, consultez le popover du badge et les indications contextuelles ci-dessous, puis effectuez un test avec un exemple réel.

Ajouter du contenu Liquid à un e-mail de produit

Ouvrez le produit et accédez à Emails.
Recherchez le modèle à modifier et sélectionnez View, puis Edit.
Ajoutez au message des éléments Liquid de sortie ou de logique pris en charge.
Enregistrez le modèle.
Utilisez Send Test Email lorsque cette option est disponible et vérifiez le résultat affiché avant d’utiliser le modèle pour vos clients.

Personnaliser selon la langue

Si vous accueillez une clientèle internationale et locale, vous pouvez adapter vos messages en fonction de la langue sélectionnée lors de la réservation.

Mise à jour : la variable {{ order.language }} récupère désormais correctement la langue choisie par votre client dans le widget de réservation. Votre logique conditionnelle de langue fonctionnera de manière fiable pour toutes les nouvelles réservations.

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

Personnaliser selon le type de billet

Vous souhaitez adresser des messages particuliers aux personnes titulaires d’un billet VIP ou étudiant ? Utilisez des balises conditionnelles pour personnaliser le contenu selon le type de billet.

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

Modifier le lieu de rendez-vous selon le jour de la semaine

Si votre lieu de rendez-vous change certains jours, vous pouvez créer une règle pour afficher automatiquement les informations appropriées.

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

Conditions de langue avancées

De nombreux opérateurs organisent des visites pour un public international. Ces exemples conservent une sortie en anglais à titre de texte indicatif, afin que vous puissiez la remplacer par votre traduction révisée.

Message de droite à gauche :

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

Message propre à une langue :

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

Conseil : vous pouvez combiner dans un même message des conditions relatives au type de billet, à la langue et au jour. Lorsque le badge Liquid Supported est affiché, consultez-le et prévisualisez toujours le résultat.

Vérifier la prise en charge avant la mise en ligne

Ne partez pas du principe que Liquid fonctionne dans tous les champs de texte. Si le badge Liquid Supported n’est pas présent et que le champ n’est ni un message de réservation de billet ou de bon pris en charge, ni un pied de page de billet, testez-le avant de vous fier à du contenu dynamique.

Les balises non prises en charge peuvent apparaître vides ou rester telles qu’elles ont été saisies. Envoyez un e-mail de test ou créez un billet ou un bon de test avant de publier des modifications visibles par les clients.

Pourquoi utiliser les balises Liquid ?

Elles vous permettent de :

personnaliser automatiquement les messages adressés aux clients avec des données réelles de réservation ;
envoyer des e-mails dans la langue de vos clients sans gérer plusieurs modèles distincts ;
éviter les modifications manuelles et réduire les erreurs humaines ;
afficher des informations précises et dynamiques pour chaque réservation — lieux de rendez-vous, heures de prise en charge, informations sur le guide, et bien plus encore.

Balises Liquid courantes

Les balises couramment utilisées ci-dessous sont regroupées par catégorie. Leur disponibilité dépend de l’emplacement où vous les utilisez, et cette référence ne contient pas nécessairement tous les champs possibles. Lorsque le badge Liquid Supported est affiché, utilisez son popover et consultez la section Balises prises en charge par chaque e-mail ci-dessous pour connaître le contexte des e-mails.

Commande et réservation

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

Bon

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

Produit

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

Saison, variante et option

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

Client

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

Participant

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

Prise en charge

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

Fournisseur

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

Guide

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

Canal et revendeur

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

Paiement et remboursement

{{ amount }}
{{ payment_link }}

Marchandise

{{ merchandise.name }}

Autres

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

Balises prises en charge par chaque e-mail

Toutes les balises ne fonctionnent pas dans chaque e-mail. Une balise qui n’est pas prise en charge dans un e-mail donné peut s’afficher vide ; testez donc vos modèles avant de les utiliser. Lorsque le badge Liquid Supported est affiché, son popover constitue la référence actualisée pour ce modèle, même s’il ne répertorie pas nécessairement tous les champs possibles.

Important — détails de réservation et de commande : les balises telles que {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} et {{ guide.* }} décrivent une seule réservation et fonctionnent uniquement dans les e-mails de réservation. Les e-mails de reçu, de facture, de remboursement et de demande de paiement portent sur l’ensemble de la commande, qui peut contenir plusieurs réservations. Ces balises n’y sont donc pas disponibles : utilisez plutôt {{ customer.first_name }} pour la formule d’accueil.

E-mails de réservation

Confirmation de réservation de billet, confirmation de réservation de bon, rappel de réservation, réservation modifiée, réservation annulée, demande d’avis sur une réservation, récupération d’une réservation abandonnée.

Pris en charge : commande et réservation, bon, produit, saison/variante/option, client, participant, prise en charge, fournisseur, guide, canal et revendeur, autres.

E-mails de reçu et de facture

Reçu (envoyé lorsque la commande est entièrement payée) et facture / facture pro forma (envoyée lorsqu’un acompte ou un solde reste dû).

Pris en charge : client, fournisseur, commande.

Dans ces e-mails, la commande est le sujet du message. Écrivez donc les champs de commande sans le préfixe order. : {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-mails de remboursement

Envoyés lorsqu’un remboursement est effectué.

Pris en charge : client, fournisseur, commande, {{ amount }}.

E-mails de demande de paiement

Envoyés lorsque vous demandez à un client de régler un solde restant dû.

Pris en charge : commande, {{ amount }}, {{ payment_link }}.

Dans ces e-mails, le client et le fournisseur sont imbriqués sous la commande. Utilisez {{ order.customer.first_name }} et {{ order.supplier.name }}.

E-mails de carte cadeau

Envoyés lorsqu’un client achète une carte cadeau.

Pris en charge : client, fournisseur, {{ reference }}, {{ merchandise.name }}.

Erreurs courantes à éviter

1. Utiliser des accolades simples au lieu de doubles accolades

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

2. Confondre product et tour dans les noms de variables

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

TicketingHub utilise product — il s’agit de l’erreur de syntaxe la plus courante que nous rencontrons.

3. Faire confiance à la syntaxe de balises générée par l’IA

ChatGPT et Gemini peuvent proposer des formats de balises Liquid qui ne correspondent pas à l’implémentation de TicketingHub. Lorsque le badge Liquid Supported est affiché, consultez-le et comparez la suggestion avec les exemples de cette page.

4. Utiliser des balises Liquid sans vérifier leur prise en charge

Recherchez le badge Liquid Supported ou utilisez un message de réservation de billet ou de bon pris en charge, ou encore un pied de page de billet. Prévisualisez le résultat avant de le publier.

5. Variable indisponible dans ce type d’e-mail

Certaines variables ne sont disponibles que dans certains types d’e-mails. Si une balise ne s’affiche pas correctement, consultez la section Balises prises en charge par chaque e-mail ci-dessus : il est possible que la variable ne soit pas prise en charge dans cet e-mail.

Les balises Liquid en toute simplicité

Les balises Liquid peuvent sembler techniques, mais une fois que vous les maîtrisez, elles changent véritablement la donne. Elles sont idéales pour les opérateurs qui souhaitent automatiser leurs communications sans perdre leur dimension personnalisée.

Et si vous ne savez pas comment structurer une balise, nous sommes là pour vous aider : il vous suffit de nous contacter !