Versioni dei template

Le versioni ti permettono di modificare un template senza toccare il codice che lo invia. Tutte le versioni di un template condividono un alias, e al massimo una di esse è pubblicata. Gli invii tramite alias usano sempre la versione pubblicata, quindi puoi preparare un nuovo design, provarlo e passarci con un clic.

Come funzionano le versioni

Ogni template è una versione con il proprio ID tem_, nome, oggetto, indirizzo From, editor e contenuto. Le versioni con lo stesso alias formano un gruppo:

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

Le stesse regole valgono per il passaggio Send email delle automazioni. Nel pannello, l’elenco dei template mostra solo la versione pubblicata di ogni alias. Le bozze compaiono nel pannello Versions della pagina del template.

Crea una nuova versione

1. Apri il template. Vai a Email Marketing›Templates e seleziona il template.

2. Avvia una versione. Nel pannello Versions, seleziona New Version.

3. Scegli l’origine. Nella finestra Create New Version, scegli in Copy from la versione da cui partire, poi seleziona Create Version. Emailit copia oggetto, From, Reply-To, editor e contenuto in una nuova bozza con il nome dell’origine, ad esempio Welcome email v3.

4. Modifica la bozza. Seleziona Open Editor e apporta le modifiche. La versione pubblicata continua a essere inviata finché non pubblichi la bozza.

Una nuova versione viene creata anche ogni volta che aggiungi un template con un alias già esistente, che sia con Add template, Duplicate Template, Import o Save as template su una campagna. Il nuovo template viene salvato come bozza. Le finestre Add template, Duplicate Template e Save as template ti avvisano con Alias already exists; Import no.

Prova una bozza

Prima di pubblicarla, invia la bozza a te stesso tramite il suo ID tem_. Copia l’ID dalla pagina del template.

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" }
  }'

Pubblica una versione

La pubblicazione rende una versione quella attiva per il suo alias. La versione pubblicata in precedenza diventa una bozza, quindi c’è sempre una sola versione pubblicata.

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 pubblicazione genera template.updated per la versione appena pubblicata e per quella ritirata. Per tornare indietro, pubblica di nuovo la versione precedente.

Modifica o elimina una versione pubblicata

• Le modifiche sono subito attive. Salvare modifiche alla versione pubblicata cambia da quel momento ciò che usano gli invii tramite alias. L’editor Dragit salva automaticamente mentre lavori, quindi le sue modifiche diventano attive man mano che le fai. Per preparare le modifiche senza pubblicarle, crea invece una nuova versione.
• L’eliminazione non promuove un’altra versione. Se elimini la versione pubblicata, l’alias resta senza versione pubblicata, e gli invii e le automazioni che usano l’alias non riescono finché non ne pubblichi un’altra. L’eliminazione rimuove solo quella versione; le altre restano.

Le versioni nell’API

Vedi anche

• Crea e modifica i template
• Invia con un template
• Riferimento dell’API dei template