Conceito
Detalhes do e-mail
Veja 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.
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 |