Login por CPF com Integração de Provedor

📦 Sistemas suportados

A configuração é parecida em todos, mudando apenas os campos de credencial:

• SGP — URL, Token e App
• IXCSoft — URL e Token (formato usuario:token)
• MK Solutions — URL, Token, Senha e Código do serviço
• TopsApp — URL, Usuário, Senha e Identificador
• ReceitaNet — URL e Token
• Hubsoft — URL, Client ID, Client Secret, Usuário e Senha
• MK-Auth — tem artigo próprio, veja "Como Configurar a Integração com MK-Auth"

🔑 Diferença para o login LDAP

As integrações de provedor pedem apenas o CPF na tela do WiFi. Quem confirma que o cliente existe é o seu ERP, usando as credenciais de API que você configurou.

Já o login LDAP pede usuário e senha, porque valida a credencial de cada pessoa no diretório da empresa. São usos diferentes: provedor para clientes de internet, LDAP para funcionários e alunos.

---

1️⃣ Obter as credenciais de API

Cada sistema gera as credenciais em um lugar próprio, geralmente em Configurações → API ou Permissões de acesso. Consulte o suporte do seu ERP se não localizar.

Sobre o token do IXCSoft

O IXC exibe a credencial no formato 209:e3736c8a97... — o número antes dos dois pontos é o usuário da API, e o resto é o token.

Você pode preencher de duas formas, ambas funcionam:

• Colar a credencial completa no campo Token e deixar o Usuário vazio
• Separar: 209 no campo Usuário e o restante no campo Token

2️⃣ Configurar no painel

1. Vá em Integrações no menu lateral
2. Localize o seu sistema e clique em Configurar
3. Preencha a URL e as credenciais
4. Escolha o Perfil de acesso
5. Clique em Salvar Configuração

3️⃣ Escolher o perfil de acesso

O Perfil de acesso define quanto tempo e qual velocidade o cliente recebe ao entrar pelo CPF.

É o que permite dar tratamento melhor a quem é cliente: enquanto um visitante que entra por e-mail recebe o perfil padrão do aparelho, quem se identifica pelo CPF pode receber mais tempo ou mais banda.

Deixando em branco, será usado o perfil padrão do aparelho.

4️⃣ Testar a configuração

Clique em Testar Configuração e informe o CPF de um cliente ativo. O resultado mostra cada etapa:

1. Conexão — o servidor foi alcançado
2. Autenticação — as credenciais de API foram aceitas
3. Consulta — o cliente foi localizado pelo CPF
4. Autorização — o contrato está ativo
5. Perfil — qual perfil seria aplicado

Se falhar, a etapa que parou indica exatamente onde está o problema.

---

🔧 Solução de problemas

"Não foi possível conectar"

• Confirme a URL, incluindo https://
• Verifique se o servidor aceita conexões externas
• Teste abrir o endereço no navegador

"Libere o IP deste servidor" (IXCSoft)

As credenciais estão corretas, mas o IXC recusa a origem da chamada. Acesse as configurações da API no IXC e adicione o IP do servidor do painel à lista de IPs liberados.

"Credenciais recusadas"

• Gere novamente o token no seu ERP e cole com atenção — espaços invalidam a chave
• Confirme que o usuário da API está ativo no sistema
• No IXCSoft, verifique se o número do usuário está correto

"CPF não encontrado"

O cliente não existe no ERP com esse documento. Confirme o cadastro e o número. Pode digitar com ou sem pontuação — o sistema remove automaticamente.

"Contrato não está ativo" ou "Cliente inativo"

O cliente foi encontrado, mas o contrato está suspenso, cancelado ou bloqueado. É o comportamento esperado: quem está com o serviço suspenso não deve entrar no WiFi. Regularize no ERP e teste de novo.

📖 Precisa de ajuda?

Entre em contato pelo menu Suporte, informando qual sistema você usa, qual etapa do teste falhou e a mensagem exibida.