Ir para o conteúdo principal

Guia: Como ler os status de entrega — e por que "não entregue" quase nunca é problema seu

Objetivo

Explicar por que a tela de rastreamento do seu painel de hospedagem mostra status como "No relay" ou "Em trânsito" em vez de "entregue" para boa parte das mensagens — e por que isso não é o plugin quebrando o rastreamento, e sim o rastreamento passando a dizer a verdade.


Escopo e Público

  • Aplica-se a: leitura e interpretação dos status na tela do plugin de rastreamento de entrega, tanto na visão do administrador quanto na visão do cliente final.
  • Não cobre: instalação do plugin, nem a configuração da credencial de API do relay — cada um tem o seu guia.
  • Público-alvo: administrador de um servidor de hospedagem (cPanel/WHM ou DirectAdmin) que instalou o plugin.

Pré-requisitos

  • Plugin de rastreamento de entrega instalado no painel (WHM/cPanel ou DirectAdmin).
  • Pelo menos algumas mensagens de saída já processadas pelo servidor, para haver o que observar na tela.

Passos (sequência)

Passo 1 — Por que a tela mudou

Entrega de e-mail acontece em saltos. O Exim do seu painel entrega a mensagem ao relay — e o trabalho dele acaba ali. O que acontece depois, no salto seguinte, ele não tem como saber.

Por isso a tela nativa do painel marca como entregue toda mensagem de saída: ela só sabe que a mensagem saiu, não sabe o que aconteceu com ela. Quando alguém pergunta "o que aconteceu com o meu e-mail?", essa tela responde sucesso para tudo — mesmo quando não há garantia nenhuma de que a mensagem chegou.

O plugin junta as duas metades da história: o painel sabe de quem é a mensagem, e o Sender25 sabe o que aconteceu com ela. Quando você vê um status diferente de "Entregue" pela primeira vez, não é o plugin quebrando algo que funcionava — é a primeira vez que essa informação existe.

Passo 2 — A tabela de status (tela do administrador)

Estes são os status que você vê no painel administrativo (WHM ou DirectAdmin):

ChipRótuloO que significa
EntregueEntregueO destino aceitou a mensagem — o único status que significa sucesso.
AdiadaFalha temporáriaO destino pediu para tentar mais tarde (4xx). Será retentada.
FalhouFalha permanenteRecusa definitiva do destino (5xx). Não será tentada de novo.
RetidaRetidaO relay está retendo a mensagem em vez de tentar a entrega.
Retenção canceladaRetenção canceladaA retenção desta mensagem foi liberada.
ErroErroO processamento falhou antes de haver um desfecho.
No relayNo relay — status pendenteSaiu deste servidor e está no relay, sem desfecho reportado. Isto não é entrega.
DesconhecidoStatus desconhecido informado pelo relayNão foi possível determinar o desfecho, e ele nunca é tratado como sucesso.
Em andamentoEm andamentoAceita pelo servidor, aguardando processamento.

Regra dura do produto, não estilo de redação: "Entregue" é o único status que significa sucesso. "No relay", "Em andamento" e "Desconhecido" são todos ausência de resposta — nunca sucesso.

📷 Espaço para imagem — lista-status-variados.png
O que precisa aparecer: a lista de mensagens com vários status diferentes visíveis ao mesmo tempo — pelo menos Entregue, No relay e uma falha. É o que liga a tabela acima à tela de verdade.
Onde capturar: Plugin → Mensagens, sem filtro de status.
⚠ Anonimize antes de publicar. Esta tela mostra endereços de e-mail reais de clientes, e a documentação é pública.

Passo 3 — Mensagens que nunca chegam ao relay

Uma mensagem entregue localmente — de uma conta para outra do mesmo servidor — nunca passa pelo relay. Ela aparece normalmente na lista, e quando você abre o detalhe dela, o trajeto mostrado vai de "Este servidor" direto ao destino, com uma nota embaixo:

Nenhuma entrega ao relay foi encontrada — resolveu sem passar por ele.

Não é problema, não é mensagem perdida: é uma entrega que aconteceu inteira dentro do seu servidor. O cliente final, na tela dele, lê a mesma situação como "Entregue sem sair deste servidor." — é o mesmo caso, com o vocabulário dele. Veja o Passo 5.

📷 Espaço para imagem — detalhe-entrega-local.png
O que precisa aparecer: o detalhe de uma mensagem entregue localmente, mostrando o trajeto de "Este servidor" direto ao destino e a nota "Nenhuma entrega ao relay foi encontrada — resolveu sem passar por ele."
Onde capturar: Plugin → Mensagens → clique numa mensagem entre contas do mesmo servidor.
⚠ Anonimize antes de publicar. Esta tela mostra endereços de e-mail reais de clientes, e a documentação é pública.

Passo 4 — A tabela de status (tela do cliente final)

Se o seu cliente de hospedagem também usa o plugin (na área de e-mail do cPanel ou DirectAdmin dele), ele vê a mesma informação com outras palavras em três status:

ChipRótuloO que significa
Em trânsitoEm trânsito — destino não confirmouSaiu deste servidor; o destino ainda não confirmou. Isto não é entrega.
RetidaRetidaA mensagem está retida em vez de ser entregue.
DesconhecidoDesfecho desconhecidoNão foi possível determinar o desfecho, e ele nunca é tratado como sucesso.

Todos os outros status ("Entregue", "Adiada", "Falhou", "Retenção cancelada", "Erro", "Em andamento") usam exatamente as mesmas palavras nas duas telas.

