Guia de Utilização

Como funciona

O cliente clica no link do e-mail e cai direto na página certa, já logado, sem digitar a senha.

Para onde cada link leva

O módulo identifica o tipo do e-mail e leva o cliente para a página correspondente.

Tags nos modelos de e-mail

Use as tags abaixo nos modelos em Configurações › Modelos de E-mail.

Exemplo: e-mail de fatura

Olá {$client_name},

Sua fatura #{$invoice_num} no valor de {$invoice_total} vence em {$invoice_date_due}.

Acesse e pague com um clique: {$login_link}
<!-- ou mantenha {$invoice_link}, que o módulo já substitui -->

Exemplo: e-mail geral (área do cliente)

Olá {$client_first_name},

Seus dados foram atualizados.
Acesse sua área do cliente: {$login_link}

Configurações do módulo

Configurações do Sistema › Módulos Addon › Auto Login MPAY › Configurar

Idiomas

O módulo é traduzido para 5 idiomas e escolhe o idioma sozinho.

Como o idioma é escolhido

• Telas do addon: idioma do perfil do administrador logado (Minha Conta › Idioma). Se estiver vazio, usa o idioma padrão do WHMCS.
• Página do cliente (quando o link não pode ser usado): idioma escolhido pelo visitante na área do cliente; senão, o idioma do cadastro do cliente dono do link; senão, o padrão do WHMCS.
• Guias: os botões do painel abrem o guia no idioma do administrador. No topo de cada guia há um seletor para trocar de idioma.
• Qualquer outro idioma usa o inglês.

Personalizar textos

Os textos ficam em modules/addons/autologinmpay/lang/, no mesmo formato $_ADDONLANG do WHMCS. Você pode ajustar uma frase editando o arquivo do idioma.

Expiração do link

O prazo é contado a partir do último envio de e-mail daquele link. Cada novo e-mail (um lembrete de fatura, por exemplo) renova o prazo.

Depois do prazo, o cliente vê a página "Este link expirou" (código AL-EXP), no idioma dele, com o botão para entrar com e-mail e senha.

Manutenção automática

Uma vez por dia, junto com o cron do WHMCS, o módulo organiza os links sozinho:

• Remove os links de faturas pagas com vencimento nos últimos 30 dias.
• Remove os links de tickets fechados.
• Remove os links de cotações entregues.
• Cria links para as faturas em aberto que ainda não têm um.

Diagnóstico

Abra pelo botão Abrir diagnóstico na configuração do addon, ou role a página do addon até o fim. Disponível só para administradores com acesso ao addon.

Verificações

Lista de checagem com status: autologin.php na raiz, pasta do módulo gravável, fuso horário PHP x MySQL, extensão cURL, versão do PHP e arquivos de idioma. Os detalhes técnicos (versões, fusos, coluna de tokens) ficam numa seção que abre e fecha.

Testar token de login (SSO)

Informe o ID de um cliente. São gerados dois links de teste:

• A: token exatamente como o WHMCS cria, sem a correção do módulo.
• B: token com a correção do módulo. Deve logar o cliente.

Abra cada link numa janela anônima diferente, em até 60 segundos. Se o link A der has expired e o B logar, o seu servidor tem a diferença de fuso do WHMCS 9, e o módulo já está corrigindo isso.

Reparar credencial de login

Se o teste do token falhar com invalid_client. client credentials are required, a credencial OAuth interna que o WHMCS usa para criar tokens de login não pode ser lida, normalmente porque o banco de dados foi copiado de outra instalação (outra chave de criptografia). A linha Clientes OAuth do WHMCS mostra o estado de cada credencial, sem exibir segredos.

Nesse caso aparece o botão Reparar credencial e testar. O módulo guarda uma cópia da credencial original, tenta gravar um segredo novo com a chave atual (ou fazer o WHMCS recriá-la) e testa criando um token de verdade. Se nada funcionar, tudo volta exatamente como estava. O resultado fica registrado no Log de Atividades.

Testar link do e-mail

Informe o código do link (o valor depois de short=, por exemplo autologin.php?short=8b3f9f7f9943b). O diagnóstico chama o link duas vezes e verifica se algum cache está devolvendo o mesmo token.

Debug e logs

Log de Atividades

Erros importantes são sempre registrados com o prefixo [AUTO LOGIN] em Configurações › Logs do Sistema › Log de Atividades.

Log de Módulos (com Debug ativo)

Com o Debug ligado, cada etapa aparece em Configurações › Logs do Sistema › Log de Módulos, filtrando por autologinmpay. O Log de Módulos também precisa estar ativado no WHMCS.

Segurança

• Cada link tem um código aleatório e difícil de adivinhar, exclusivo de um cliente e de uma fatura, ticket ou cotação.
• O token de login é de uso único e é criado só no momento do clique.
• Clientes com conta encerrada não conseguem entrar pelo link.
• O link nunca fica em cache: cada acesso gera um token novo.
• Diagnóstico e permissões só abrem para administradores com acesso ao addon.

Mensagens e erros

Quando o acesso automático não é possível, o cliente vê uma página com a marca da sua empresa, uma mensagem amigável no idioma dele, o botão Entrar na área do cliente e um código para o suporte.

Mensagens do próprio WHMCS

Perguntas frequentes