Pular para o conteúdo
Docs

Visão geral

Desenhe um e-mail uma vez e reutilize-o em envios pela API, automações e campanhas. Aliases, versões, três editores, variáveis do Temple e a API de templates.

Atualizado em 1 de out. de 2026

Um template guarda o assunto, os dados do remetente e o conteúdo de um e-mail para que você o desenhe uma vez e o reutilize. Crie templates no painel com um editor de arrastar e soltar, de texto formatado ou HTML, ou gerencie-os pela API, e depois envie-os pelo alias, preenchendo os dados pessoais no momento do envio.

Como funciona

  1. Crie um template em Email MarketingTemplates ou com a API. Dê a ele um nome e um alias, como welcome-email.
  2. Desenhe o conteúdo em um dos três editores, com placeholders como {{first_name}} onde entram os dados pessoais.
  3. Publique-o. O primeiro template com um alias novo é publicado automaticamente. Os templates que você adicionar depois com o mesmo alias viram versões em rascunho, que você publica quando estiverem prontas.
  4. Envie-o. Chame POST /emails com "template": "welcome-email" e um objeto variables. O Emailit renderiza a versão publicada com o Temple e a envia.

Como o seu código se refere ao alias, e não a um template específico, você pode alterar o design e publicar uma nova versão sem fazer deploy de código.

O que um template contém

Campo Detalhes
Nome Um rótulo para a sua equipe, com até 191 caracteres.
Alias O identificador que o seu código usa, com até 191 caracteres entre a–z, 0–9, _ e -. Todas as versões de um template compartilham um alias.
Editor Dragit (arrastar e soltar), Rich Text ou HTML.
Assunto A linha de assunto padrão, com até 191 caracteres. Pode conter placeholders.
From O remetente padrão, como Acme <hello@acme.com>.
Reply-To Um ou mais endereços de resposta opcionais.
Conteúdo O corpo HTML, um corpo em texto simples opcional (pela API) e, nos templates do Dragit, o design como JSON do Dragit.

Onde você pode usar templates

Onde Como usa o template Placeholders
API de e-mail template recebe um alias (versão publicada) ou um ID tem_ (exatamente essa versão). Assunto, HTML, texto e Reply-To vêm do template, a menos que a requisição os substitua. O from da requisição é sempre obrigatório. Temple, preenchido a partir de variables
Automações A etapa Send email envia um template. O From, o assunto e o Reply-To do template são usados, a menos que a etapa os substitua. Temple, preenchido a partir do contato e do gatilho
Campanhas Choose from templates copia o conteúdo de um template para a campanha como ponto de partida. Save as template transforma uma campanha em template. Tags de mesclagem de campanhas
SMTP relay Não disponível. O SMTP envia a mensagem exatamente como você a montou. Nenhum

O que você pode fazer

Crie templates e desenhe-os com o Dragit, o Rich Text ou o HTML.
Variáveis, valores padrão e condicionais, e onde eles são renderizados.
Crie uma nova versão em rascunho com o mesmo alias e publique-a quando estiver pronta.
Traga JSON do Dragit, HTML ou pacotes ZIP e exporte-os de novo.

API de templates

Gerencie templates pelo código com a API de templates:

Endpoint Finalidade
Criar um template Adicionar um template ou uma nova versão de um alias existente.
Obter um template Obter uma versão, incluindo o conteúdo dela e a lista das outras versões.
Atualizar um template Alterar os campos ou o conteúdo de uma versão.
Listar templates Listar a versão publicada de cada alias.
Publicar um template Tornar uma versão a versão ativa do alias dela.
Excluir um template Excluir uma versão.

A API exige uma chave Full Access. As alterações emitem os eventos de webhook template.created, template.updated e template.deleted. A importação e a exportação de arquivos estão disponíveis apenas no painel.

Disponibilidade

Os templates estão disponíveis em todos os planos, sem custo adicional. Guardar templates não usa créditos; cada e-mail que você envia com um template é cobrado como qualquer outro envio.

Primeiros passos

Defina o nome, o alias e o editor e desenhe o template.
Envie pelo alias com variáveis a partir do seu código.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.