> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhalivre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cadastro no SenhaLivre

> Adicionar o ponto de acesso ao sistema SenhaLivre.

## 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

<Warning>
  **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.
</Warning>

<Info>
  **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.
</Info>

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

<Info>
  A refatoração da parte de status está em andamento para melhorar o suporte e exibição correta do status online/offline dos pontos.
</Info>

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

* [Criar Campanhas](/campanhas/introducao) — Configure campanhas para exibir aos visitantes
* [Gerenciar Visitantes](/visitantes) — Visualize e gerencie os dados coletados
* [Ver Relatórios](/relatorios) — Acompanhe métricas e desempenho

<Tip>
  Mantenha o endereço MAC e as credenciais anotadas em local seguro para facilitar manutenções futuras ou adição de novos pontos.
</Tip>