blog
Painéis

E-mails enviados e recusados: relatório em 4 passos no cPanel

Um roteiro reutilizável com o Rastreamento de Entrega do cPanel: período, leitura das colunas de resultado, exportação e o cruzamento com o limite por hora que denuncia o script culpado.

JR · · 9 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: o relatório sai em 4 passos no Rastreamento de Entrega do cPanel: delimitar o período, filtrar as três colunas de resultado (Entregue, Adiado, Falhou/Rejeitado), levar os totais para uma planilha e cruzar o pico de envio por hora com o limite configurado da conta.

Neste artigo
  1. O que o Rastreamento de Entrega mostra e o que fica de fora
  2. Quatro conferências por servidor antes do primeiro relatório
  3. Rodar o relatório por período e ler o resultado
  4. Adiado não é Falhou, e confundir os dois custa caro
  5. Exportar os totais e montar a planilha semanal
  6. Cruzar o pico por hora com o limite configurado da conta
  7. Seis erros que invalidam o relatório
  8. Checklist e a frase para o cliente

O que o Rastreamento de Entrega mostra e o que fica de fora

O Rastreamento de Entrega (cPanel >> Email >> Track Delivery) lista as tentativas de entrega das mensagens que saíram pelo Exim daquela conta. Cada linha é um evento: remetente, destinatário, hora de envio, resultado e a resposta do servidor de destino. É a única tela do painel que devolve, mensagem a mensagem, o motivo textual da recusa.

O que ele não responde:

Para o número agregado por período (quantas mensagens o servidor processou, por usuário e por domínio) o caminho é o WHM, na interface View Mail Statistics (documentação oficial do cPanel, consulta em 28/09/2026), que resume os dados do banco de estatísticas do Exim. Use as duas telas juntas: a do WHM dá o volume, a do cPanel dá o motivo. A documentação oficial cobre o resumo de estatísticas do WHM; tudo o que este artigo diz sobre o comportamento da tela do Track Delivery (limite de linhas, retenção, conteúdo do detalhe) é observação de campo e varia com a configuração do servidor, então confirme no seu antes de virar procedimento.

Quatro conferências por servidor antes do primeiro relatório

Se você vai transformar isso em rotina para vários clientes, confira estes quatro pontos uma vez por servidor. Depois é só repetir.

  1. Acesso. Track Delivery está no cPanel da conta. A versão do WHM (Mail Delivery Reports e View Mail Statistics) exige acesso de root ou de revenda, dependendo das permissões do pacote.
  2. Janela de retenção. Observação de campo, não coberta pela documentação citada: a janela que a tela devolve varia de servidor para servidor, conforme a configuração de purga das estatísticas do Exim. Antes de prometer "relatório dos últimos 30 dias" ao cliente, rode um teste com um período longo e veja até onde a tela devolve dados. Se a retenção for curta, seu relatório precisa ser semanal, não mensal.
  3. Limite de envio atual da conta. Anote o limite por hora que está configurado (por conta e, se houver, por domínio). Sem esse número, a coluna de pico por hora não conclui nada.
  4. Inventário de remetentes. Liste quais endereços deveriam enviar: formulário do site, loja, newsletter, caixas humanas. Tudo que aparecer fora dessa lista é suspeito por definição.

Rodar o relatório por período e ler o resultado

Delimite a janela antes de somar qualquer coisa

Abra Track Delivery e restrinja pelo campo de hora de envio. Janela curta é melhor: comece com 24 horas em torno do horário da reclamação do cliente. Outra observação de campo: a tela limita o número de linhas retornadas, e se períodos diferentes devolverem sempre o mesmo total você provavelmente está olhando uma amostra truncada. Confira contando as linhas antes de somar.

Filtre por resultado, não pelo domínio do cliente

Filtre primeiro por Falhou. Se a lista vier vazia, filtre por Adiado. Só depois olhe o total. O erro clássico é começar filtrando pelo domínio do cliente, o que esconde o remetente que está gerando o problema quando ele é usuario@servidor ou um endereço inventado por um script.

Abra o detalhe do evento e copie o texto da recusa

Cada linha tem o detalhe com a resposta literal do servidor de destino. É esse texto que você copia para o relatório: 550 5.7.1 message rejected, 421 too many connections, 554 blocked using .... Sem o texto, o relatório vira opinião. Comportamento observado em campo, não documentado: em envios disparados pela função mail() do PHP o detalhe costuma trazer o diretório de trabalho e o caminho do script que originou a mensagem, que é exatamente o que você precisa para apontar o culpado dentro do WordPress. Depende de como PHP e Exim estão configurados, então confirme no seu servidor antes de contar com esse campo.

Anote os três totais e o pico por hora

Entregue, Adiado, Falhou. Três números, mais o pico por hora. É isso que vai para a planilha.

Relatório de entrega no cPanel em quatro passosDelimitar janela24 horas em torno da reclamaçãoFiltrar por resultadoFalhou primeiro, depois AdiadoAbrir o detalheCopiar o texto literal da recusaAnotar totaisEntregue, Adiado, Falhou e pico
Os quatro passos do Track Delivery na ordem que evita conclusão errada.

Adiado não é Falhou, e confundir os dois custa caro

Confundir Adiado com Falhou é o erro mais caro desse relatório, porque leva a trocar de plano quando o problema é um script, ou a ignorar um problema que ainda está reversível.

