# Modèles

Un modèle est un message gardé de côté pour le réutiliser : une newsletter mensuelle, une annonce de rentrée, un e-mail de confirmation. Ils se trouvent dans **Modèles**, dans le menu.

Un modèle ne part jamais tout seul. Il sert de point de départ : tu en fais une campagne, ou ton logiciel l’envoie avec les valeurs de chaque destinataire.

## Créer un modèle

Deux façons de le faire :

- **Depuis le menu Modèles** : crée un modèle vide, puis écris-le dans l’éditeur.
- **Depuis une campagne** : ouvre la campagne, puis **…** dans la barre du haut, et **Enregistrer comme modèle**. La campagne reste intacte.

L’éditeur est le même que pour une campagne : mêmes blocs, même **Style du message**, même **Aperçu**. Le guide [Personnaliser un e-mail](/docs/guides/personnaliser-un-email/) détaille tout.

Un modèle peut utiliser les [variables](/docs/reference/variables/), comme `{{prenom}}` ou `{{entreprise|ton équipe}}`. Elles sont remplies à l’envoi, pas à l’enregistrement.

## Dupliquer, renommer, supprimer

Dans la liste des modèles, le menu d’actions de chaque modèle propose :

- **Dupliquer** : une copie indépendante, à modifier sans toucher à l’original. Pratique pour une variante ou pour une offre de saison.
- **Supprimer** : le modèle disparaît de la liste. Les campagnes déjà créées à partir de lui restent en place.

Pour renommer un modèle, ouvre-le et change son nom dans la barre du haut de l’éditeur.

## Créer une campagne depuis un modèle

Ouvre le modèle, puis clique sur **Créer une campagne**. Une nouvelle campagne se crée avec le même contenu, à modifier librement. Le modèle reste tel quel.

Tu peux aussi partir d’un modèle depuis **Nouvelle campagne** : la section **Tes modèles** les liste à côté des modèles de départ.

## Envoyer depuis ton code

Sur un modèle, **Envoyer depuis ton code** affiche comment l’envoyer depuis ton site ou ton logiciel, avec deux exemples prêts à copier : le SDK TypeScript et une commande cURL. Les exemples contiennent :

- l’identifiant du modèle, à copier tel quel ;
- la liste des variables du modèle, avec la valeur à transmettre pour chaque destinataire.

Une variable sans valeur de secours doit être transmise à chaque envoi, sinon l’envoi n’est pas accepté. Une valeur de secours, comme `{{prenom|à toi}}`, rend l’envoi possible sans elle.

Les clés, les paramètres et les réponses de l’API sont décrits dans [Envoyer depuis ton logiciel](/docs/guides/envoyer-depuis-ton-logiciel/) et [API modèles](/docs/reference/api-modeles/).

## Si ça ne marche pas

- **L’envoi depuis le code est refusé avec `422`** : une variable sans valeur ni valeur de secours n’a pas été transmise. Le message nomme la variable.
- **Une modification du modèle n’apparaît pas dans une campagne déjà créée** : la campagne est une copie. Modifie-la directement, ou recrée-la depuis le modèle.