Ir para o conteúdo principal

Guia: Como ler os status de entrega

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):

Chip Rótulo O que significa
Entregue Entregue O destino aceitou a mensagem — o único status que significa sucesso.
Adiada Falha temporária O destino pediu para tentar mais tarde (4xx). Será retentada.
Falhou Falha permanente Recusa definitiva do destino (5xx). Não será tentada de novo.
Retida Retida O relay está retendo a mensagem em vez de tentar a entrega.
Retenção cancelada Retenção cancelada A retenção desta mensagem foi liberada.
Erro Erro O processamento falhou antes de haver um desfecho.
No relay No relay — status pendente Saiu deste servidor e está no relay, sem desfecho reportado. Isto não é entrega.
Desconhecido Status desconhecido informado pelo relay Não foi possível determinar o desfecho, e ele nunca é tratado como sucesso.
Em andamento Em andamento Aceita 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.

image.png

Figura 1 - Mensagens e seus status

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.

image.png

Figura 2 - Email de saída interno

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:

Chip Rótulo O que significa
Em trânsito Em trânsito — destino não confirmou Saiu deste servidor; o destino ainda não confirmou. Isto não é entrega.
Retida Retida A mensagem está retida em vez de ser entregue.
Desconhecido Desfecho desconhecido Nã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.

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 Sender25 Plugin (administrador) Plugin (cliente final)
Sent Entregue Entregue
SoftFail Falha temporária (chip: Adiada) igual
HardFail Falha permanente (chip: Falhou) igual
Held Retida Retida
Error Erro igual
Pending Em andamento igual
não existe lá No relay — status pendente Em 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 mostra O 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 recente A sincronização está funcionando. Se ainda assim nada vira "Entregue", a causa é outra.

A configuração dessa credencial está em Como configurar a 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