Créer et modifier des modèles

Cette page explique comment créer un modèle dans le tableau de bord ou via l’API, comment fonctionne chacun des trois éditeurs et comment gérer les modèles depuis la liste des modèles. Elle s’adresse à toute personne qui conçoit des e-mails, qu’elle code ou non.

Créer un modèle

1. Ouvrez Templates. Accédez à Email Marketing›Templates et sélectionnez Add template.

2. Nommez-le. Saisissez un Name, comme Welcome email. Emailit renseigne l’Alias à partir du nom, par exemple welcome-email.

3. Vérifiez l’alias. L’alias permet à votre code et à vos automatisations de faire référence au modèle. Il peut contenir des lettres minuscules, des chiffres, _ et -, jusqu’à 191 caractères. Si l’alias existe déjà, la boîte de dialogue affiche Alias already exists, et le nouveau modèle devient une version non publiée du modèle existant.

4. Choisissez un éditeur. Choisissez Dragit Editor (par défaut), HTML Editor ou Rich Text Editor. Vous ne pouvez pas faire passer un modèle existant à un autre éditeur dans le tableau de bord : choisissez celui que vous voulez garder.

5. Définissez les valeurs par défaut. Saisissez si vous le souhaitez un Subject, qui peut contenir des variables Temple, et une adresse From comme Acme <hello@acme.com>. Ce sont des valeurs par défaut qu’un envoi peut remplacer.

6. Créez et concevez. Sélectionnez Create. Le modèle s’ouvre dans son éditeur. Concevez le contenu, puis enregistrez.

Pour définir une adresse de réponse (Reply-To) ou un corps en texte brut distinct, utilisez l’API.

Créer un modèle via l’API

Appelez Créer un modèle avec une clé Full Access. editor peut valoir dragit, tiptap (Rich Text), html ou text, et vaut html par défaut.

curl https://api.emailit.com/v2/templates \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome email",
    "alias": "welcome-email",
    "editor": "html",
    "from": "Acme <hello@acme.com>",
    "reply_to": "support@acme.com",
    "subject": "Welcome to Acme, {{first_name|\"there\"}}",
    "html": "<p>Hi {{first_name|\"there\"}}, thanks for joining.</p>",
    "text": "Hi {{first_name|\"there\"}}, thanks for joining."
  }'

La réponse a le statut 201 et contient le modèle sous data. Si l’alias est nouveau, le modèle est publié immédiatement.

Choisir un éditeur

Éditeur Dragit

Dragit est un éditeur d’e-mails en glisser-déposer qui s’ouvre en plein écran.

• Faites glisser des blocs comme du texte, des images et des boutons dans la mise en page, et ajustez leur contenu et leurs styles.
• Importez des images avec le gestionnaire de fichiers intégré. Elles sont stockées dans votre espace de travail et servies depuis une URL hébergée.
• Insérez des variables depuis le menu des champs de fusion : First name, Last name, Email, et les champs personnalisés de vos contacts sous Custom fields. Le lien de désinscription est disponible comme type de lien spécial.
• Votre travail est enregistré automatiquement au fil de vos modifications. Fermez l’éditeur pour revenir à la page du modèle.

Les modèles Dragit conservent leur design en JSON Dragit en plus du HTML : vous pouvez donc exporter le JSON et l’importer dans un autre espace de travail. Consultez Importer et exporter.

Éditeur de texte enrichi

L’éditeur Rich Text s’ouvre en plein écran avec une barre d’outils de mise en forme : annuler et rétablir, titres de niveau 1 à 3, listes à puces et numérotées, citations, gras, italique, souligné, barré, liens et alignement du texte.

• Sélectionnez le bouton Variables (l’icône @) dans la barre d’outils pour insérer une variable à l’emplacement du curseur.
• Saisissez le Preview text en haut pour définir la ligne que les boîtes de réception affichent après l’objet. Emailit l’ajoute sous forme de texte masqué au début de l’e-mail.
• Sélectionnez Save pour conserver vos modifications. À l’enregistrement, Emailit applique une police sans empattement à chaque élément pour que l’e-mail s’affiche de façon homogène dans les clients de messagerie.

Éditeur HTML

L’éditeur HTML affiche votre code, avec numéros de ligne et coloration syntaxique, ainsi qu’un aperçu en direct. Basculez l’aperçu entre Desktop et Mobile. Sous l’aperçu, Available variables liste les variables que vous pouvez saisir dans votre HTML. Sélectionnez Save pour conserver vos modifications.

L’aperçu affiche les variables telles qu’elles sont écrites. Il n’effectue pas le rendu des conditions Temple et ne remplit pas les valeurs.

Variables dans les éditeurs

Les trois éditeurs proposent les mêmes variables :

Le remplissage dépend du mode d’envoi du modèle :

• Les campagnes les remplissent toutes à partir de la fiche du contact destinataire, et {{unsubscribe_url}} avec son lien de désinscription. Consultez Balises de fusion des campagnes.
• Les envois via l’API ne remplissent que ce que vous transmettez dans variables, sous les mêmes noms. Pour {{cf.plan}}, transmettez "variables": { "cf": { "plan": "Pro" } }. Tout ce que vous ne transmettez pas reste vide.
• Les automatisations de contact remplissent {{first_name}}, {{last_name}} et {{email}} à partir du contact. Les champs personnalisés sont disponibles sous la forme {{custom_fields.<key>}}, et {{unsubscribe_url}} n’est pas rempli.

Pour les règles complètes, consultez Temple.

Gérer les modèles

Email Marketing›Templates affiche une carte par alias, avec un aperçu, le nom, l’alias, un badge d’éditeur et le nombre de versions. Seule la version publiée de chaque alias apparaît dans la grille. Retrouvez les brouillons dans le panneau Versions de la page du modèle.

• Recherchez par nom ou par alias.
• Triez par Newest first, Oldest first, Recently updated, Recently published, Name A-Z ou Name Z-A.
• Filtrez par éditeur.
• Sélectionnez Import pour ajouter un modèle à partir d’un fichier. Consultez Importer et exporter.

Le menu de chaque carte propose ces actions :

La page d’un modèle

Sélectionnez une carte pour ouvrir la page du modèle. Elle affiche le statut (Published ou Draft), l’alias, l’éditeur, la date de création, le nom, l’objet, From, Reply-To et l’ID, un aperçu et le panneau Versions.

• Publish apparaît sur les versions en brouillon et fait de cette version la version en ligne de l’alias.
• Open Editor ouvre le contenu dans l’éditeur du modèle.
• Le menu propose Edit (modifier le nom, l’alias, l’objet et From), Duplicate Template, les options d’export et Delete.
• New Version, dans le panneau Versions, copie une version existante dans un nouveau brouillon. Consultez Versions de modèle.

Voir aussi

• Versions de modèle
• Langage de templates Temple
• Référence de l’API des modèles
• Champs personnalisés