# Modèles

> Concevez un e-mail une fois et réutilisez-le dans les envois via l’API, les automatisations et les campagnes. Alias, versions, trois éditeurs, variables Temple et API des modèles.

Un modèle stocke l’objet, les informations d’expéditeur et le contenu d’un e-mail pour que vous puissiez le concevoir une fois et le réutiliser. Créez des modèles dans le tableau de bord avec un éditeur glisser-déposer, de texte enrichi ou HTML, ou gérez-les via l’API, puis envoyez-les par leur alias en renseignant les informations personnelles au moment de l’envoi.

## Fonctionnement

1. **Créez un modèle** dans **Email Marketing → Templates** ou via l’API. Donnez-lui un nom et un alias, comme `welcome-email`.
2. **Concevez le contenu** dans l’un des trois éditeurs, avec des variables comme `{{first_name}}` là où vont les informations personnelles.
3. **Publiez-le.** Le premier modèle portant un nouvel alias est publié automatiquement. Les modèles ajoutés plus tard avec le même alias deviennent des versions en brouillon, que vous publiez quand elles sont prêtes.
4. **Envoyez-le.** Appelez `POST /emails` avec `"template": "welcome-email"` et un objet `variables`. Emailit effectue le rendu de la version publiée avec [Temple](/fr/docs/templates/temple/) et l’envoie.

Comme votre code fait référence à l’alias plutôt qu’à un modèle précis, vous pouvez modifier le design et publier une nouvelle version sans déployer de code.

## Contenu d’un modèle

| Champ | Détails |
| --- | --- |
| Nom | Un libellé pour votre équipe, jusqu’à 191 caractères. |
| Alias | L’identifiant qu’utilise votre code, jusqu’à 191 caractères parmi `a–z`, `0–9`, `_` et `-`. Toutes les versions d’un modèle partagent le même alias. |
| Éditeur | **Dragit** (glisser-déposer), **Rich Text** ou **HTML**. |
| Objet | La ligne d’objet par défaut, jusqu’à 191 caractères. Elle peut contenir des variables. |
| From | L’expéditeur par défaut, comme `Acme <hello@acme.com>`. |
| Reply-To | Une ou plusieurs adresses de réponse, facultatives. |
| Contenu | Le corps HTML, un corps en texte brut facultatif (via l’API) et, pour les modèles Dragit, le design en JSON Dragit. |

## Où utiliser les modèles

| Emplacement | Utilisation du modèle | Variables |
| --- | --- | --- |
| [API e-mail](/fr/docs/email-api/send-email/#send-with-a-template) | `template` accepte un alias (version publiée) ou un ID `tem_` (cette version précise). L’objet, le HTML, le texte et Reply-To proviennent du modèle, sauf si la requête les remplace. Le `from` de la requête est toujours obligatoire. | [Temple](/fr/docs/templates/temple/), remplies à partir de `variables` |
| [Automatisations](/fr/docs/automations/steps/) | L’étape **Send email** envoie un modèle. Le From, l’objet et le Reply-To du modèle sont utilisés, sauf si l’étape les remplace. | Temple, remplies à partir du contact et du déclencheur |
| [Campagnes](/fr/docs/campaigns/create/) | **Choose from templates** copie le contenu d’un modèle dans la campagne comme point de départ. **Save as template** transforme une campagne en modèle. | [Balises de fusion des campagnes](/fr/docs/campaigns/merge-tags/) |
| [Relais SMTP](/fr/docs/smtp/) | Non disponible. SMTP envoie le message exactement tel que vous l’avez construit. | Aucune |

## Ce que vous pouvez faire

  - [Éditeurs](/fr/docs/templates/editors/): Créez des modèles et concevez-les avec Dragit, Rich Text ou HTML.
  - [Langage Temple](/fr/docs/templates/temple/): Variables, valeurs par défaut et conditions, et où leur rendu est effectué.
  - [Versions](/fr/docs/templates/versions/): Préparez une nouvelle version sous le même alias et publiez-la quand elle est prête.
  - [Import et export](/fr/docs/templates/import-export/): Importez du JSON Dragit, du HTML ou des paquets ZIP, et exportez-les de nouveau.

## API des modèles

Gérez les modèles depuis votre code avec l’[API des modèles](/fr/docs/api-reference/templates/) :

| Endpoint | Rôle |
| --- | --- |
| [Créer un modèle](/fr/docs/api-reference/templates/create/) | Ajoute un modèle ou une nouvelle version d’un alias existant. |
| [Récupérer un modèle](/fr/docs/api-reference/templates/get/) | Récupère une version, avec son contenu et la liste des autres versions. |
| [Mettre à jour un modèle](/fr/docs/api-reference/templates/update/) | Modifie les champs ou le contenu d’une version. |
| [Lister les modèles](/fr/docs/api-reference/templates/list/) | Liste la version publiée de chaque alias. |
| [Publier un modèle](/fr/docs/api-reference/templates/publish/) | Fait d’une version la version en ligne de son alias. |
| [Supprimer un modèle](/fr/docs/api-reference/templates/delete/) | Supprime une version. |

L’API nécessite une clé **Full Access**. Les modifications émettent les événements webhook `template.created`, `template.updated` et `template.deleted`. L’import et l’export de fichiers ne sont disponibles que dans le tableau de bord.

## Disponibilité

Les modèles sont disponibles sur tous les forfaits sans frais supplémentaires. Le stockage des modèles ne consomme pas de crédits ; chaque e-mail envoyé avec un modèle est facturé comme tout autre envoi.

## Pour commencer

  - [Créer un modèle](/fr/docs/templates/editors/#create-a-template): Définissez le nom, l’alias et l’éditeur, puis concevez le modèle.
  - [Envoyer avec un modèle](/fr/docs/email-api/send-email/#send-with-a-template): Envoyez par alias avec des variables depuis votre code.

---
Source: https://emailit.com/fr/docs/templates/