Informativo: O que é o plugin de rastreamento de entrega
Objetivo
Explicar o que o plugin de rastreamento de entrega resolve, o que ele instala no seu servidor e o que ele deliberadamente nunca toca — para você decidir se vale instalar antes de instalar.
Escopo e Público
- Aplica-se a: servidores de hospedagem cPanel/WHM e DirectAdmin cuja saída de e-mail passa pelo relay Sender25.
- Não cobre: o painel do Sender25 em si — para isso veja o capítulo Guia do Usuário.
- Público-alvo: administrador do servidor de hospedagem.
O problema
Entrega de e-mail acontece em saltos. Quando o Exim do seu painel entrega a mensagem ao relay, o trabalho dele acaba ali e ele registra a mensagem como entregue — não importa o que aconteça depois. Quem de fato tenta a entrega final é o relay, então o desfecho verdadeiro mora lá e nunca chega ao painel.
O resultado: a tela nativa de rastreamento — exatamente a tela que alguém abre para perguntar "o que aconteceu com o meu e-mail?" — informa falso sucesso para toda mensagem de saída.
Não é defeito do painel. Ele está relatando com honestidade o que sabe; o que ele sabe é só metade da história.
O que o plugin faz
Junta as duas metades: o painel sabe de quem é cada mensagem, o relay Sender25 sabe o que aconteceu com ela.
- Entrada e saída numa tela só — no WHM todas as contas, no cPanel só a própria conta; no DirectAdmin a tela de administrador e, se você habilitar, a de cliente.
- Busca e filtro por remetente, destinatário, domínio, direção, status e intervalo de datas.
- Nunca apresenta uma entrega ao relay como entrega ao destinatário. Uma mensagem cujo desfecho ainda não se conhece aparece como No relay — status pendente, e não como entregue.
Essa última linha é a decisão central do produto: preferimos dizer "ainda não sei" a repetir o falso sucesso que você já tem hoje.
Requisitos
pdo_sqlite, curl, json, zlib — no DirectAdmin também posix
Acesso
root, por SSH
Sem Composer, sem pacotes, nada baixado no seu servidor na hora da instalação. O instalador copia arquivos PHP e mais nada.
Você não precisa da credencial de API do relay para instalar. Um servidor sem credencial é uma configuração suportada: o rastreamento de entrada funciona na hora, e a saída fica em "No relay" até você informar uma. Não trave a instalação por causa disso.
O que ele nunca toca
Vale saber antes de instalar em servidor com cliente pagante:
- O banco de e-mail do painel é somente leitura. No cPanel, o
/var/cpanel/eximstats_db.sqlite3nunca é escrito — nem na instalação, nem na operação, nem na remoção. No DirectAdmin, o mainlog do Exim também só é lido. - Não lê conteúdo de mensagem. O plugin trabalha com registros de entrega: quem enviou, para quem, quando e o que aconteceu. Corpo de e-mail não entra nisso.
- A substituição da tela nativa vem desligada e só acontece se você ligar de propósito. (Isso apenas para WHM/cPanel, consultar documentação para substituir a tela de rastreamento de emails nativo).
- A única coisa que sai do seu servidor é uma pergunta diária ao servidor de releases: "existe versão nova?". Ela não envia versão instalada, nem hostname, nem contagem de mensagens.
Por onde começar
- Guia: Como instalar o plugin no cPanel/WHM ou Guia: Como instalar o plugin no DirectAdmin.
- Guia: Como configurar a credencial do relay no plugin — sem ela, só metade do produto funciona.
- Guia: Como ler os status de entrega — leia antes de abrir chamado sobre "mensagem não entregue".
Controle de Mudanças
Informações de controle de versão
- Última revisão 02-09-2026
- Próxima revisão 02-03-2027
- Autor Sender25
- Versão 1.0