Resultado Significado O que o servidor faz Como tratar no relatório
Entregue Destino aceitou a mensagem Nada, entrega concluída Linha de base do volume
Adiado Erro temporário (família 4xx), fila cheia, greylisting, limite de conexão do destino, estouro do limite de envio por hora da própria conta Continua tentando até a mensagem expirar na fila Alerta. Adiado repetido para o mesmo destino vira falha em algumas horas
Falhou / Rejeitado Erro permanente (família 5xx), caixa inexistente, bloqueio por reputação, recusa por política Devolve ao remetente e para de tentar Prioridade. Copie o texto da recusa
Em progresso / na fila Ainda não houve tentativa concluída Aguardando processamento Se acumular, olhe o tamanho da fila antes de concluir qualquer coisa

Um detalhe que muda o rumo da conversa: quando a conta estoura o limite de envio por hora configurado no painel, a recusa vem do próprio servidor, não do destino, e na maioria dos casos ela é temporária. A mensagem excedente fica na fila e aparece como Adiado, com texto de erro citando o limite excedido; só vira Falhou se expirar na fila antes de caber na janela seguinte. Por isso o estouro de limite raramente aparece na coluna de falha permanente: se você filtrar só por Falhou, passa batido. Vendo isso em Adiado, o problema ainda não é reputação, é volume, e você tem algumas horas de vantagem antes que as rejeições externas comecem.

Exportar os totais e montar a planilha semanal

Verifique se a sua versão do cPanel oferece botão de exportação na tabela do Track Delivery. Se oferecer, use. Se não oferecer, não invente: selecione a tabela e cole na planilha, ou puxe os totais direto do log quando tiver acesso SSH. O log do Exim no cPanel fica em /var/log/exim_mainlog, e os marcadores de linha são padrão do Exim:

# totais do arquivo atual
grep -c " => " /var/log/exim_mainlog     # entregas concluídas
grep -c " == " /var/log/exim_mainlog     # adiadas (deferral)
grep -c " \*\* " /var/log/exim_mainlog   # falhas permanentes

# falhas por hora (posição 12-13 da linha = hora do timestamp)
grep " \*\* " /var/log/exim_mainlog | cut -c12-13 | sort | uniq -c

# quem está falhando mais (ajuste o domínio)
grep " \*\* " /var/log/exim_mainlog | grep "@exemplo.com.br" | head -20

Nos logs rotacionados (exim_mainlog.1, .gz) use zgrep com os mesmos padrões. Esses comandos são convenção do Exim, não parâmetro da documentação do cPanel; confira o caminho do log no seu servidor antes de colocar no seu runbook.

A planilha que sobrevive ao tempo tem estas colunas, uma linha por conta e por semana:

Data Conta Enviadas Entregues Adiadas Falhadas % falha Pico/hora Limite/hora Erro mais frequente
2026-09-22 loja 1 240 1 190 12 38 3,1% 310 500 550 caixa inexistente
2026-09-22 contato 96 44 45 7 7,3% 60 50 limite por hora excedido (adiado)

Os dois valores acima são exemplo de leitura, para mostrar o formato, não medição nossa. Cada linha cobre uma semana, então o pico por hora nunca pode ser maior que o total enviado no período: se ficar, você somou errado ou está lendo uma amostra truncada. O que importa é o padrão: a conta loja manda muito e falha pouco, a conta contato manda pouco e tem quase metade das mensagens presa em adiamento, com pico acima do limite configurado. A segunda é a que derruba o domínio inteiro.

Cruzar o pico por hora com o limite configurado da conta

Esse cruzamento é o coração do relatório e leva dois minutos.

E a recomendação contra o próprio interesse: se o problema se concentra em um remetente único e o erro é limite local, nenhum upgrade de plano resolve. Corrigir o plugin ou o formulário resolve, e custa uma hora de trabalho.

Pico por hora contra limite: quatro leiturasPico abaixo do limite, falha baixaArquive e revise na semana seguintePico encostando no limiteAvise o cliente antes do chamadoPico acima do limite, muito AdiadoScript ou formulário em loopPico baixo, falha alta externaAutenticação, conteúdo ou reputação
Leitura do cruzamento entre pico por hora e limite configurado da conta.

Seis erros que invalidam o relatório

Checklist e a frase para o cliente

Rotina de 10 minutos por conta

  1. Track Delivery, janela de 7 dias (ou o máximo que a retenção permitir).
  2. Filtro Falhou, anote o total e os três textos de erro mais frequentes.
  3. Filtro Adiado, anote o total e se há destino repetido.
  4. Total de enviadas e pico por hora.
  5. Compare o pico com o limite configurado da conta.
  6. Linha nova na planilha, com data. Compare com a semana anterior.
  7. Se a taxa de falha subiu duas semanas seguidas, abra investigação por remetente antes que o bloqueio externo apareça.

A frase pronta para enviar ao cliente

"Os servidores de destino estão recusando parte das mensagens que saem do seu site. No período analisado, X mensagens saíram, Y foram entregues e Z foram recusadas ou ficaram presas na fila, com pico de N envios em uma única hora, acima do limite de envio da conta. Enquanto isso continuar, os e-mails importantes (orçamento, nota fiscal, recuperação de senha) entram na mesma fila e param de chegar. O passo imediato é conter o envio automático que está causando o pico. Depois disso, normalizamos o limite."

Troque X, Y, Z e N pelos números da sua planilha. Cliente entende volume e consequência; não precisa entender 4xx e 5xx.

Onde esse relatório se conecta com limite e blacklist

Esse relatório é o meio do caminho. Antes dele vem a configuração do limite de e-mails por hora. Depois dele, se a recusa externa já citar bloqueio por reputação, o assunto vira remoção de IP em blacklist, e aí o relatório que você guardou vale ouro: é a prova de quando o volume anormal começou e quando parou.

Referências

  1. Documentação oficial (cpanel) — View Mail Statistics Summary (WHM). Consultado em 2026-09-28.
Leia também