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.
  • 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. Isso é honesto — ninguém mediu o desfecho — mas não é o produto inteiro. É a causa mais comum de "instalei e não mudou nada".


⚠ Não é a credencial do provisionamento

Existe uma confusão de nome que custa tempo. O que o plugin precisa é uma Credencial do tipo API, emitida no painel do Sender25 para este servidor específico.

Ela não é o usuário e senha que ficam no /etc/sender25/config.conf do servidor. Aquilo pertence ao provisionamento, que é outro sistema, e não abre a API de consulta de entregas.

Se o seu servidor ainda não tem uma credencial de API emitida, esse é o impedimento real — e não algo no instalador ou no plugin.


Passos (sequência)

Passo 1 — Abrir Configurações

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

📷 Espaço para imagem — config-bloco-credencial-relay.png
O que precisa aparecer: a aba Configurações com o bloco Credencial do relay em foco, mostrando os campos URL do relay, Chave de API e Hostname do relay.
Onde capturar: Plugin → Configurações. ⚠ Não capture com uma chave real preenchida.

Passo 2 — Preencher os campos
CampoPadrãoObservações
URL do relayvazioSem ela, o plugin roda só com entrada.
Chave de APIvazioSomente 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 relaydetectadoComo 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ção60sMínimo de 30s, imposto ao salvar.
Retenção30 diasVale 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:

📷 Espaço para imagem — diagnostico-sincronizacao-nao-configurada.png
O que precisa aparecer: a aba Diagnóstico, bloco Verificações, com a linha Sincronização com o relay marcada como não configurada. É o estado que o leitor está tentando sair, e reconhecê-lo na tela é metade do diagnóstico. Se possível, uma segunda imagem da mesma linha já com horário recente.
Onde capturar: Plugin → Diagnóstico, antes e depois de salvar a credencial.

O que a linha mostraO que significa
não configuradaA 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 recenteFuncionando.

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