Versions de modèle

Les versions vous permettent de modifier un modèle sans toucher au code qui l’envoie. Toutes les versions d’un modèle partagent un même alias, et une seule d’entre elles au plus est publiée. Les envois par alias utilisent toujours la version publiée : vous pouvez donc préparer une refonte en brouillon, la tester, puis y passer en un clic.

Fonctionnement des versions

Chaque modèle est une version qui possède son propre ID tem_, son nom, son objet, son adresse d’expéditeur, son éditeur et son contenu. Les versions qui partagent le même alias forment un groupe :

welcome-email
├── Welcome email v3   tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh   Draft
├── Welcome email v2   tem_33Vd8Hq3Ws5NzK1xR7cM2pLbYte   Published   ← sends by alias use this one
└── Welcome email      tem_33TfB6yN4qJ8kV2mX9wR1cHsDua   Draft

Les mêmes règles s’appliquent à l’étape Send email des automatisations. Dans le tableau de bord, la liste des modèles n’affiche que la version publiée de chaque alias. Les brouillons apparaissent dans le panneau Versions de la page du modèle.

Créer une nouvelle version

1. Ouvrez le modèle. Accédez à Email Marketing›Templates et sélectionnez le modèle.

2. Lancez une version. Dans le panneau Versions, sélectionnez New Version.

3. Choisissez la source. Dans la boîte de dialogue Create New Version, choisissez sous Copy from la version de départ, puis sélectionnez Create Version. Emailit copie son objet, son adresse From, son adresse Reply-To, son éditeur et son contenu dans un nouveau brouillon nommé d’après la source, par exemple Welcome email v3.

4. Modifiez le brouillon. Sélectionnez Open Editor et apportez vos modifications. La version publiée continue d’être envoyée jusqu’à ce que vous publiiez le brouillon.

Une nouvelle version est aussi créée chaque fois que vous ajoutez un modèle dont l’alias existe déjà, que ce soit avec Add template, Duplicate Template, Import ou Save as template sur une campagne. Le nouveau modèle est enregistré comme brouillon. Les boîtes de dialogue Add template, Duplicate Template et Save as template vous avertissent avec Alias already exists ; Import ne le fait pas.

Tester un brouillon

Envoyez-vous le brouillon par son ID tem_ avant de le publier. Copiez l’ID depuis la page du modèle.

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "you@acme.com",
    "template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh",
    "variables": { "first_name": "Ada", "plan": "Pro" }
  }'

Publier une version

Publier une version en fait la version en ligne de son alias. La version publiée jusque-là redevient un brouillon : une seule version est donc publiée à la fois.

curl -X POST https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

const res = await fetch(
  'https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish',
  { method: 'POST', headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` } },
);
const { data } = await res.json();

import os
import requests

res = requests.post(
    "https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
template = res.json()["data"]

$ch = curl_init('https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$template = json_decode(curl_exec($ch), true)['data'];

La publication émet template.updated pour la version nouvellement publiée et pour la version dépubliée. Pour revenir en arrière, publiez de nouveau la version précédente.

Modifier ou supprimer une version publiée

• Les modifications sont en ligne immédiatement. Enregistrer des modifications sur la version publiée change, dès cet instant, ce qu’utilisent les envois par alias. L’éditeur Dragit enregistre automatiquement pendant que vous travaillez : ses modifications sont donc en ligne au fur et à mesure. Pour préparer des modifications sans les publier, créez plutôt une nouvelle version.
• La suppression ne publie pas une autre version. Si vous supprimez la version publiée, l’alias n’a plus de version publiée, et les envois et automatisations qui utilisent l’alias échouent jusqu’à ce que vous en publiiez une autre. La suppression ne retire que cette version ; les autres restent.

Les versions dans l’API

Voir aussi

• Créer et modifier des modèles
• Envoyer avec un modèle
• Référence de l’API des modèles