Passer au contenu principal
Les variables permettent à un seul modèle approuvé d’envoyer des messages personnalisés à des milliers de contacts sans nouvel examen par Meta. Cette page explique comment fonctionnent les variables dans Flowella, comment fonctionnent les valeurs d’exemple et de repli, et comment remplir les variables depuis HubSpot. Pour la structure d’un modèle, voir la Référence des modèles. Pour créer un modèle étape par étape, voir Modèles.

​
Syntaxe

Les modèles WhatsApp utilisent des variables positionnelles : des doubles accolades avec un numéro.
  • Pour ajouter une variable, cliquez sur + Variable dans l’éditeur du corps, ou sur Variable à côté de Header text. Flowella insère le numéro suivant pour vous.
  • Les numéros commencent à {{1}} et doivent se suivre. Vous ne pouvez pas passer de {{1}} à {{3}}.
  • Les variables sont du texte. Les nombres, dates et montants sont envoyés sous forme de texte : mettez-les donc en forme avant qu’ils n’arrivent dans le modèle.
Meta prend aussi en charge les variables nommées, comme {{first_name}}. Flowella peut envoyer des modèles avec des variables nommées créés dans WhatsApp Manager, mais son éditeur ne crée que des variables positionnelles.

​
Où les variables peuvent apparaître

​
Valeurs d’exemple

Lorsque vous publiez un modèle, Meta a besoin d’un exemple pour chaque variable. Meta utilise les exemples pour :
  1. Vérifier que le contenu correspond à la catégorie choisie (Marketing, Utility ou Authentication).
  2. Évaluer la qualité et le risque de spam.
  3. Montrer un aperçu aux examinateurs.
Dans Flowella, l’exemple d’une variable est sa Fallback value. De bons exemples facilitent l’approbation :
  • Utilisez des valeurs réalistes. John convient ; xxx entraîne souvent un rejet.
  • Gardez des exemples courts. Un paragraphe dans une seule variable est un signal de rejet classique.
  • Respectez le type. Si {{2}} est une date, utilisez une date. S’il s’agit d’un numéro de commande, utilisez une valeur qui ressemble à un numéro de commande.

​
Valeurs de repli

Chaque variable de l’éditeur a un champ Fallback value :
  • Variables du corps : dans le panneau Body variables de l’éditeur du corps.
  • Variable de l’en-tête texte : sous Header variables dans la carte Variables.
  • Variable du bouton URL : sous l’adresse du bouton.
La valeur de repli a trois rôles :
  1. Elle s’affiche dans l’aperçu.
  2. Elle est transmise à Meta comme exemple de la variable lors de la publication.
  3. Flowella l’envoie lorsque la valeur d’un contact est manquante ou vide, une fois les valeurs de repli confirmées.
Choisissez une valeur qui se lit naturellement pour tout le monde, comme there dans Hi there. Les valeurs de repli ne peuvent pas contenir de sauts de ligne. Lorsque vous publiez un modèle créé dans Flowella, ses valeurs de repli sont confirmées automatiquement.

​
Modèles avec Fallbacks not reviewed

Certains modèles affichent un badge Fallbacks not reviewed dans la liste des modèles. Personne n’a encore confirmé leurs valeurs de repli, par exemple parce que le modèle a été créé dans WhatsApp Manager. Flowella préremplit leurs valeurs de repli à partir des exemples du modèle. Tant que vous ne les avez pas confirmées :
  • L’éditeur affiche une bannière : Review fallback values. These are used when a contact’s data is empty. Until you confirm them, sends with missing data will fail.
  • Tout envoi comportant une valeur vide échoue au lieu d’utiliser la valeur de repli.
Pour trouver ces modèles, cliquez sur Fallbacks not reviewed au-dessus de la liste des modèles. Pour confirmer les valeurs :
1

Ouvrir le modèle

Sur la page Templates, ouvrez le modèle dans l’éditeur.
2

Vérifier chaque valeur de repli

Lisez chaque Fallback value et modifiez celles qui ne se liraient pas bien pour tous les contacts.
3

Confirmer

