Conceito
Detalhes do e-mail
Veja a linha do tempo de entrega, os cabeçalhos, o conteúdo, os anexos, as tentativas de entrega, as aberturas, os cliques e a verificação de spam de um e-mail, e encaminhe, cancele ou tente enviá-lo de novo.
A página de detalhes do e-mail mostra tudo o que o Emailit sabe sobre um único e-mail. Abra-a selecionando uma linha em Email APIEmails. Esta página explica cada parte dela e as ações que você pode realizar a partir dela.
Resumo
Os cards no topo mostram Created, Scheduled (só para e-mails agendados), Status, From, To e Subject. Passe o cursor sobre o status para ver a descrição dele, ou consulte Status de e-mail.
Linha do tempo de entrega
Nos planos Pro, Business e Custom, os e-mails de saída têm um card Delivery timeline abaixo do resumo. Ele acompanha o e-mail desde o momento em que o Emailit o recebeu até a resposta do servidor de destino, e depois até as aberturas e os cliques.
Fechado, o card mostra um resumo de uma linha, por exemplo “Delivered in 1.2 s · 2 attempts · Google”, e as etapas em sequência: o recebimento (com a origem, como API, SMTP, Campaign ou Automation), a entrada na fila ou o agendamento, cada tentativa de entrega com o código SMTP dela, e a primeira abertura e o primeiro clique. Selecione Show details para abri-lo. O painel lembra a sua escolha para os próximos e-mails que você abrir.
Aberto, o card começa com quatro números:
| Número | Mostra |
|---|---|
| Time to deliver | Do momento em que o Emailit recebeu o e-mail, ou do horário agendado dele, até o servidor de destino aceitá-lo, com quanto tempo levaram a aceitação e a entrada na fila (Received → queued). |
| Attempts | As tentativas SMTP e quantas delas foram adiadas. |
| Inbox provider | O provedor de e-mail do destinatário, reconhecido pelo servidor de e-mail dele, e o host MX da última tentativa. |
| Encryption | A versão do TLS da conexão, ou Not encrypted. |
Abaixo deles, cada etapa aparece com o horário dela e o tempo desde o início:
- Attempt 1, Attempt 2 e assim por diante, com o resultado (Delivered, Deferred, Bounced ou Internal error), o código SMTP, o servidor de destino e o endereço IP dele, o endereço IP a partir do qual o Emailit enviou, a resposta completa do servidor e, depois de um adiamento, o horário da próxima tentativa. Uma barra divide a tentativa em Queue, Processing, DNS, Connect + TLS e SMTP. Consulte Para onde vai o tempo.
- Not sent marca uma rodada em que o Emailit não contatou o servidor de destino, por exemplo porque estava em backoff com um provedor que tinha limitado o ritmo de envio, ou porque a mensagem deu bounce antes do envio.
- As mudanças de status, como retido, suprimido ou cancelado, com os detalhes delas.
- Opened e Clicked, com quantas vezes.
Enquanto um e-mail ainda está a caminho, o card mostra Waiting for the next attempt com o horário, ou Delivery attempt in progress, e se atualiza sozinho. Os e-mails enviados antes da introdução da linha do tempo de entrega mostram os eventos de entrega deles sem o tempo de cada etapa. Delivery dashboard abre o painel Delivery, com os mesmos números de todos os seus e-mails.
No Pay as you go, o card mostra um e-mail de exemplo e um botão Upgrade. Os e-mails recebidos não têm linha do tempo.
Cabeçalhos
O painel Headers lista os cabeçalhos da mensagem em pares de nome e valor. Ele vem recolhido por padrão; selecione-o para expandir. Use-o para conferir From, Reply-To, Message-ID e os cabeçalhos personalizados que você definiu. Para e-mails recebidos, ele mostra os cabeçalhos que o servidor do remetente entregou.
Conteúdo
O conteúdo da mensagem fica oculto até você selecionar Show Preview. O aviso embaixo do botão, “Viewing may affect email statistics”, existe porque a pré-visualização renderiza o HTML, incluindo imagens remotas, o que pode contar como uma abertura.
Depois de abrir a pré-visualização, alterne entre:
- HTML: a mensagem renderizada em um frame isolado (sandbox).
- Text: a parte em texto simples.
- Source: o HTML bruto.
Quando o conteúdo da mensagem já foi apagado pela retenção de dados, a pré-visualização e os anexos ficam vazios.
Anexos
O painel Attachments lista cada arquivo com nome, tipo de conteúdo, tamanho e disposição (attachment ou inline). Para baixar os anexos, use Listar anexos, que retorna o conteúdo codificado em Base64.
Deliveries, Loads e Clicks
As abas à direita mostram o histórico do e-mail, com uma contagem em cada aba:
| Aba | Cada linha mostra | Use para |
|---|---|---|
| Deliveries | Um status, os detalhes ou a resposta do servidor de destino e o horário. | Ver todas as tentativas de entrega, as falhas temporárias, a resposta final do servidor do destinatário e o motivo de um e-mail ter sido retido, rejeitado ou suprimido. |
| Loads | O horário e o endereço IP de cada abertura. | Verificar se e quando a mensagem foi aberta. Requer o rastreamento de carregamentos. |
| Clicks | A URL do link, o endereço IP e o horário de cada clique. | Ver quais links foram clicados. Requer o rastreamento de cliques. |
Uma linha Failed que diz “An internal error occurred while sending this email. This message will be retried automatically.” é um erro do lado do Emailit. O e-mail não falhou; ele recebe novas tentativas como em uma falha temporária.
Verificação de spam
O Emailit pontua as mensagens de saída com o Rspamd antes do envio. O painel Spam Checks mostra a pontuação total e todas as regras que corresponderam.
O selo ao lado do título mostra a pontuação total:
| Selo | Significado |
|---|---|
| Verde, Score abaixo de 5 | Baixa probabilidade de spam. |
| Laranja, Score de 5 a pouco menos de 7 | No limite. Observe as regras com pontuação positiva. |
| Vermelho, Score 7 ou mais | No limite de retenção ou acima dele. O e-mail foi retido e não foi enviado. |
| Cinza, Not inspected | A mensagem não foi pontuada, por exemplo um e-mail recebido. |
O mesmo selo aparece na coluna Spam score da lista de e-mails, onde você também pode filtrar por ele.
A tabela lista cada regra que correspondeu (Check), o resultado dela (Result) e a pontuação dela (Score). Leia-a assim:
- Score é a contribuição da regra para o total. Um número positivo empurra a mensagem para o spam; um número negativo a afasta dele.
- Result descreve o efeito para você, e não o sinal do número. Uma regra com pontuação negativa aparece como Positive (verde) porque ajudou. Uma regra com pontuação positiva aparece como Negative (vermelho) porque prejudicou. Uma pontuação zero é Neutral.
- Cada linha mostra a descrição da regra com o símbolo do Rspamd embaixo, por exemplo
R_DKIM_ALLOW(assinatura DKIM válida, pontuação negativa) ouMIME_HTML_ONLY(sem parte em texto simples, pontuação positiva).
Filtre a tabela com All, Negative, Positive e Neutral, ou pesquise com Filter checks…. Para baixar a pontuação de uma mensagem retida, corrija as regras marcadas como Negative, começando pelas pontuações mais altas, e depois tente enviar de novo. Consulte Verificação de spam para ver as regras mais comuns e como corrigi-las.
Ações
Os botões no topo da página dependem do tipo e do status do e-mail.
Forward
Disponível para e-mails enviados. Forward reenvia a mensagem para outro endereço como um novo e-mail:
- Digite o destinatário em To. Por padrão, a mensagem é enviada como está.
- Selecione Add forwarded headers and a comment para incluir os cabeçalhos originais e um comentário opcional em Comment acima da mensagem.
- O encaminhamento é um novo e-mail, com um novo ID, e os créditos são cobrados como em qualquer envio. O e-mail original não é alterado.
- Você pode encaminhar até 3 e-mails por hora por workspace, e somente enquanto o conteúdo da mensagem ainda estiver retido.
O equivalente na API é Encaminhar um e-mail.
Cancel delivery
Disponível enquanto o status é scheduled, accepted ou attempted. O Emailit tenta retirar o e-mail da fila de envio. Os e-mails agendados podem ser cancelados até 3 minutos antes do horário de envio.
O cancelamento é feito em regime de melhor esforço. Se uma tentativa de entrega já tiver começado, ela ainda pode ser concluída; nesse caso, o Emailit mostra “Cancel requested” com “The current delivery attempt may still complete. Remaining retries were stopped.” O status do e-mail passa a ser canceled e um evento email.canceled é enviado. O equivalente na API é Cancelar um e-mail.
Retry
Disponível no painel para e-mails held e suppressed. Retry envia um novo e-mail com o mesmo conteúdo e o abre; o original continua como estava. Os créditos normais são cobrados. O e-mail deve ter menos de 30 dias e o conteúdo dele ainda deve estar retido.
A API Tentar enviar um e-mail de novo também aceita e-mails bounced e failed. Corrija a causa antes: um e-mail retido é retido de novo, e um endereço suprimido é suprimido de novo, se nada tiver mudado. Consulte Status de e-mail.
Obter os mesmos dados pela API
| Dados | Endpoint |
|---|---|
| E-mail, corpo interpretado, cabeçalhos e anexos | Obter um e-mail |
| Código-fonte MIME bruto | Obter o MIME bruto |
| Só o corpo em texto e HTML | Obter o corpo |
| Metadados e lista de anexos sem o conteúdo | Obter os metadados |
| Mudanças de status, aberturas e cliques | Eventos e webhooks |