Variables des modèles d'email

Pour :Administrateur

Vue de la page « variables modeles email »

Les variables sont des balises de personnalisation que vous insérez dans le contenu d'un email et qui sont remplacées à l'envoi par les données réelles du destinataire ou du contexte.

Cette page recense toutes les variables disponibles dans Unisoft, par contexte d'utilisation.

⚠

Les variables ne sont pas universelles

Toutes les variables ne sont pas disponibles dans tous les contextes. Une variable qui fonctionne dans un email de paiement ne fonctionne pas forcément dans une campagne de messages, et vice-versa.

La liste ci-dessous est stricte : si une variable n'est pas listée pour un contexte donné, elle ne sera pas remplacée — elle apparaîtra telle quelle dans l'email reçu par le destinataire.

Syntaxe générale

Toutes les variables Unisoft suivent la même syntaxe : double accolade ouvrante et fermante autour du nom de la variable.

Forme	Syntaxe
Variable simple	{{nom_variable}}

Sensibilité :

• Sensible à la casse : {{prenom}} fonctionne, {{Prenom}} ne fonctionne pas.
• Pas d'espaces autour du nom : {{ prenom }} ne fonctionne pas (utilisez {{prenom}} strictement).
• Pas de variables conditionnelles : pas de {{#if}}, pas de {{else}}. Le moteur de templating Unisoft est volontairement minimal.
• Pas de boucles : pas de {{#each items}}...{{/each}}. Pas de listes dynamiques.

Contexte 1 — Campagnes de messages

S'applique aux emails envoyés via le module Campagnes de Messages (/app/messages/campagnes), que le contenu soit saisi directement ou via un modèle d'email.

Variable	Sera remplacée par	Exemple
{{nom}}	Nom de famille du contact, avec majuscule initiale	COHEN → Cohen
{{prenom}}	Prénom du contact, avec majuscule initiale	david → David
{{prenomHE}}	Prénom hébraïque du contact, tel quel sans transformation	דוד
{{mailing_unsubscribe}}	URL personnalisée de désabonnement pour ce destinataire	https://api.unisoft.world/mailing/unsubscribe/<org>/<send>

À propos de {{mailing_unsubscribe}}

Cette variable est automatiquement injectée en bas de l'email si vous ne la placez pas vous-même dans le contenu. Concrètement :

• Si vous ne mettez pas {{mailing_unsubscribe}} dans votre email → Unisoft ajoute un lien Me Désinscrire centré tout en bas du body, juste avant la balise </body>.
• Si vous mettez {{mailing_unsubscribe}} quelque part dans votre email → Unisoft remplace votre balise par l'URL, et n'ajoute pas de bloc en bas.

C'est utile si vous voulez maîtriser la position et le style du lien de désabonnement.

Exemple d'usage dans un template HTML :

<p style="font-size: 11px; color: #888; text-align: center;">
  Si vous ne souhaitez plus recevoir nos communications :
  <a href="{{mailing_unsubscribe}}">cliquez ici pour vous désinscrire</a>
</p>

Voir Désabonnement aux emails pour le détail du mécanisme.

Contexte 2 — Emails de formulaire

S'applique aux emails automatiques déclenchés lors de la soumission ou validation d'un formulaire Unisoft (champs submitEmailTemplate et valideEmailTemplate dans la configuration d'un formulaire).

Variable	Sera remplacée par	Disponible ?
{{nom}}	Nom de famille de la personne qui a soumis le formulaire	✅
{{prenom}}	Prénom de la personne qui a soumis le formulaire	✅
{{prenomHE}}	Prénom hébraïque	✅
{{__org_name}}	Nom de votre organisation Unisoft (double underscore initial)	✅
{{montant}}	Montant payé	❌ PAS DISPONIBLE
{{devise}}	Devise du paiement	❌ PAS DISPONIBLE

⛔

Attention : pas de variables montant / devise dans les emails de formulaire

Une erreur fréquente consiste à utiliser {{montant}} ou {{devise}} dans un email de formulaire en pensant que le montant payé sera inséré. Ce n'est pas le cas.

Si vous écrivez « Merci d'avoir versé {{montant}} {{devise}} » dans l'email de validation d'un formulaire de don, le destinataire recevra littéralement : « Merci d'avoir versé {{montant}} {{devise}} » avec les balises non remplacées.

Pour insérer le montant payé dans un email, c'est le contexte Email de paiement (ci-dessous) qui s'applique — et le moteur de templating est différent.

ℹ

La configuration des emails de formulaire

Les modules Formulaires existent encore principalement en interface legacy (pas new_ui). La configuration des emails (submitEmailTemplate, valideEmailTemplate) se fait dans l'éditeur de formulaire — son interface n'est pas documentée ici. Pour les emails de paiement liés à un formulaire, c'est plutôt le contexte Paiement qui s'applique.

Contexte 3 — Emails de paiement et reçu fiscal

S'applique aux emails automatiques envoyés lors d'un paiement validé (confirmation au donateur, envoi du reçu fiscal).

Variable	Sera remplacée par	Disponible ?
{{nom}}	Nom du donateur	✅
{{prenom}}	Prénom du donateur	✅
{{__org_name}}	Nom de votre organisation Unisoft	✅
{{montant}}	Montant payé (chiffre sans devise)	✅
{{devise}}	Symbole ou code de la devise (€, $, ₪, £)	✅

C'est le seul contexte où {{montant}} et {{devise}} fonctionnent.

Exemple typique dans un template de reçu fiscal :

Cher {{prenom}},

Nous accusons réception de votre don de {{montant}} {{devise}}
au profit de {{__org_name}}.

Veuillez trouver ci-joint votre reçu fiscal.

Cordialement,
L'équipe {{__org_name}}

ℹ

Templates de paiement : pas un module new_ui

Les templates des emails de paiement et de reçu fiscal sont gérés dans la configuration du module Paiements (ou dans des fichiers EJS côté serveur Unisoft pour les organisations qui n'ont pas personnalisé). Cette gestion sort du périmètre du module Modèles d'email (qui sert principalement aux campagnes).

Contexte 4 — Notifications système

Les notifications système (alerte de paiement reçu envoyée à l'admin, alerte technique d'erreur, etc.) n'utilisent pas de variables : leur contenu est statique, généré par le backend Unisoft.

Vous ne pouvez pas personnaliser ces notifications via un modèle d'email.

Tableau récapitulatif

Vue d'ensemble — quelle variable fonctionne dans quel contexte :

Variable	Campagne messages	Email formulaire	Email paiement	Notif système
{{nom}}	✅	✅	✅	❌
{{prenom}}	✅	✅	✅	❌
{{prenomHE}}	✅	✅	❌	❌
{{__org_name}}	❌	✅	✅	❌
{{montant}}	❌	❌	✅	❌
{{devise}}	❌	❌	✅	❌
{{mailing_unsubscribe}}	✅	❌	❌	❌

Comportement des variables vides

Quand une variable est utilisée mais que la donnée correspondante est vide ou manquante sur le contact, Unisoft la remplace par une chaîne vide (pas par un texte par défaut, pas par une erreur).

Exemple : un contact sans prénom recevra :

Cher Cohen,

au lieu de :

Cher David Cohen,

⚠

Auditez votre base avant un envoi de masse

Avant d'envoyer une campagne avec beaucoup de personnalisation, vérifiez la qualité des coordonnées de votre base :

• Combien de contacts ont un prénom renseigné ?
• Combien ont un prénom hébraïque renseigné (pour {{prenomHE}}) ?

Pour les variables où vous avez beaucoup de trous, soit vous complétez les données en amont, soit vous évitez ces variables pour cette campagne (utiliser un message générique type « Cher fidèle »).

Pièges fréquents

• Casse incorrecte : {{Prenom}} ou {{PRENOM}} ne sont pas reconnus. Toujours en minuscules.
• Variable orthographiée approximativement : {{prenoms}}, {{first_name}}, {{name}} ne fonctionnent pas. Respectez la syntaxe exacte ci-dessus.
• Variable d'un autre contexte : utiliser {{montant}} dans une campagne de messages → le destinataire verra littéralement {{montant}}.
• Espaces dans les accolades : {{ prenom }} ne fonctionne pas, utilisez {{prenom}}.
• Tentative de formatage : {{prenom.toUpperCase()}} ne fonctionne pas, les variables sont brutes.

Cas non supportés

Pour information, voici ce qu'aucun moteur de templating Unisoft ne sait faire :

• ❌ Variables conditionnelles ({{#if prenom}}...{{/if}})
• ❌ Boucles sur une liste ({{#each contacts}})
• ❌ Formatage de nombres ({{montant | format: 'currency'}})
• ❌ Calculs ({{montant * 0.66}})
• ❌ Variables imbriquées ({{contact.adresse.ville}})
• ❌ Variables custom définies par l'admin (les variables disponibles sont fixées par le code Unisoft)

Si vous avez besoin de ces fonctionnalités avancées, c'est généralement un signal que le cas d'usage devrait être géré ailleurs qu'avec un simple template (par exemple : par segmentation en plusieurs campagnes ciblées).

Pour aller plus loin

• Modèles d'email — la gestion des templates réutilisables
• Créer une campagne de messages — où insérer des variables dans une campagne
• Désabonnement aux emails — détail sur {{mailing_unsubscribe}}