Cliquez sur Confirm fallback values dans la bannière. Si vous avez modifié une valeur, cliquez plutôt sur Save Template. Dans les deux cas, rien n’est transmis à Meta et le modèle n’est pas réexaminé.
Après avoir cliqué sur Confirm fallback values, Flowella affiche Fallback values confirmed et le badge disparaît.

​
Ce qui se passe à l’envoi

Cela s’applique aux workflows HubSpot, aux envois en masse, à l’API, aux envois de test et aux envois depuis la boîte de réception. Flowella n’envoie jamais de variable vide à Meta. Lorsqu’un envoi échoue à cause d’une variable vide, l’erreur indique la variable et renvoie vers le modèle. Par exemple : Variable {{2}} is empty and has no fallback value. Dans un workflow HubSpot, l’action échoue pour ce contact et l’historique du workflow affiche le message. Si la variable n’a pas de valeur de repli, la sortie Error code de l’action est VARIABLE_EMPTY_NO_FALLBACK.

​
Mapper les variables depuis HubSpot

Dans un workflow HubSpot, l’action Send WhatsApp Template comporte cinq emplacements de variables : Template Variable 1 à Template Variable 5. Voir Actions de workflow.
1

Choisir le modèle

Choisissez le modèle dans Template Name. La liste affiche chaque modèle une seule fois, par nom.
2

Mapper les variables dans l'ordre

Flowella remplit d’abord une variable d’en-tête texte, puis les variables du corps dans l’ordre. Par exemple, un modèle comporte {{1}} dans l’en-tête et {{1}} et {{2}} dans le corps. Mappez Template Variable 1 sur la valeur de l’en-tête, et Template Variables 2 et 3 sur les valeurs du corps. Les en-têtes image, vidéo et document n’utilisent pas d’emplacement.
3

Prévoir les valeurs vides

Si une propriété mappée est vide pour un contact, Flowella envoie la valeur de repli confirmée. Si le modèle n’a pas de valeur de repli confirmée pour cette variable, l’action échoue pour ce contact. Si vous mappez moins d’emplacements que le modèle n’a de variables, Flowella considère les variables manquantes comme vides.
4

Tester avant la mise en production

Inscrivez d’abord un contact de test et vérifiez le message sur votre téléphone. Activez ensuite le workflow pour tout le monde.
Un modèle peut comporter plus de cinq variables, mais l’action ne peut en mapper que cinq. Pour chaque variable après la cinquième, Flowella envoie la valeur de repli confirmée, ou l’envoi échoue s’il n’y en a pas.

​
Dates provenant de HubSpot

HubSpot envoie les propriétés de date et de date-heure sous forme d’horodatage. Flowella le convertit au format dd.MM.yyyy HH:mm en UTC, par exemple 27.06.2026 14:30. Une propriété de date seule affiche l’heure 00:00. Pour afficher une date à l’heure locale du contact, ou dans un autre format, stockez la date mise en forme dans une propriété texte HubSpot et mappez plutôt cette propriété. Flowella envoie les propriétés texte exactement telles quelles.

​
Langue

La liste Template Name affiche chaque nom de modèle une seule fois. Si un modèle est approuvé dans plusieurs langues, Flowella choisit une version dans cet ordre :
  1. La langue transmise avec l’action de workflow, le cas échéant.
  2. Une version avec le code de langue en. Les versions en en_US ou en_GB ne comptent pas ici.
  3. La version approuvée mise à jour le plus récemment.
Flowella n’utilise pas la propriété de langue HubSpot du contact. Pour envoyer différentes langues à différents contacts, donnez à chaque version linguistique son propre nom de modèle et créez des branches dans votre workflow selon la langue.

​
En-têtes de localisation

Un modèle avec un en-tête de localisation nécessite une latitude et une longitude à chaque envoi. Le nom du lieu et l’adresse sont facultatifs. Dans un workflow HubSpot, mappez la localisation sur les emplacements Template Variable qui suivent vos variables de corps : d’abord la latitude, puis la longitude, puis le nom du lieu. Par exemple, avec deux variables de corps, mappez la latitude sur Template Variable 3 et la longitude sur Template Variable 4.

​
Conseils de mise en forme des variables

