E-mails
A lista de e-mails enviados e agendados, o detalhe de cada um e os eventos de entrega.
Para que serve
A tela E-mails mostra tudo o que o time enviou pela API e por SMTP, com o status de entrega de cada mensagem. Daqui você confere se um e-mail chegou, vê o conteúdo exato que saiu, reenvia, cancela um agendamento e compartilha um e-mail com quem não tem conta.
Quando usar: Para responder "o e-mail do cliente chegou?", investigar bounces e reclamações, ou testar uma integração e ver o resultado na hora.
#Lista de e-mails
Onde fica: E-mails › E-mails. Endereço: app.postal.so/emails.
A lista começa pelos e-mails mais recentes. A Postal guarda os e-mails, os anexos e o histórico por 30 dias (os agendados, até saírem); depois disso eles saem da lista. Para guardar por mais tempo, use os webhooks ou o botão Exportar.
Barra de ferramentas
| Item | O que faz |
|---|---|
| Buscar por destinatário, remetente, assunto ou ID | Procura enquanto você digita (espera uma pausa). Serve também para colar o ID de um e-mail que apareceu num log ou num webhook. |
| Período | Atalhos (Hoje, Ontem, Últimas 24 horas, Últimos 3 dias, Últimos 7 dias, Últimos 15 dias e Últimos 30 dias), mais Escolher dias no calendário para um intervalo livre e Todo o período para limpar. As datas seguem o fuso do seu navegador. |
| Filtros | Abre um painel com três filtros: Status (Todos os status ou um dos status abaixo), Domínio (Todos os domínios) e Chave de API (Todas as chaves). O botão mostra quantos filtros estão ligados. Veja como o botão funciona. |
| Exportar | Gera um arquivo CSV com os e-mails da lista, respeitando a busca, o período e os filtros. O arquivo é montado em segundo plano; o download começa pelo cartão de tarefas no canto da tela e fica em Configurações › Exportações por 7 dias. Com a lista vazia, o botão fica desligado (Não há nada para exportar com esses filtros.). |
| Ver código | O botão </> do cabeçalho mostra como Listar e-mails pela API (GET /emails). |
Colunas
| Coluna | O que mostra |
|---|---|
| Para | Os destinatários, com um ícone do status à esquerda. Clicar abre o detalhe. |
| Status | O estado mais avançado do e-mail (tabela abaixo). |
| Assunto | O assunto, cortado se for longo. |
| Enviado há / Enviado em | Há quanto tempo o e-mail saiu (ou quando vai sair, se for agendado). Clique no título da coluna, ou no próprio valor, para alternar entre Enviado há (relativo) e Enviado em (data completa). A escolha fica salva neste navegador. |
| Menu da linha | Ver detalhes; Copiar ID; Reenviar (cria um e-mail novo com o mesmo remetente, destinatários, assunto e conteúdo, sem os anexos; não aparece nos agendados); Cancelar envio (só nos agendados). |
Status de um e-mail
O status só avança: um e-mail Clicado não volta a Entregue, mesmo que os eventos cheguem fora de ordem.
| Status | O que significa |
|---|---|
| Na fila | Aceito pela Postal, saindo em instantes. |
| Agendado | Marcado para uma data futura. Pode ser reagendado ou cancelado até a hora do envio. |
| Enviado | Aceito pelo provedor de envio. |
| Atrasado | O servidor do destinatário adiou a entrega; novas tentativas acontecem sozinhas. |
| Entregue | Entregue ao servidor do destinatário. |
| Aberto | O destinatário abriu (só com o rastreamento de aberturas ligado no domínio). |
| Clicado | Um link foi clicado (só com o rastreamento de cliques ligado). |
| Bounce | Devolvido pelo servidor do destinatário. Bounces permanentes põem o endereço na lista de supressão. |
| Spam | O destinatário marcou como spam. O endereço também vai para a lista de supressão. |
| Falhou | Não foi possível enviar: domínio não verificado, envio pausado, anexo inacessível e outros motivos. |
| Suprimido | Todos ou parte dos destinatários estavam na lista de supressão e não receberam. |
| Cancelado | Um envio agendado foi cancelado. |
Mais detalhes dos eventos e do objeto e-mail estão em Status de um e-mail na referência da API.
Dica
Para achar endereços que não existem, filtre por Status › Bounce. A faixa de envios pausados também leva direto a essa lista. Para ver só o que uma integração enviou, filtre pela Chave de API que ela usa.
Quando a lista está vazia
Se o time ainda não tem domínio, a tela diz Nenhum e-mail enviado ainda e pede para adicionar um domínio primeiro; depois é criar uma chave de API e fazer um POST /emails. O passo a passo está em Primeiros passos.
#Detalhe de um e-mail
Onde fica: E-mails › E-mails, clicando num e-mail. Endereço: app.postal.so/emails.
O detalhe mostra uma mensagem inteira: de onde veio, para quem foi, o que aconteceu com ela e como ficou o conteúdo. O título é o assunto e, logo abaixo, está o status atual.
Botões do cabeçalho
| Item | O que faz |
|---|---|
| Linha do tempo | Abre um painel lateral com cada evento do e-mail, do mais antigo ao mais recente, com data e hora: criado na fila, enviado, entregue, aberto, clicado, bounce e assim por diante. Num bounce, aparece se foi Bounce permanente ou Bounce temporário e a mensagem do servidor, o que ajuda a entender o motivo. |
| Insights | Abre as verificações de entregabilidade do e-mail: Versão em texto, Sem encurtadores de link, Links com HTTPS, Sem links para IP, Imagens com texto alternativo, Tamanho do HTML (o Gmail corta mensagens acima de 102 KB), Equilíbrio entre texto e imagem, Remetente que aceita respostas, Assunto sem caixa alta, Opção de descadastro e DMARC configurado. O que não passou vem primeiro, com a explicação. Se o assistente de IA está disponível, Como corrigir? explica passo a passo (gasta 1 crédito de IA). |
| Ver código | Mostra como consultar este e-mail pela API (GET /emails/{id}). |
| Compartilhar | Cria um link público do e-mail, válido por 48 horas, e copia para a área de transferência (o botão fica verde com Copiado). Quem abrir o link vê a mensagem sem precisar de conta. Cliques seguintes em Copiar link copiam o mesmo link. |
| Reenviar | Cria um e-mail novo com o mesmo conteúdo e abre o novo detalhe. Conta na cota de envios como qualquer outro. |
| Reagendar / Cancelar envio | Só nos e-mails agendados. Reagendar muda o horário (veja Agendados); Cancelar envio desiste do envio. |
Dados do e-mail
| Campo | O que mostra |
|---|---|
| De, Para, Cc, Cco, Responder para | Os endereços como foram enviados. Cc, Cco e Responder para só aparecem quando existem. |
| ID | O identificador do e-mail, com botão de copiar. É o que a API e os webhooks usam. |
| Criado em | Quando a Postal recebeu o pedido de envio. |
| Origem | API ou SMTP. |
| Requisição | O link Ver log da requisição leva ao log da chamada que criou o e-mail, com o corpo enviado e a resposta. |
| Agendado para | A data e hora do envio, nos e-mails agendados. |
| Tags | Pares nome e valor que você enviou na API, úteis para filtrar e relacionar com o seu sistema. |
Conteúdo
| Aba | O que mostra |
|---|---|
| Visualização | O e-mail renderizado, como o destinatário o vê. |
| HTML | O código HTML enviado, com botão de copiar. |
| Texto | A versão em texto puro. |
| Original | A mensagem completa, com os cabeçalhos (formato .eml). É a melhor fonte para investigar problemas de entrega. |
Se o e-mail tem anexos, a seção Anexos lista cada arquivo com tipo e tamanho e um link Baixar.
Veja também: GET /emails/{id} · Eventos do e-mail · Diagnóstico pela API.
#Agendados
Onde fica: Marketing › Agendados. Endereço: app.postal.so/scheduled.
Uma única lista, por dia, de tudo o que tem hora marcada: campanhas agendadas, e-mails agendados pela API ou pelo painel e as ativações e pausas marcadas das automações. Serve para ver o que vai sair e quando, sem abrir cada tela.
| Item | O que faz |
|---|---|
| Filtros › Tipo | Mostra só um tipo: Campanha, E-mail, Ativação ou Pausa (Todos os tipos limpa o filtro). |
| Horários em ... | Um lembrete do fuso em que os horários aparecem: o do seu navegador. Uma campanha agendada em outro fuso mostra também o horário escolhido lá. |
| Dia | Cada dia tem um título (Hoje e Amanhã quando for o caso) e a quantidade de itens (N itens). |
| Linha | A hora, o tipo (ícone e etiqueta), o nome do item (link que abre a campanha, o e-mail ou a automação) e uma linha de detalhe: Para o segmento ou os endereços, ou, nas automações, A automação passa a receber contatos / A automação para de receber contatos. |
| Menu da linha | Abrir; Reagendar (abre o seletor de data e hora do tipo); Cancelar agendamento. Cancelar uma campanha ou um e-mail impede o envio; cancelar uma ativação ou uma pausa só remove a marcação e a automação continua como está. |
A tela mostra os 100 próximos de cada tipo (Mostrando os 100 próximos de cada tipo.) e se atualiza sozinha. E-mails e campanhas podem ser agendados com até 30 dias de antecedência.
Reagendar um e-mail
Reagendar abre Reagendar e-mail: o conteúdo e os destinatários continuam os mesmos, só o horário muda. Escolha a Data, a Hora e o Fuso horário (Horário de Brasília, UTC e outros), ou use um dos Atalhos: Amanhã às 9h, Segunda às 9h e Em 1 hora. O resumo abaixo confirma a hora no fuso escolhido. Se o e-mail já saiu ou foi cancelado, o painel avisa que ele não está mais agendado.
Veja também: Reagendar e-mail (API) · Campanhas · Automações.
#Eventos
Onde fica: Marketing › Eventos. Endereço: app.postal.so/events.
Eventos são os acontecimentos do seu produto que você manda para a Postal: uma compra, um cadastro, um cancelamento. Eles ficam ligados a um contato, aparecem aqui e podem iniciar automações e personalizar e-mails. A Postal guarda os eventos por 90 dias.
Não confunda com os eventos de um e-mail (entregue, aberto, clicado), que ficam na linha do tempo do e-mail, nem com os eventos de webhook.
Lista
| Item | O que faz |
|---|---|
| Contato (e-mail ou ID) | Campo de busca para ver só os eventos de uma pessoa. |
| Filtros › Evento | Escolhe um nome de evento entre os que já chegaram (Todos os eventos limpa). |
| Coluna | O que mostra |
|---|---|
| Evento | O nome (por exemplo, order.paid). Clicar abre o detalhe. |
| Contato | O e-mail do contato, ou um traço quando o evento não tem contato. |
| Propriedades | Um resumo dos dados enviados com o evento. |
| Quando | Há quanto tempo aconteceu; o ponteiro do mouse mostra a data completa. |
Ao clicar num evento, abre uma janela com o nome, o contato e a data, as propriedades em JSON (com Copiar propriedades), o ID do evento e o link Ver contato.
Enviar um evento
O painel à direita, Enviar um evento, traz o código pronto em cURL, Node.js, PHP e Python (aba Linguagem) com o botão de copiar. Qualquer chave de API serve, inclusive as só de envio. Os campos:
| Campo | O que é |
|---|---|
| name | Obrigatório. Letras, números e os símbolos . _ : - (como order.paid). |
| contact | E-mail ou ID do contato. Se o e-mail não existir, o contato é criado. Sem contact, o evento fica registrado, mas não inicia automações. |
| properties | Objeto livre de até 16 KB. Serve em filtros, em condições das automações e nos e-mails, como {{event.order_id}}. |
| occurred_at | Opcional. Quando aconteceu (ISO 8601); o padrão é agora. |
Repita a requisição com o mesmo cabeçalho Idempotency-Key para não duplicar o evento.
Dica
Antes de montar uma automação por evento, envie um evento de teste e confira o nome aqui: o nome precisa ser idêntico no gatilho da automação.
Veja também: Eventos (API) · Automações · Idempotência.