Skip to main content

Adicionar Ponto de Acesso

Agora que o AP está configurado e adotado pela controladora, é hora de cadastrá-lo no sistema SenhaLivre.

Passo 1: Acessar a Página de Pontos de Acesso

  1. No dashboard do SenhaLivre, acesse Pontos de acesso no menu lateral
  2. Clique no botão Adicionar ponto de acesso, localizado no canto superior direito

Passo 2: Preencher Informações

Preencha os dados do ponto de acesso:
  • Nome — Dê um nome identificador para o ponto (ex.: “Loja Centro - Entrada”)
  • Endereço MAC — Informe o endereço MAC do dispositivo
  • Marca — Selecione a marca do seu AP:
    • TP-Link — Para Access Points TP-Link (usando Omada Controller)
    • UniFi — Para Access Points Ubiquiti UniFi (usando UniFi Controller)
  • Local — Vincule o ponto a um local criado anteriormente
Atenção: O endereço MAC deve ser exatamente igual ao do dispositivo. Verifique o MAC na controladora ou no próprio AP para garantir que está correto. O formato pode variar (com ou sem dois pontos), mas o sistema normaliza automaticamente.
Importante: A marca selecionada determina como o sistema processa as requisições do portal. Certifique-se de selecionar a marca correta correspondente ao seu Access Point:
  • Se você está usando Omada Controller, selecione TP-Link
  • Se você está usando UniFi Controller, selecione UniFi
O sistema detecta automaticamente o tipo de controladora baseado na marca do AP cadastrado.

Passo 3: Criar o Ponto

  1. Revise todas as informações preenchidas
  2. Clique em Criar ponto de acesso
  3. O ponto será adicionado ao sistema

Verificar Funcionamento

Status do Ponto

Após o cadastro, o ponto aparecerá na lista de pontos de acesso. Inicialmente, pode aparecer como “offline” no painel, mas isso será corrigido no front-end em uma atualização futura.
A refatoração da parte de status está em andamento para melhorar o suporte e exibição correta do status online/offline dos pontos.

Testar o Hotspot

  1. Conecte-se à rede Wi-Fi do hotspot configurada na controladora
  2. Você deve ser redirecionado para o portal do SenhaLivre
  3. Uma campanha de imagem será exibida
  4. Ao final, será redirecionado para o site senhalivre.com.br

Coleta de Dados

Após a configuração completa:
  • Os visitantes que se conectarem ao hotspot passarão pelo fluxo da campanha
  • Os dados coletados serão registrados no sistema
  • Você poderá visualizar os visitantes na seção Visitantes
  • As métricas estarão disponíveis em Relatórios

Suporte a Múltiplas Controladoras

O SenhaLivre suporta múltiplas controladoras e marcas de Access Points:
  • TP-Link — Com Omada Controller
  • UniFi — Com UniFi Controller
O sistema detecta automaticamente o tipo de controladora baseado na marca do AP cadastrado, processando corretamente os parâmetros enviados por cada controladora.

Próximos Passos

Agora que o ponto está configurado e funcionando:
Mantenha o endereço MAC e as credenciais anotadas em local seguro para facilitar manutenções futuras ou adição de novos pontos.