Utilisez le langage de template de Brevo pour personnaliser vos messages avec des données spécifiques aux contacts ou aux événements, masquer ou afficher du contenu pour des destinataires spécifiques et ajuster la mise en forme des valeurs.
💬 Variables
Les variables, également appelées placeholders ou tags de fusion, sont des tags que vous pouvez insérer dans vos messages pour les personnaliser. Lorsque vous envoyez un message, chaque variable est automatiquement remplacée par les informations du contact correspondantes.
Les variables doivent être entourées d’accolades doubles, comme {{ ... }} ou {{...}}. Elles peuvent être utilisées pour des insertions simples ou combinées à des expressions conditionnelles et des filtres pour une personnalisation avancée.
| Type de variable | Cas d'utilisation |
|---|---|
| 👤 Variables de contact | Attributs du contact statiques (nom, email…) |
| ⚡ Variables d’événement | Données provenant d’une action déclenchée |
| 🛢️ Variables de flux de données | Données en temps réel provenant d’une source externe |
| 🛒 Variables de flux produit | Listes de produits dynamiques |
| 📦 Variables d’objet | Attributs d’objet personnalisés |
| 📅 Variables de date | Horodatage d’envoi |
| 🔗 Variables de lien email et d’aperçu | Liens miroir, de désinscription, de mise à jour du profil et de double opt-in |
👤 Variables de contact
| Disponibles pour : | ✅ SMS | ✅ Push |
La syntaxe est {{ contact.ATTRIBUTE }}, où vous devez remplacer ATTRIBUTE par le nom exact de l’attribut du contact tel qu’il apparaît sur la page Attributs du contact. Les attributs par défaut et personnalisés sont pris en charge.
Par exemple :
| Entrée | Description | Sortie |
|---|---|---|
| {{ contact.EMAIL }} | Adresse email (par défaut) | abby@the-green-yoga.com |
| {{ contact.FIRSTNAME }} | Prénom (par défaut) | Abby |
| {{ contact.SMS }} | Numéro de téléphone (par défaut) | +12152688872 |
| {{ contact.LANGUAGE }} | Langue (personnalisée) | Anglais |
➡️ Pour en savoir plus, consultez nos articles dédiés :
⚡ Variables d'événement
| Disponibles pour : | ✅ Email (déclenchés uniquement) |
✅ SMS (déclenchés uniquement) |
✅ WhatsApp (déclenchés uniquement) |
✖️ Push |
Les variables d’événement vous permettent d’afficher les données d’événements spécifiques déclenchés par les actions d’un contact, comme le prix du dernier article qu'il a acheté ou le nom du rendez-vous qu’il a réservé.
Pour identifier les variables disponibles, consultez votre appel API ou vos logs d’événements dans Brevo. Les exemples ci-dessous reposent sur la structure JSON suivante :
|
data est l'objet racine qui contient les propriétés suivantes :
|
L'objet racine (data ci-dessus) est obligatoire. Toutes les autres propriétés sont facultatives et peuvent être nommées selon les besoins.
Selon l’emplacement de vos données dans la structure JSON, la syntaxe varie :
Les données stockées directement sous l'objet racine contiennent généralement des informations clés sur les événements, telles que les informations du panier, et peuvent être récupérées sans avoir à parcourir des tableaux.
La syntaxe est {{ params.property }}, où vous devez remplacer property par le nom exact de la propriété située sous l'objet racine dans votre structure JSON.
En tenant compte de la structure JSON ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {{ params.id }} | ID du panier | panier:1234 |
| {{ params.total }} | Total du panier | 280 |
| {{ params.currency }} | Devise du panier | Dollar américain |
| {{ params.url }} | URL du panier | http://www.exemple.com |
Les tableaux stockés sous l'objet racine, comme le tableau items ci-dessus, peuvent contenir plusieurs éléments, chacun avec ses propres propriétés. Utilisez l’indexation pour référencer des éléments spécifiques ou une boucle for pour itérer sur l’ensemble.
Utiliser l’indexation pour référencer des éléments spécifiques
La syntaxe d’indexation est {{ params.array.index.property }}, où vous devez remplacer chaque placeholder comme suit :
- array par le nom exact du tableau situé sous l'objet racine dans votre structure JSON.
- index par la position de l’élément que vous souhaitez référencer, à partir de 0 pour le premier élément.
- property par le nom exact de la propriété dans l'élément du tableau de votre structure JSON.
En tenant compte de la structure JSON ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {{ params.items.0.name }} | Nom du premier élément | Chaussures noires |
| {{ params.items.1.name }} | Nom du deuxième élément | Chemise blanche |
Utiliser une boucle for pour itérer sur tous les éléments
La syntaxe avec une boucle for est {% for item in params.array %} {{ item.property }} {% endfor %}, où vous devez remplacer chaque placeholder comme suit :
- array par le nom exact du tableau situé sous l'objet racine dans votre structure JSON.
- property par le nom exact de la propriété dans l'élément du tableau de votre structure JSON.
En tenant compte de la structure JSON ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {% for item in params.items %} {{ item.name }} {% endfor %} | Noms de tous les éléments |
Chaussures noires Chemise blanche |
➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.
🛢️ Variables de flux de données
| Disponibles pour : | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Les variables de flux de données vous permettent d’extraire des données en temps réel depuis une source externe ou une API, directement dans vos messages. Pour identifier les variables disponibles, accédez à Paramètres > Gestion des données > Flux de données et vérifiez la structure de votre fichier source :
En fonction de la complexité de la structure de votre flux de données, le format varie :
Les données stockées directement sous l’objet racine contiennent généralement l’entité la plus pertinente et la plus immédiate de votre flux, comme le prochain événement à venir ou le dernier produit, et peuvent être récupérées sans devoir parcourir des tableaux.
La syntaxe est {{ feed.feedalias.variable }}, où vous devez remplacer chaque placeholder comme suit :
- feedalias par le nom d’alias exact de votre flux de données, avec la même orthographe et casse telles qu’elles apparaissent sur la page Flux de données.
- variable par le nom de la variable ou du champ spécifique que vous souhaitez afficher.
En tenant compte du flux de données ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {{ feed.next_yoga_class.class_name }} | Nom du cours | Vinyasa du matin |
| {{ feed.next_yoga_class.studio_location }} | Adresse du studio | Studio du centre-ville |
| {{ feed.next_yoga_class.date }} | Date du cours | 07/03/2025 |
| {{ feed.next_yoga_class.time }} | Horaire du cours | 6 h 30 |
Les tableaux stockés sous l'objet racine peuvent contenir plusieurs éléments, chacun avec ses propres propriétés. Utilisez l’indexation pour référencer des éléments spécifiques ou une boucle for pour itérer sur l’ensemble.
Utiliser l’indexation pour référencer des éléments spécifiques
La syntaxe d’indexation est {{ feed.feedalias.array.index.variable }}, où vous devez remplacer chaque placeholder comme suit :
- feedalias par le nom d’alias exact de votre flux de données, avec la même orthographe et casse telles qu’elles apparaissent sur la page Flux de données.
- array par le nom du tableau contenant les valeurs de chaque élément.
- index par la position de l’élément spécifique que vous souhaitez afficher, à partir de 0 pour le premier élément.
- variable par le nom de la variable ou du champ spécifique que vous souhaitez afficher, par exemple name, price ou date.
En tenant compte du flux de données ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {{ feed.yoga_classes.following_classes.0.class_name }} | Nom du premier cours | Power Flow Yoga |
| {{ feed.yoga_classes.following_classes.1.class_name }} | Nom du deuxième cours | Yoga du soir restauratif |
Utiliser une boucle for pour itérer sur tous les éléments
La syntaxe avec une boucle for est {% for item in feed.feedalias.array %} {{ item.variable }} {% endfor %}, où vous devez remplacer chaque placeholder comme suit :
- feedalias par le nom d’alias exact de votre flux de données, avec la même orthographe et casse telles qu’elles apparaissent sur la page Flux de données.
- array par le nom du tableau contenant les valeurs de chaque élément.
- variable par le nom de la variable ou du champ spécifique que vous souhaitez afficher, par exemple name, price ou date.
En tenant compte du flux de données ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes %} {{ item.class_name }} {% endfor %} | Noms de tous les cours |
Power Flow Yoga Yoga du soir restauratif Les bases du hatha yoga Yin yoga et méditation ... |
➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.
🛒 Variables de flux produit
| Disponibles pour : | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Les variables de flux produit vous permettent d’afficher une liste dynamique des produits de votre boutique en ligne, y compris des détails comme le nom, la description, les prix, les images et la disponibilité.
La syntaxe est {{ feed.feedalias.products.variable }}, où vous devez remplacer chaque placeholder comme suit :
- feedalias par le nom exact de votre flux produit, avec la même orthographe et casse telles qu’elles apparaissent sur la page flux produit.
- variable par le nom du champ que vous souhaitez afficher.
En tenant compte du flux produit ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
| {{ feed.mats_bestseller.products.imageUrl }} | Image du produit | |
| {{ feed.mats_bestseller.products.name }} | Nom du produit | Tapis de yoga antidérapant, 6 mm |
| {{ feed.mats_bestseller.products.url }} | URL du produit | https://thegreenyoga.com/non-slip/black-mat.html |
Utiliser une boucle for pour itérer sur tous les éléments
La syntaxe avec une boucle for est {% for item in feed.feedalias.products %} {{ item.variable }} {% endfor %}, où vous devez remplacer chaque placeholder comme suit :
- feedalias par le nom d’alias exact de votre flux de données, avec la même orthographe et casse telles qu’elles apparaissent sur la page Flux de données.
- variable par le nom de la variable ou du champ spécifique que vous souhaitez afficher, par exemple name, price ou date.
En tenant compte du flux produit ci-dessus :
| Entrée | Description | Sortie |
|---|---|---|
|
{% for item in feed.mats_bestseller.products %} {{ item.name }} {% endfor %} |
Noms de tous les produits |
Tapis de yoga antidérapant, 6 mm Bloc de yoga, 10 cm Pantalon de yoga large taille haute |
➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.
📦 Variables d’objet
| Disponibles pour : | ✅ Email (automatisation uniquement) |
✅ SMS (automatisation uniquement) |
✖️ WhatsApp | ✖️ Push |
Les variables d’objet vous permettent d’inclure des informations sur vos objets personnalisés ou sur les objets qui leur sont associés dans vos messages. Elles peuvent uniquement être utilisées dans les automatisations, car elles s’appuient sur un enregistrement d’objet spécifique comme déclencheur de l’automatisation.
Pour créer des variables d’objet, vous aurez besoin du nom de l’objet et des ID d’attribut de la page Paramètres des objets personnalisés. Selon les données que vous souhaitez afficher, la syntaxe varie :
Les variables de données d’objet vous permettent d’afficher les attributs de l’enregistrement d’objet personnalisé qui a déclenché l’automatisation, comme le montant ou la date de création d’un devis.
La syntaxe est {{ feed.object.attributes.variable }}, où vous devez remplacer chaque placeholder comme suit :
- object par le nom au singulier de votre objet personnalisé tel que défini lors de sa création.
- variable par l'ID d’attribut que vous souhaitez afficher, par exemple name, amount ou date. Vous pouvez trouver les ID d’attribut en cliquant sur le nom de l’objet depuis la page Paramètres des objets personnalisés.
En tenant compte d'un objet quote avec les attributs amount, date, id_quote et paid :
| Entrée | Description | Sortie |
|---|---|---|
| {{ feed.quote.attributes.amount }} | Montant du devis | 350 |
| {{ feed.quote.attributes.date }} | Date de création du devis | 2025-03-29T00:04:11+00:00 |
| {{ feed.quote.attributes.paid }} | Statut du paiement | true |
| {{ feed.quote.attributes.id_quote }} | ID du devis | OQPPBDCSSZQ9 |
Les variables de données d’objet associé vous permettent d’afficher des attributs d’objets liés à l’objet personnalisé qui a déclenché l’automatisation. Utilisez l’indexation pour référencer des enregistrements spécifiques, ou une boucle for pour itérer sur l’ensemble.
Utiliser l’indexation pour référencer des éléments spécifiques
La syntaxe d’indexation est {{ feed.object.associations.associatedobject.index.variable }}, où vous devez remplacer chaque placeholder comme suit :
- object par le nom au singulier de votre objet personnalisé tel que défini lors de sa création.
- associatedobject par le nom au singulier de votre objet associé disponible sous l’onglet Associations lors de la sélection d’un objet personnalisé depuis la page Paramètres des objets personnalisés.
- index par la position de l’enregistrement d’objet associé que vous souhaitez afficher, à partir de 0 pour le premier enregistrement.
- variable par l’ID d'attribut que vous voulez afficher, situé sous l’onglet Associations lorsque vous sélectionnez un objet personnalisé depuis la page Paramètres des objets personnalisés.
En tenant compte d'un objet quote associé à des enregistrements vehicle contenant un attribut brand :
| Entrée | Description | Sortie |
|---|---|---|
| {{ feed.quote.associations.vehicle.0.brand }} | Marque du premier véhicule | Renault |
| {{ feed.quote.associations.vehicle.1.brand }} | Marque du deuxième véhicule | Toyota |
Utiliser une boucle for pour itérer sur tous les éléments
La syntaxe avec une boucle for est {% for item in feed.object.associations.associatedobject %} {{ item.variable }} {% endfor %}, où vous devez remplacer chaque placeholder comme suit :
- object par le nom au singulier de votre objet personnalisé tel que défini lors de sa création.
- associatedobject par le nom au singulier de votre objet associé disponible sous l’onglet Associations lors de la sélection d’un objet personnalisé depuis la page Paramètres des objets personnalisés.
- variable par l’ID d'attribut que vous voulez afficher, situé sous l’onglet Associations lorsque vous sélectionnez un objet personnalisé depuis la page Paramètres des objets personnalisés.
En tenant compte d'un objet quote associé à des enregistrements vehicle contenant un attribut brand :
| Entrée | Description | Sortie |
|---|---|---|
|
{% for item in feed.quote.associations.vehicle %} {{ item.brand }} {% endfor %} |
Marque de tous les enregistrements de véhicules associés |
Renault Toyota Audi ... |
➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.
📅 Variables de date
| Disponibles pour : | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Insère un horodatage de la date et de l’heure exactes auxquelles le message a été envoyé, en fonction du fuseau horaire de votre compte Brevo. Par défaut, l’heure UTC est utilisée si aucun fuseau horaire n’est défini.
La syntaxe est {{ time_now }}.
Par exemple :
| Entrée | Description | Sortie |
|---|---|---|
| Nous sommes le {{ time_now }} | Horodatage complet | Aujourd'hui, nous sommes le 11/03/2025 15:10:20.823713502 +0100 CET |
| Nous sommes le {{ time_now |date:"Monday, Jan 2, 2006" }} | Date mise en forme avec le filtre date | Aujourd'hui, nous sommes le mardi 11 mars 2025 |
➡️ Pour en savoir plus sur l’ajustement de la mise en forme des dates, consultez notre article dédié Modifiez le formatage de vos placeholders avec des filtres.
🔗 Variables de lien email et d’aperçu
| Disponibles pour : | ✖️ SMS | ✖️ WhatsApp | ✖️ Push |
Placez ces variables dans un tag HTML <a> pour permettre aux destinataires d’afficher votre email dans un navigateur, de se désabonner ou de gérer leurs préférences.
Les variables de lien email et d’aperçu suivantes sont disponibles :
| Entrée | Description | Sortie |
|---|---|---|
| <a href="{{ mirror }}">Afficher dans le navigateur</a> | Lien miroir | Afficher dans le navigateur |
| S'il n'est plus nécessaire de <a href="{{ unsubscribe }}">Se désabonner</a> | Lien de désabonnement | Se désabonner |
| <a href="{{ update_profile }}">Mettre à jour vos préférences</a> | Lien de mise à jour du profil | Mettre à jour vos préférences |
| <a href="{{ doubleoptin }}">Je confirme mon abonnement</a> | Lien de double opt-in | Je confirme mon abonnement |
➡️ Pour en savoir plus, consultez nos articles dédiés :
- Insérer un lien « Afficher dans le navigateur » dans vos campagnes
- Insérer un lien de désinscription dans vos campagnes
- Mettre à jour les informations et préférences de vos contacts (formulaire de mise à jour du profil)
- Créer un template email de confirmation en double opt-in (DOI) personnalisé pour vos formulaires d'inscription Brevo
📢 Expressions conditionnelles
| Disponibles pour : | ✖️ SMS | ✖️ WhatsApp | ✖️ Push |
Affichage conditionnel (instructions if)
Utilisez une instruction if pour afficher ou masquer des parties de votre email en fonction des données de chaque destinataire.
➡️ Pour en savoir plus sur l’instruction if, consultez notre article dédié [Manuel] Afficher ou masquer le contenu de vos emails avec des instructions if.
Sections répétables (boucles for)
Utilisez une boucle for pour afficher dynamiquement tous les éléments d'un tableau, sans référencer manuellement chaque index.
➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Manuel] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.
🪄 Filtres
| Disponibles pour : | ✅ SMS | ✖️ WhatsApp | ✖️ Push |
Les filtres modifient la sortie d’une variable et se placent entre double accolades, séparés par une barre verticale |. Vous pouvez combiner plusieurs filtres.
Par exemple :
| Entrée | Description | Sortie |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes|slice:'0:3' %} | Limite le nombre d’éléments à afficher dans une boucle for |
Power Flow Yoga Yoga du soir restauratif Les bases du hatha yoga |
| {{ contact.FIRSTNAME|upper }} | Convertit le prénom du destinataire en majuscules (à l’origine : Abby). | ABBY |
| {{ params.TOTAL|floatformat:2 }} | Affiche le total du panier avec deux décimales (à l'origine : 49,995). | 49,99 |
| {{ time_now|date:"02/01/2006" }} | Met en forme la date du jour en jj/mm/aaaa (à l'origine : 2025-03-11 15:10:20.823713502 +0100 CET). | 11/03/2025 |
➡️ Pour en savoir plus, consultez notre article dédié Modifiez le formatage de vos placeholders avec des filtres.
🤔 Vous avez des questions ?
Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.
Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.