Templates
Os modelos de e-mail: a lista, o editor visual, as variáveis, o HTML e a prévia.
Para que serve
Um template é um e-mail montado uma vez e enviado quantas vezes você quiser, só trocando as variáveis (nome, número do pedido, link). A tela tem três abas: os seus Templates, os Modelos (layouts prontos para começar) e as Famílias (conjuntos de e-mails de um produto no mesmo estilo). O editor tem um modo visual, com blocos e edição direto no texto, e um modo HTML.
Quando usar: Para e-mails que se repetem (confirmação de pedido, código de acesso, boas-vindas), para deixar o time desenhar e-mails sem programar e para começar uma campanha de um layout pronto.
#Lista de templates
Onde fica: E-mails › Templates. Endereço: app.postal.so/templates.
Cabeçalho
| Item | O que faz |
|---|---|
| Ver código | Mostra como enviar com um template pela API: POST /emails com template: { id, variables }. Veja Templates (API). |
| Criar template | Cria na hora um template em rascunho, chamado Sem título, com um e-mail de exemplo e a variável NAME, e abre o editor. |
Aba Templates
| Item | O que faz |
|---|---|
| Buscar por nome ou alias | Procura nos nomes e nos aliases dos templates. |
| Filtros › Status | Publicados ou Rascunhos (Todos os status limpa). Veja como o botão Filtros funciona. |
| Coluna | O que mostra |
|---|---|
| Nome | O nome do template (link que abre o editor). |
| Status | Rascunho: nunca foi publicado e ainda não serve para enviar. Publicado: a versão publicada está em dia com o editor. Publicado · com alterações: você mudou o rascunho depois da última publicação; os envios continuam usando a versão publicada. |
| Alias | Um apelido (por exemplo, pedido-confirmado) que pode ser usado no lugar do ID no envio. |
| Atualizado | Há quanto tempo o template mudou. |
| Menu da linha | Editar; Duplicar (cria uma cópia em rascunho e abre); Excluir (os envios que usam o template passam a falhar, e o painel pede a confirmação). |
Os templates não têm um prazo de validade: ficam até você excluí-los. Quando a lista está vazia, o estado vazio explica o fluxo e oferece Criar template.
Dica
Dê aliases fáceis de lembrar e estáveis. Quem integra pela API usa o alias, e o time pode refazer o desenho do e-mail sem mexer no código.
#Modelos e famílias
Duas abas ajudam a não começar do zero. Elas ficam na própria tela Templates (a aba escolhida vai no endereço da página).
Aba Modelos
Tem duas visões, Galeria e Meus modelos, e a busca Buscar modelos.
| Visão | O que é |
|---|---|
| Galeria | Layouts prontos organizados por categoria (Boas-vindas, Newsletter, Promoção, Produto, E-commerce, Transacional, Aviso, Evento, Onboarding, Reengajamento, Feedback, Datas especiais, Conteúdo e Serviços). Cada cartão tem uma miniatura. Ver prévia abre o modelo em tamanho real; Usar modelo cria um template novo a partir dele e abre o editor. |
| Meus modelos | Os layouts que o seu time salvou com Salvar como modelo, no editor de um template ou de uma campanha. Ficam disponíveis para todo o time. O menu de cada um tem Editar detalhes (nome, descrição e categoria), Duplicar e Excluir (os templates criados a partir dele não mudam). O número de modelos salvos depende do plano. |
Aba Famílias
Uma família é um conjunto completo de 15 e-mails que um produto costuma enviar (boas-vindas, confirmação de e-mail, código de acesso, link mágico, redefinição de senha, alerta de segurança, convite para o time, assinatura confirmada, plano alterado, pagamento não aprovado, teste grátis terminando, recibo, novidade do produto, atualização do produto e texto simples), todos no mesmo estilo. Há dez famílias, de Essencial a Pulso.
| Item | O que faz |
|---|---|
| Aplicar sua marca | Abre Sua marca: Logo, Nome da empresa, Cor principal, Fonte, Endereço do rodapé e Link de suporte. Vale para todas as famílias e fica salvo neste navegador. Restaurar padrão desfaz. |
| Ver família | Mostra os e-mails da família. A prévia tem Computador e Celular, Modo escuro (simula aplicativos que invertem as cores), Ver código HTML (com Copiar HTML) e a lista de Variáveis do template de cada e-mail, com o alias sugerido e quais são obrigatórias. |
| Usar esta família | Cria um template para cada e-mail marcado, já com alias, assunto, pré-cabeçalho e variáveis. Em Usar a família ... você marca os e-mails (Marcar todos / Desmarcar todos) e decide Publicar ao criar (desligado, os templates ficam em rascunho). Se um alias já existir, escolha por e-mail entre Substituir (troca o conteúdo e mantém o histórico de versões), Criar com sufixo e Pular. |
| Usar só este | Cria um único template a partir de um e-mail da família. |
No fim, a tela de sucesso lista os templates criados e mostra o código para enviar cada um. Quando a família foi publicada ao criar, já dá para enviar pela API com o alias de cada template.
#Editor visual
Onde fica: E-mails › Templates, clicando num template. Endereço: app.postal.so/templates.
O editor abre no modo Visual quando o template foi feito com ele. À esquerda fica a tela do e-mail, desenhada com o mesmo HTML que o destinatário vai receber, e o texto é editado direto nela. À direita fica o painel de propriedades.
Cabeçalho e campos do template
| Item | O que faz |
|---|---|
| Nome do template | O campo grande no topo. Ao lado dele, o selo do estado: Alterações não salvas, Rascunho, Publicado ou Publicado, com alterações não publicadas. |
| Escrever com IA | Abre Sobre o que é o e-mail?: descreva o e-mail, escolha o Tom (Profissional, Amigável, Formal, Descontraído ou Persuasivo) e o Idioma e clique em Gerar e-mail. O assunto e o conteúdo atuais são substituídos (dá para descartar sem salvar). Usa 1 crédito de IA. |
| Ver código | Como enviar com este template pela API. |
| Salvar como modelo | Guarda o layout em Meus modelos para reaproveitar. |
| Versões | O botão com o relógio abre as Versões publicadas: cada publicação gera uma versão, a em uso aparece com Em uso, e Restaurar copia a versão escolhida para o rascunho (depois, publique para os envios passarem a usá-la). |
| Testar | Envia o rascunho salvo para endereços reais. Veja Testar e publicar. |
| Salvar | Grava o rascunho (atalho Ctrl/Cmd + S). Fica ativo só quando há alterações. |
| Publicar | Salva, se preciso, e publica uma versão nova: é a versão publicada que os envios por API usam. |
| De | O remetente padrão. Pode ser trocado no envio. Tem de ser de um domínio verificado. |
| Assunto | Aceita variáveis, como Seu pedido {{{ORDER_ID}}} foi confirmado. O botão com as faíscas, Sugerir assuntos com IA, propõe opções a partir do conteúdo (precisa de texto escrito antes; gasta 1 crédito) e Gerar outras traz mais. |
| Responder para (opcional) | Para onde vão as respostas dos destinatários. |
| Alias (opcional) | Apelido para enviar com { id: 'alias' } no lugar do ID. Só aceita letras minúsculas, números e . _ -. |
Blocos
O e-mail é feito de blocos, empilhados de cima para baixo. Para inserir um, passe o mouse entre dois blocos e clique no + (Inserir bloco aqui), ou digite / numa linha de texto vazia (veja o menu /). Numa tela vazia, o botão Comece inserindo um bloco faz o mesmo. O painel lateral mostra os blocos em cinco grupos:
| Grupo | Blocos |
|---|---|
| Texto | Título, Texto, Botão, Lista, Depoimento e Rodapé. |
| Estrutura | Cabeçalho (logo e links), Destaque (título, texto, imagem e botão), Colunas, Divisor e Espaço. |
| Mídia | Imagem, Vídeo (uma miniatura que abre o vídeo no navegador) e Redes sociais. |
| Vendas | Produto, Cupom, Tabela e Prazo (um texto fixo como "A oferta termina em 29/11 às 23h59"). |
| Avançado | HTML: um pedaço de HTML seu dentro do layout. |
Clique num bloco para selecioná-lo: aparece o nome dele no canto e uma barra com Mover para cima, Mover para baixo, Duplicar bloco e Remover bloco. Dentro de uma coluna há também Mover para a coluna anterior e Mover para a próxima coluna. O bloco de Colunas não pode ficar dentro de outras colunas.
O painel da direita mostra as propriedades do bloco selecionado: o Conteúdo (textos, imagem, links, itens), o Layout (alinhamento, tamanho) e as opções de seção (Fundo da seção, Cor do texto, Espaçamento interno (px), Cantos arredondados (px), Ocultar no celular e Ocultar no computador). Os campos de link aceitam variáveis, como https://lojaexemplo.com.br/pedidos/{{{ORDER_ID}}}.
Estilo da página
Com nenhum bloco selecionado, o painel mostra o Estilo da página, que vale para o e-mail todo:
| Campo | O que faz |
|---|---|
| Texto de pré-visualização | O trecho que aparece ao lado do assunto na caixa de entrada (o pré-cabeçalho). |
| Fonte | Sistema, Helvetica / Arial, Georgia, Verdana, Trebuchet ou Monoespaçada. São fontes que os aplicativos de e-mail já têm. |
| Cores | Fundo, Conteúdo, Texto, Títulos, Links, Botão e Texto do botão. |
| Medidas | Largura (de 480 a 720 px), Cantos, Margem lateral e Cantos dos botões. |
| Restaurar estilo padrão | Volta o estilo ao original. |
O menu "/"
Num bloco de Texto vazio, digite / (o campo mostra a dica Digite / para inserir um bloco). Abre o menu Inserir bloco com os cinco grupos acima; escolha um e ele substitui a linha vazia. Em uma coluna, o menu aparece com Inserir na coluna N. Um / no meio de um texto escrito é só uma barra. Para fechar sem inserir, use o X do menu.
Variáveis no texto: o menu "{" e os chips
Em qualquer texto do e-mail (título, texto, rodapé, destaque), digite { e uma lista de Variáveis aparece junto do cursor, com o aviso de quantas estão disponíveis. Continue digitando para filtrar (começam com as letras primeiro, depois as que contêm), use as setas para cima e para baixo, Enter ou Tab para escolher e Esc para fechar. Clicar numa opção também serve.
- A variável escolhida vira um chip: uma "pílula" com o nome, como
{{{NAME}}}. O chip não se edita por dentro; o cursor passa por ele, e uma só tecla Backspace ou Delete apaga a variável inteira. Cortar e colar leva a variável junto. - O que fica salvo no e-mail é só o texto
{{{NAME}}}: o chip existe só enquanto você edita. Digitar o nome completo ({{{NAME}}}) também vira chip sozinho, se a variável existe. Nomes que não existem (erro de digitação) e variáveis com valor padrão ({{{NAME|cliente}}}) ficam como texto comum. - A lista traz as variáveis do próprio template primeiro e depois as que a Postal já conhece:
FIRST_NAME,LAST_NAME,EMAIL,POSTAL_UNSUBSCRIBE_URL,NAMEeCOMPANY. - Para pôr uma variável sobre um texto que já existe, selecione o texto e use Inserir variável na barra flutuante (a chave
{ }).
A barra flutuante do texto
Ao selecionar um trecho de texto, uma barra aparece acima dele, sem tirar o cursor do lugar:
| Botão | O que faz |
|---|---|
| Negrito, Itálico, Sublinhado, Tachado | Aplicam e tiram a formatação. Atalhos: Ctrl/Cmd + B, I, U e Shift + X. O botão acende quando o trecho já tem a formatação. |
| Link | Troca a barra por um campo de endereço (atalho Ctrl/Cmd + K). Confirme com o visto ou Enter; Remover link tira; Esc cancela. "lojaexemplo.com.br" vira https://lojaexemplo.com.br e "[email protected]" vira mailto:. Só são aceitos http, https, mailto e tel; qualquer outro tipo mostra Esse tipo de endereço não é permitido. |
| Inserir variável | Abre a lista de variáveis para o trecho selecionado. |
| Limpar formatação | Tira o negrito, o itálico e o resto do trecho selecionado. |
A barra flutuante da imagem
Ao selecionar um bloco que tem imagem (Imagem, Destaque com imagem, Produto, Cabeçalho com logo, Vídeo e Depoimento com foto), uma barra aparece sobre a figura:
| Botão | O que faz |
|---|---|
| Substituir imagem / Adicionar imagem | Abre o seletor de arquivos e envia a nova imagem (PNG, JPG ou WebP; fotos grandes são reduzidas sozinhas; GIFs animados são enviados como estão, com limite de tamanho). O mesmo envio existe no painel lateral. |
| Link da imagem | Define para onde a imagem leva ao ser clicada. Segue as mesmas regras de endereço do link do texto. |
| Editar texto alternativo | O texto que aparece quando o aplicativo bloqueia imagens e que leitores de tela leem. Um pontinho de aviso lembra quando ele está vazio. |
| Remover imagem | Tira a imagem do bloco. |
Dica
Escreva o texto alternativo de toda imagem importante: muitos aplicativos bloqueiam imagens por padrão, e e-mails só com imagem têm mais chance de cair no spam.
#Variáveis
Uma variável é um espaço do e-mail que muda a cada envio. Escreva-a entre três chaves, como {{{NOME}}}, no assunto, no texto e nos links. As variáveis são detectadas sozinhas e aparecem no cartão Variáveis, embaixo do editor.
| Campo | O que é |
|---|---|
| Nome | Letras, números e sublinhado (por exemplo, ORDER_ID). Tudo em maiúsculas é só uma convenção. |
| Tipo | Texto ou Número. |
| Valor padrão | O que vale quando o envio não informa a variável. Sem valor padrão, a variável é obrigatória no envio (a API devolve erro se faltar). |
Quem envia informa os valores na chamada: template: { id: 'pedido-confirmado', variables: { ORDER_ID: '10482' } }. Um template novo já vem com a variável NAME (valor padrão "cliente"). Se você apagar todas as ocorrências de uma variável do e-mail, ela some do cartão; as configurações de tipo e de valor padrão das que continuam em uso são mantidas.
Dica
Nas campanhas e automações, FIRST_NAME, LAST_NAME, EMAIL e POSTAL_UNSUBSCRIBE_URL são preenchidas pela própria Postal com os dados do contato. Num envio transacional com template, você mesmo informa todas.
Veja também: Templates (API) · Enviar e-mail · Personalização em campanhas.
#Editor HTML
A aba HTML tem dois comportamentos, conforme o template:
| Situação | O que a aba mostra |
|---|---|
| Template feito no editor visual | Mostra o HTML gerado, só para leitura, para você copiar ou conferir. O botão Editar HTML manualmente passa o template para o modo HTML: o editor visual deixa de ser usado nele (o painel pede confirmação, porque a volta começa um layout novo). |
| Template em HTML | Mostra os campos HTML (use {{{NOME}}} para variáveis) e Versão em texto (opcional). Deixando a versão em texto vazia, a Postal gera uma a partir do HTML. O botão Usar editor visual começa um layout novo e substitui o HTML atual (com confirmação, se já houver HTML). |
Dica
Prefira o HTML quando você já tem um e-mail pronto (de uma agência ou de outro sistema). Tem a versão em texto? Mantenha-a: alguns filtros de spam penalizam e-mails só com HTML.
Veja também: Criar template pela API.
#Prévia
A aba Prévia mostra o e-mail como ele sai, em um quadro isolado. Os botões Desktop e Celular trocam a largura (o celular simula 375 px). As variáveis aparecem com o valor padrão que você definiu; as que não têm valor padrão aparecem como o próprio marcador, por exemplo {{{NOME}}}.
A prévia mostra o que está no editor agora, sem precisar salvar. Para ver o e-mail chegando de verdade, use o Testar.
#Testar e publicar
Testar
Testar abre Enviar e-mail de teste. Ele envia o rascunho salvo, com [Teste] no assunto (com alterações não salvas, o botão pede Salve antes de testar). Preencha:
| Campo | O que é |
|---|---|
| Para | Até 5 endereços, separados por vírgula. Já vem preenchido com o seu e-mail. |
| De | Só aparece se o template não define um remetente. |
| Variáveis | Um campo por variável: Obrigatória quando não há valor padrão; vazio com padrão usa o valor padrão. |
Os testes contam na cota de envios e aparecem na lista de E-mails.
Publicar e versões
O rascunho é só seu. Os envios por API usam a versão publicada; por isso, depois de mudar um template em uso, clique em Publicar. Cada publicação guarda uma versão, e Restaurar volta a uma anterior (copiando-a para o rascunho). Para voltar a uma versão no ar, restaure e publique de novo.
Atenção
Excluir um template faz os envios que usam o ID ou o alias dele falharem. Se precisa só trocar o desenho, edite e publique.
Veja também: Publicar (API) · Testar (API) · Versões (API).