Ir para o conteúdo principal

Guia: Como configurar a credencial do relay no plugin

Objetivo

Informar ao plugin a credencial do relay Sender25, que é o que faz o rastreamento de saída passar a mostrar o desfecho real de cada mensagem.


Escopo e Público

  • Aplica-se a: a aba Configurações do plugin, no WHM ou no DirectAdmin.
  • Não cobre: a emissão da credencial no painel do Sender25 — veja o capítulo Guia do Usuário.
  • Público-alvo: administrador do servidor de hospedagem.

Por que isso é o passo que falta

Sem credencial o plugin já funciona pela metade: o rastreamento de entrada é lido do próprio servidor e aparece na hora. Mas o desfecho da saída mora no relay, e o plugin só o obtém se puder perguntar.

Enquanto não houver credencial, toda mensagem de saída fica em No relay — status pendente (o que esse status significa está em Como ler os status de entrega). Isso é honesto — ninguém mediu o desfecho — mas não é o produto inteiro. É a causa mais comum de "instalei e não mudou nada".


Passos (sequência)

Passo 1 — Abrir Configurações

Na tela do plugin, aba Configurações. O bloco Credencial do relay é o primeiro.

image.png

Figura 1 - Configurações plugin

Passo 2 — Preencher os campos
Campo Padrão Observações
URL do relay vazio Sem ela, o plugin roda só com entrada.
Chave de API vazio Somente escrita: nunca é devolvida na tela e nunca vai para log. Depois de salva, o campo mostra apenas que existe — deixe em branco para mantê-la.
Hostname do relay detectado Como o relay aparece no log de e-mail. É assim que uma entrega ao relay é distinguida de uma entrega direta. O instalador tenta adivinhar; confira.
Intervalo de sincronização 60s Mínimo de 30s, imposto ao salvar.
Retenção 30 dias Vale apenas para os dados coletados por este plugin. O banco de e-mail do painel nunca é tocado.
Passo 3 — Salvar e conferir

Clique em Salvar configuração. Depois abra a aba Diagnóstico e olhe a linha Sincronização com o relay:

image.png

Figura 2 - Verificações

O que a linha mostra O que significa
não configurada A credencial não chegou. Volte a Configurações.
pendente
"Configurada; o coletor ainda não concluiu uma execução."
Está certo. A primeira sincronização ainda não terminou — espere até um minuto e recarregue.
Um horário recente Funcionando.

Na aba Configurações, o bloco Estado da sincronização detalha: última sincronização bem-sucedida, última falha e falhas consecutivas.

Passo 4 — Provar com uma mensagem real

Envie uma mensagem de teste por uma conta deste servidor e procure por ela no plugin um ou dois minutos depois. Se ela passou pelo relay, você deve vê-la sair de No relay para um desfecho final assim que a próxima sincronização terminar.


Problemas comuns

Salvei a chave e o campo voltou vazio

É o comportamento pretendido. A chave é somente escrita: o plugin nunca a devolve para a tela, porque uma tela que exibe credencial é uma credencial a mais circulando. Deixe o campo em branco ao salvar outras configurações e a chave atual é mantida.

A linha diz "pendente" há vários minutos

O coletor roda a cada minuto, mas pula o ciclo se o anterior ainda estiver rodando. Em servidor com muitas contas o primeiro ciclo é o mais demorado. Se passar de alguns minutos, veja o bloco Estado da sincronização em Configurações: falhas consecutivas maior que zero indica que a credencial ou a URL foram recusadas.

Mensagens antigas continuam em "No relay" depois de configurar

Esperado. O plugin passa a obter o desfecho das mensagens dali para a frente; ele não reconstrói o passado que nunca foi coletado.


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