Passo 5 — O mesmo status, duas palavras

Repare no Passo 2 e no Passo 4: a mesma mensagem que você, administrador, vê como "No relay — status pendente" aparece para o seu cliente final como "Em trânsito — destino não confirmou". É de propósito.

Seu cliente final não tem relação com o relay e não pode fazer nada a respeito dele. Para ele, a mesma situação é descrita pelo que é verdade sobre a mensagem dele — não por qual infraestrutura está segurando essa mensagem no meio do caminho. A honestidade da descrição não muda entre as duas telas; só o vocabulário muda, porque o público muda.

O mesmo vale para a nota do Passo 3: onde você lê "nenhuma entrega ao relay foi encontrada", ele lê "entregue sem sair deste servidor".

Na prática: se você e seu cliente olharem a mesma mensagem ao mesmo tempo, vocês vão ler frases diferentes. Nenhuma das duas telas está errada. Explique isso antes que alguém abra um chamado achando que encontrou um bug.

📷 Espaço para imagem — mesma-mensagem-duas-telas.png
O que precisa aparecer: a mesma mensagem nas duas telas, lado a lado: à esquerda a do administrador dizendo No relay — status pendente, à direita a do cliente dizendo Em trânsito — destino não confirmou. É a imagem mais importante deste guia — a seção inteira existe por causa dessa diferença.
Onde capturar: Abra a mesma mensagem no WHM e no cPanel da conta dona dela, e monte as duas capturas lado a lado.
⚠ Anonimize antes de publicar. Esta tela mostra endereços de e-mail reais de clientes, e a documentação é pública.

Passo 6 — O mesmo status no painel do Sender25

Há ainda um terceiro lugar onde esses status aparecem: o painel do Sender25, que os mostra pelos nomes técnicos, em inglês. Se você acompanhar a mesma mensagem nos dois lugares, é esta a equivalência:

Painel do Sender25Plugin (administrador)Plugin (cliente final)
SentEntregueEntregue
SoftFailFalha temporária (chip: Adiada)igual
HardFailFalha permanente (chip: Falhou)igual
HeldRetidaRetida
ErrorErroigual
PendingEm andamentoigual
não existe láNo relay — status pendenteEm trânsito — destino não confirmou

A última linha é a que mais importa. "No relay" não existe no painel do Sender25 — e não poderia existir: lá dentro, o relay é quem está processando a mensagem, então ele sempre sabe em que estado ela está. "No relay" é a resposta do plugin para "o painel de hospedagem entregou a mensagem, e o desfecho ainda não voltou para cá". É um estado da sincronização, não da mensagem.

Por isso, quando uma mensagem está em "No relay" e você precisa saber o que houve com ela agora, o painel do Sender25 responde — veja Guia: Como acompanhar suas métricas de envio no Sender25, que também detalha os motivos de um Held.

Passo 7 — Mensagens que ficam no relay para sempre

Uma mensagem pode ficar parada em "No relay" (ou "Em trânsito", na tela do cliente final) indefinidamente, e isso pode ser normal. É o texto que a própria tela mostra:

Mensagens sem desfecho não são erro de sincronização
Elas chegaram ao relay sem um identificador que ele e o painel consigam casar — normalmente sistemas automáticos falando SMTP cru. Ficam no relay em vez de receberem um desfecho inventado.

Em termos práticos: um formulário de contato do site, um script de sistema ou uma aplicação que envia e-mail falando SMTP diretamente, sem passar pelos caminhos normais de envio, costuma gerar mensagens assim. O plugin prefere deixar essas mensagens sem desfecho a inventar um "entregue" que ele não pode garantir. Não é sincronização quebrada.


Problemas comuns

Uma mensagem está com "Falha permanente" (Falhou)

Aqui sim há o que investigar: o destino recusou a mensagem de forma definitiva (5xx). As causas mais comuns são destinatário inexistente, problema de reputação do remetente ou bloqueio pelo destino. Vale checar o motivo retornado pelo destino antes de reenviar.

Uma mensagem está com "Falha temporária" (Adiada) há um tempo

Normalmente não exige ação sua. A mensagem está sendo retentada automaticamente após uma resposta 4xx do destino — que é, por definição, um pedido para tentar de novo mais tarde.

Todas as mensagens de saída aparecem em "No relay", e nenhuma vira "Entregue"

Isso é diferente do caso normal do Passo 7 — ali só algumas mensagens específicas ficam sem desfecho. Se nenhuma mensagem está recebendo um desfecho, o mais provável é que falte a credencial de API do relay.

Abra a aba Diagnóstico e procure a linha Sincronização com o relay. É ela que responde, e há três respostas possíveis:

O que a linha mostraO que significa
não configurada
"Informe a URL e a chave de API em Configurações. Até lá o rastreamento de entrada funciona e a saída fica no relay."
É este o problema. Falta a credencial. O rastreamento de entrada continua funcionando normalmente.
pendente
"Configurada; o coletor ainda não concluiu uma execução."
A credencial já está lá e a primeira sincronização ainda não terminou. Espere até um minuto e recarregue.
Um horário recenteA sincronização está funcionando. Se ainda assim nada vira "Entregue", a causa é outra.

A configuração dessa credencial éestá assuntoem deComo umconfigurar guiaa separado.credencial do relay no plugin. Ela fica na aba Configurações, que é também onde está o bloco Estado da sincronização, com Última sincronização bem-sucedida, última falha e falhas consecutivas — útil depois que a credencial já existe.


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