---
title: Templates
description: Du contenu d'e-mail réutilisable pour vos campagnes, géré dans le tableau de bord ou avec l'API.
seo:
  title: Template email
ai:
  exclude: true
---

Un template est un contenu d'e-mail réutilisable : un objet, du HTML et une partie en texte brut facultative. Gardez-en un prêt pour votre prochaine [campagne](/docs/fr/concepts/broadcasts). Dans le tableau de bord, **Templates** vous permet d'en créer un dans l'éditeur de blocs ou d'écrire vous-même le HTML.

Dans l'éditeur de campagne, choisir un template copie son contenu comme point de départ. Modifier ou supprimer le template par la suite ne change pas les campagnes que vous avez déjà créées.

## Champs de fusion

Les templates peuvent contenir des valeurs propres à chaque contact :

```html
<p>Hi {{{FIRST_NAME|there}}},</p>
```

- `{{{FIRST_NAME}}}`, `{{{LAST_NAME}}}` et `{{{EMAIL}}}` sont intégrés. Tout autre nom lit la [propriété de contact](/docs/fr/concepts/contacts) du même nom.
- `{{{NAME|fallback}}}` utilise le texte de remplacement quand le contact n'a pas de valeur.
- `{{{UNSUBSCRIBE_URL}}}` devient le lien de désinscription propre à chaque destinataire. Voir [Désinscriptions](/docs/fr/concepts/unsubscribes).

## Éditeur de blocs et HTML

- Un template créé dans l'éditeur de blocs peut passer en HTML avec **Modifier en HTML**. Vous obtenez une copie ou vous le modifiez sur place. Tant que vous n'avez pas enregistré, **Retour aux blocs** rétablit les blocs.
- Un template créé avec `html` par l'API s'ouvre en mode HTML, et votre HTML est conservé exactement tel que vous l'avez écrit. Le convertir en blocs est votre choix, en copie ou sur place, et cela aplatit les mises en page à base de tableaux.
- En mode HTML, la partie en texte brut générée à partir du HTML continue de suivre vos modifications. Une partie en texte brut que vous définissez par l'API est envoyée telle qu'elle est enregistrée.

## Publication et versions

Par l’API, chaque enregistrement est en ligne : chaque `POST /templates` et chaque `PATCH /templates/{id}` publie une nouvelle version, donc `status` vaut toujours `published`, et `POST /templates/{id}/publish` ne fait rien et répond par un succès. Dans le tableau de bord, l’éditeur garde une copie de travail : vos modifications restent un brouillon tant que vous ne choisissez pas **Publier**, ce qui publie une nouvelle version. L’**Historique des versions** liste toutes les versions publiées, et **Restaurer comme brouillon** en ramène une comme copie de travail.

## API

Les SDK appellent les endpoints des templates sous la forme `templates.*`.

```bash
curl -X POST https://api.billionsend.com/templates \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome",
    "subject": "Welcome to Acme",
    "html": "<p>Hi {{{FIRST_NAME|there}}}</p>",
    "alias": "welcome"
  }'
```

- `POST /templates` accepte `name`, `html`, et en option `subject`, `text` et `alias`.
- `GET /templates` liste les templates, les plus récents d'abord. `GET /templates/{id}` renvoie le contenu complet.
- `PATCH /templates/{id}` modifie n'importe lequel des champs. Une chaîne vide ou `null` efface `subject` ou `text`. Écrire `html` ou `text` transforme un template de l'éditeur de blocs en template HTML.
- `DELETE /templates/{id}` le supprime.
- `POST /templates/{id}/duplicate` crée une copie nommée `<name> (copy)`, sans l'alias.

Un `alias` est composé de lettres, de chiffres, de `.`, de `_` et de `-`, sur 100 caractères au plus, et il est unique dans votre équipe. Toutes les routes ci-dessus acceptent l'alias à la place de l'identifiant. Un alias déjà pris répond `409`. Un alias qui ressemble à un UUID n'est pas autorisé.

## Non pris en charge

- `from`, `reply_to` et `variables` sur un template répondent `422`. Définissez l'expéditeur et l'adresse de réponse sur la campagne, et utilisez directement les champs de fusion : les propriétés de contact n'ont pas besoin d'être déclarées.
- Un identifiant de template ne peut pas être envoyé avec `POST /emails` ni `POST /broadcasts`. Envoyez vous-même `html` ou `text`. Le sélecteur de templates de l'éditeur de campagne en copie le contenu.
