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