Princip
Verze šablon
Verze sdílejí alias, takže můžete připravit, otestovat a publikovat nový design bez změny kódu. Jak funguje publikování ve webovém rozhraní a v API.
Díky verzím můžete šablonu změnit, aniž byste sahali na kód, který ji odesílá. Všechny verze šablony sdílejí jeden alias a publikovaná je nejvýše jedna z nich. Odeslání podle aliasu vždy použije publikovanou verzi, takže můžete připravit nový design, otestovat ho a jedním kliknutím na něj přepnout.
Jak verze fungují
Každá šablona je verze s vlastním ID tem_, názvem, předmětem, adresou odesílatele, editorem a obsahem. Verze se stejným aliasem tvoří skupinu:
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| Jak na šablonu odkazujete | Která verze se použije |
|---|---|
Alias, například "template": "welcome-email" |
Publikovaná verze. Pokud žádná publikovaná není, odeslání selže s 404 Template not found. |
ID tem_, například "template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh" |
Přesně tato verze, publikovaná nebo ne |
Stejná pravidla platí pro krok Send email v automatizacích. Ve webovém rozhraní seznam šablon ukazuje jen publikovanou verzi každého aliasu. Koncepty se zobrazují v panelu Versions na stránce šablony.
Vytvořte novou verzi
-
Otevřete šablonu. Přejděte do Email MarketingTemplates a vyberte šablonu.
-
Začněte verzi. V panelu Versions vyberte New Version.
-
Vyberte zdroj. V dialogovém okně Create New Version zvolte v poli Copy from verzi, od které chcete začít, a vyberte Create Version. Emailit zkopíruje její předmět, odesílatele, adresu pro odpověď, editor a obsah do nového konceptu pojmenovaného podle zdroje, například
Welcome email v3. -
Upravte koncept. Vyberte Open Editor a proveďte změny. Publikovaná verze se odesílá dál, dokud koncept nepublikujete.
Nová verze vznikne také pokaždé, když přidáte šablonu s aliasem, který už existuje, ať tlačítkem Add template, Duplicate Template, Import, nebo Save as template u kampaně. Nová šablona se uloží jako koncept. Dialogová okna Add template, Duplicate Template a Save as template vás upozorní hláškou Alias already exists; Import ne.
Otestujte koncept
Než koncept publikujete, pošlete ho sami sobě podle jeho ID tem_. ID zkopírujete ze stránky šablony.
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" }
}'Publikujte verzi
Publikováním se verze stane aktivní verzí svého aliasu. Verze, která byla publikovaná předtím, se stane konceptem, takže publikovaná je vždy jen jedna verze.
Otevřete koncept a vyberte Publish, nebo vyberte ikonu publikování vedle něj v panelu Versions. Dialogové okno Publish template upozorní, že publikování nahradí aktuální aktivní verzi. Potvrďte tlačítkem Publish.
Zavolejte endpoint Publikování šablony (POST /templates/{id}/publish) s ID tem_ verze a klíčem Full Access.
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'];Publikování vyvolá template.updated pro nově publikovanou verzi i pro verzi, jejíž publikování se zrušilo. K předchozí verzi se vrátíte tak, že ji znovu publikujete.
Upravte nebo smažte publikovanou verzi
- Úpravy platí okamžitě. Uložení změn publikované verze od té chvíle změní, co se odesílá podle aliasu. Editor Dragit ukládá automaticky během práce, takže jeho změny se projevují průběžně. Pokud chcete změny připravit předem, vytvořte místo toho novou verzi.
- Smazání nepovýší jinou verzi. Pokud publikovanou verzi smažete, alias nemá žádnou publikovanou verzi a odeslání a automatizace, které alias používají, budou selhávat, dokud nepublikujete jinou. Smazání odstraní jen tuto verzi; ostatní zůstanou.
Verze v API
| Akce | Chování |
|---|---|
| Vytvoření šablony s novým aliasem | Šablona se automaticky publikuje. |
| Vytvoření šablony s existujícím aliasem | Šablona se vytvoří jako nepublikovaná verze s published_at nastaveným na null. |
| Výpis šablon | Vrací jen publikované verze, jednu na alias, každou s total_versions. |
| Načtení šablony | Vrací verzi a navíc versions: ostatní verze aliasu s jejich id, name, published_at, created_at a updated_at, od nejnovější. |
| Úprava šablony | Změní pole verze, aniž by změnila, jestli je publikovaná. Změna aliasu na alias, který se už používá, selže s Alias already exists. |
| Publikování šablony | Publikuje tuto verzi a zruší publikování všech ostatních verzí aliasu. |
| Smazání šablony | Smaže jen tuto verzi. |