Vue d’ensemble
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
- Créez un modèle dans Email MarketingTemplates ou via l’API. Donnez-lui un nom et un alias, comme
welcome-email. - Concevez le contenu dans l’un des trois éditeurs, avec des variables comme
{{first_name}}là où vont les informations personnelles. - 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.
- Envoyez-le. Appelez
POST /emailsavec"template": "welcome-email"et un objetvariables. Emailit effectue le rendu de la version publiée avec 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 | 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, remplies à partir de variables |
| Automatisations | 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 | 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 |
| Relais SMTP | Non disponible. SMTP envoie le message exactement tel que vous l’avez construit. | Aucune |
Ce que vous pouvez faire
API des modèles
Gérez les modèles depuis votre code avec l’API des modèles :
| Endpoint | Rôle |
|---|---|
| Créer un modèle | Ajoute un modèle ou une nouvelle version d’un alias existant. |
| Récupérer un modèle | Récupère une version, avec son contenu et la liste des autres versions. |
| Mettre à jour un modèle | Modifie les champs ou le contenu d’une version. |
| Lister les modèles | Liste la version publiée de chaque alias. |
| Publier un modèle | Fait d’une version la version en ligne de son alias. |
| Supprimer un modèle | 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.