Versões de templates

As versões permitem alterar um template sem mexer no código que o envia. Todas as versões de um template compartilham um alias, e no máximo uma delas fica publicada. Os envios pelo alias sempre usam a versão publicada, então você pode criar um redesign em rascunho, testá-lo e passar a usá-lo com um clique.

Como as versões funcionam

Todo template é uma versão com o seu próprio ID tem_, nome, assunto, endereço From, editor e conteúdo. As versões com o mesmo alias formam um grupo:

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

As mesmas regras valem para a etapa Send email das automações. No painel, a lista de templates mostra apenas a versão publicada de cada alias. Os rascunhos aparecem no painel Versions da página do template.

Criar uma nova versão

1. Abra o template. Acesse Email Marketing›Templates e selecione o template.

2. Comece uma versão. No painel Versions, selecione New Version.

3. Escolha a origem. Na caixa de diálogo Create New Version, escolha em Copy from a versão de partida e selecione Create Version. O Emailit copia o assunto, o From, o Reply-To, o editor e o conteúdo dela para um novo rascunho com o nome da origem, como Welcome email v3.

4. Edite o rascunho. Selecione Open Editor e faça as suas alterações. A versão publicada continua sendo enviada até você publicar o rascunho.

Uma nova versão também é criada sempre que você adiciona um template com um alias que já existe, seja com Add template, Duplicate Template, Import ou Save as template em uma campanha. O novo template é salvo como rascunho. As caixas de diálogo Add template, Duplicate Template e Save as template avisam com Alias already exists; Import não avisa.

Testar um rascunho

Envie o rascunho para você mesmo pelo ID tem_ dele antes de publicá-lo. Copie o ID na página do 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" }
  }'

Publicar uma versão

Publicar torna uma versão a versão ativa do alias dela. A versão que estava publicada antes vira rascunho, então apenas uma versão fica publicada por vez.

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'];

A publicação emite template.updated para a versão recém-publicada e para a versão que foi despublicada. Para reverter, publique de novo a versão anterior.

Editar ou excluir uma versão publicada

• As edições valem imediatamente. Salvar alterações na versão publicada muda, a partir desse momento, o que os envios pelo alias usam. O editor Dragit salva automaticamente enquanto você trabalha, então as alterações dele entram no ar à medida que você as faz. Para preparar alterações, crie uma nova versão.
• Excluir não promove outra versão. Se você excluir a versão publicada, o alias fica sem versão publicada, e os envios e as automações que usam o alias falham até você publicar outra. A exclusão remove apenas essa versão; as outras continuam.

Versões na API

Veja também

• Criar e editar templates
• Enviar com um template
• Referência da API de templates