Noms
Mettez d’abord une majuscule à la propriété dans HubSpot, ou utilisez une étape de workflow HubSpot pour copier firstname dans une propriété « First name (formatted) ». Dates WhatsApp ne met pas les dates en forme. Mappez une propriété texte qui contient la date telle que vous voulez qu’elle se lise, par exemple 24 May 2026. Voir Dates provenant de HubSpot. Devises Mettez les montants en forme avant qu’ils n’arrivent dans le modèle. Placez le symbole de la devise dans le texte du modèle (Total: £{{1}}) pour que la variable ne contienne que le nombre. URL dans le texte du corps Vous pouvez placer une URL complète dans une variable du corps, mais l’aperçu du lien ne s’affichera pas et l’URL compte dans la limite de caractères du corps. Utilisez plutôt un bouton URL avec une variable à la fin :
Les envois des workflows HubSpot ne remplissent que les variables du corps, de l’en-tête et de la localisation. Ils ne peuvent pas donner à un bouton URL une valeur différente pour chaque contact : pour les liens qui varient selon le contact dans un workflow HubSpot, placez donc plutôt l’URL complète dans une variable du corps.

​
Causes de rejet fréquentes liées aux variables

  • Numéros sautés ({{1}} puis {{3}}). Numérotez les variables dans l’ordre.
  • Une variable tout au début ou à la fin du corps sans texte autour. Ajoutez un mot avant ou après.
  • Deux variables côte à côte ({{1}}{{2}}). Séparez-les au moins par un espace ou une ponctuation.
  • Des exemples qui ressemblent à des espaces réservés, comme test, xxx ou 123, surtout dans les modèles Marketing.
  • Des variables dans le pied de page. Les pieds de page ne peuvent pas contenir de variables.
  • Plus d’une variable dans un bouton URL. Une seule est autorisée, et elle doit se trouver à la fin de l’URL.

​
Schémas avancés

​
Réutiliser une valeur dans plusieurs composants

Les variables de l’en-tête et du corps sont numérotées séparément : un {{1}} d’en-tête et un {{1}} de corps sont donc des variables différentes. Si le nom d’un client apparaît dans les deux, mappez la même propriété HubSpot sur les deux emplacements : Template Variable 1 pour l’en-tête et Template Variable 2 pour le corps.

​
Contenu conditionnel

Les modèles WhatsApp ne prennent pas en charge la logique if/else. Pour envoyer un contenu différent à différents groupes de contacts, créez des modèles distincts et créez des branches dans votre workflow HubSpot, par exemple « VIP welcome » et « Standard welcome ».

​
Modèles multilingues

Chaque version linguistique d’un modèle est soumise, approuvée et stockée séparément. Gardez les variables aux mêmes positions dans chaque langue. Pour savoir quelle version un workflow HubSpot envoie, voir Langue.

​
Dépannage

La valeur du contact était vide et le modèle n’a pas de valeur de repli pour cette variable. Dans HubSpot, l’Error code de l’action est VARIABLE_EMPTY_NO_FALLBACK. Assurez-vous que la propriété est remplie pour chaque contact, ou ajoutez une valeur de repli au modèle et confirmez-la.
Le modèle a une valeur de repli, mais personne ne l’a confirmée. Ouvrez le modèle et cliquez sur Confirm fallback values. Voir Modèles avec Fallbacks not reviewed.
La propriété mappée était vide pour ce contact, ou le modèle comporte plus de cinq variables. Vérifiez la fiche du contact et le mappage des variables dans l’action de workflow.
Non. Flowella n’envoie jamais de variable vide ou non remplie. Une valeur vide est remplacée par la valeur de repli confirmée, ou l’envoi échoue.
Une variable contient une URL ou un contenu qui ne correspond pas à la catégorie du modèle. Vous ne pouvez pas ajouter de contenu de type marketing à un modèle Utility via ses variables. Pour rechercher le code d’erreur renvoyé par WhatsApp, voir Codes d’erreur WhatsApp dans Flowella.
Pour soumettre, modifier et mettre en pause des modèles, voir Modèles et la Référence des modèles. Pour une aide spécifique aux rejets, voir Modèle rejeté.
Dernière modification le 24 octobre 2026