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


Nenhum comentário para exibir
Nenhum comentário para exibir