# Variables

Une variable s’écrit entre doubles accolades. À l’envoi, elle est remplacée par la valeur du contact, dans l’objet, le texte d’aperçu et le corps du message.

| Variable                 | Remplacée par                                |
| ------------------------ | -------------------------------------------- |
| `{{prenom}}`             | Prénom du contact                            |
| `{{nom}}`                | Nom du contact                               |
| `{{email}}`              | Adresse e-mail du contact                    |
| `{{lien_desabonnement}}` | Lien de désabonnement propre au destinataire |

Toute colonne de tes contacts, en plus, devient une variable (voir ci-dessous).

## Les colonnes de tes contacts

Chaque colonne de ton fichier, en plus de l’e-mail, devient une variable. Un fichier avec les colonnes `email`, `prenom`, `entreprise` et `ville` permet d’écrire :

```text
Bonjour {{prenom}}, comment va {{entreprise}} à {{ville}} ?
```

Le nom de la variable est celui de la colonne, en minuscules. Les accents et les espaces sont acceptés : `{{prénom}}` et `{{Ville}}` fonctionnent aussi. Les noms `email`, `prenom`, `nom` et `lien_desabonnement` sont réservés : une colonne qui les porte ne crée pas de variable à part.

Les colonnes s’ajoutent à l’import, voir [Importer des contacts](/docs/guides/importer-des-contacts/).

## Valeur de secours

Après une barre verticale, la valeur à utiliser quand le contact n’a pas l’information :

```text
Bonjour {{prenom|à toi}},
```

devient « Bonjour Camille, » pour Camille, et « Bonjour à toi, » pour un contact sans prénom. Sans valeur de secours, la variable disparaît pour ce contact.

Une valeur de secours est utile dans chaque message qui peut partir à un contact sans la donnée. Pour `{{entreprise|ton équipe}}`, un contact sans entreprise lit « ton équipe ».

## Le lien de désabonnement

`{{lien_desabonnement}}` est remplacé par le lien de désabonnement propre à chaque destinataire. Tu n’en as besoin que dans un e-mail envoyé par l’API : une campagne ou un workflow ajoute le lien tout seul, dans son pied de page. Voir [API e-mails](/docs/reference/api-emails/#lien-de-desabonnement).

## Les formes des autres outils

La forme de Resend, `{{{FIRST_NAME}}}`, est acceptée telle quelle. Un modèle exporté d’un autre outil fonctionne donc sans retouche. Les correspondances courantes :

| Forme d’un autre outil                  | Variable chez Mail       |
| --------------------------------------- | ------------------------ |
| `{{{FIRST_NAME}}}` ou `{{{firstname}}}` | `{{prenom}}`             |
| `{{{LAST_NAME}}}`                       | `{{nom}}`                |
| `{{{RESEND_UNSUBSCRIBE_URL}}}`          | `{{lien_desabonnement}}` |

## Où les variables s’appliquent

| Envoi                         | Variables remplies avec                                                                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Campagne                      | Le contact destinataire.                                                                                                                                                      |
| Étape e-mail d’un workflow    | Le contact qui suit le parcours.                                                                                                                                              |
| Essai                         | Toi : ton prénom et ton adresse.                                                                                                                                              |
| Modèle envoyé depuis ton code | Les valeurs que ton logiciel transmet avec l’envoi. Sans valeur, le repli s’applique, ou rien. Voir [Envoyer depuis ton logiciel](/docs/guides/envoyer-depuis-ton-logiciel/). |
| Envoi direct par l’API        | Rien : le contenu envoyé par ton logiciel part tel quel.                                                                                                                      |

`{{prénom}}` avec accent fonctionne aussi. Une variable qui ne correspond à aucune colonne, comme `{{societe}}` sans colonne de ce nom, reste visible telle quelle. Mieux vaut une coquille qui se voit qu’un mot qui disparaît.

## Si ça ne marche pas

- **La variable s’affiche telle quelle dans le message** : aucune colonne ne porte ce nom. Vérifie l’orthographe de l’en-tête du fichier.
- **Un contact voit « Bonjour , »** : pas de valeur de secours. Ajoute-la, par exemple `{{prenom|à toi}}`.