--- title: "Como instalar o Hotspot Social na Controller UniFi - Homologado até versão 10.4.57" url: "https://ajuda.hotspotsocial.com.br/pt/article/configurar-unifi-network-controller-para-usar-com-o-hotspot-social" language: "pt" last_updated: "2026-08-10T17:55:48.034Z" --- # Como instalar o Hotspot Social na Controller UniFi - Homologado até versão 10.4.57 Como instalar o Hotspot Social na controladora UniFi (atualizado) **IMPORTANTE**: - Ao usar o Hotspot Social com o UniFi Controller **NÃO** é gerado o **LOG do Marco Civil**.  - Recomendamos que **faça o backup das configurações do UniFi Controller** **antes de configurar o Hotspot Social**. - É necessário ter um servidor DHCP na rede. - É necessário criar um usuário de acesso administrador para o Hotspot Social na controladora. - Os APs UniFi devem estar sempre conectados ao mesmo UniFi Controller que foi configurado o Hotspot Social. - Não há bloqueio das redes sociais antes do usuário finalizar a conexão. - Não é possível realizar a troca do SSID dos APs pelo painel do Hotspot Social, a troca deve ser realizada diretamente pelo UniFi Controller. - Não é possível desconectar o usuário pelo Dashboard do painel do Hotspot Social. - A autenticação dos usuários do Hotspot Social é realizada externamente em nossos servidores Radius. - Nas imagens do material foi utilizado a **Unifi Network Controller** versão **9.5.21. (Nas novas versões, o painel legacy não está disponível, crie o usuário local com permissão máxima ou realize o processo via** [**API Key**](https://ajuda.hotspotsocial.com.br/pt/article/configurar-unifi-network-controller-para-usar-com-o-hotspot-social#configurando-o-hotspot-social-em-um-unifi-controller-(api-key):)**)** - Em Configurações > Perfil de conexão não é possível alterar o tempo de inatividade. - Em Configurações > Perfil de usuários Hotspot, as limitações não estão disponíveis. ## **Configurando o Hotspot Social em um UniFi Controller (Usuários Local):** Nas versões mais novas, todo o processo de configuração é feito pelo Hotspot Social via API, inicialmente é necessário criar o usuário administrador para podermos realizar as configurações, recomendamos realizar a configuração com a visualização Legado (Legacy) ### **PARTE 1:** Criando usuário Na imagem, mostramos como alterar a visualização para esse modo: ![](https://files.wifimanager.online/up/summernote/d41d8cd98f00b204e9800998ecf8427e3398.png) Na controller com a visualização "Legacy", acesse o menu **Settings >** **Admins** e clique em **"add new admin"**![](https://cdn-assets.productfruits.com/05c473f5-6c42-48f5-bafd-dcabda3e06dd)Após, crie o usuário definindo ele com a permissão de **"Administrador",** também, desmarque a opção **"Remote Acess"** (O usuário deve ser criado como local controller para conseguir fazer a comunicação e configurações.) ![](https://cdn-assets.productfruits.com/1695de06-cc40-4317-bd34-9abf0741f811) ### **PARTE 2:** Painel do Hotspot Social Com o usuário criado, acesse agora o painel do Hotspot Social para vincularmos a controller na licença que vai ser instalado, vá no menu **Revendas > Licenças Hotspot**, localize a licença que vai instalar e clique em **Ações > Vincular Cliente Final:** ![](https://files.wifimanager.online/up/summernote/d41d8cd98f00b204e9800998ecf8427e8923.png)Agora, preencha os dados, ao escolher a opção de equipamento **"UNIFI"**, será exibido o campo para escolher se a instalação vai ser na versão **7.3 ou inferior**, ou na **versão 7.4 ou superior**, escolha a 7.4. Assim que escolher ela, também vão aparecer os campos para informar o **usuário e senha que foi criado na controladora**, **junto a sua URL** para comunicação. ![](https://cdn-assets.productfruits.com/7234878b-57fc-4917-a2ab-4928b847784b) Após preencher os campos, escolha o site onde será configurado o Hotspot Social (Abaixo serão listados os APs conectados ao site) Pronto, feito isso, o Hotspot Social será configurado na Controladora UniFi. Se adicionar um novo Acess Point nela, lembre-se de sincronizar com a licença, isso pode ser feito a qualquer momento em **Revendas > Licenças Hotspot > Ações > Sincronizar APs.**   ![](https://cdn-assets.productfruits.com/7c7988da-8351-48ab-8f98-f2f5bb2ab713) Em caso de dúvidas, entre em contato com nossa equipe de suporte pelos canais de atendimento. ## **Configurando o Hotspot Social em um UniFi Controller (API Key):** A integração via API Key é realizada caso não consiga criar o usuário local, ou disponibilizar a controller em nuvem, no caso de uso de equipamentos locais como UDM, sendo o UniFi o Gateway da rede.   ### **PARTE 1**: Ligar o acesso remoto (leva 2 minutos) 1\. Abra a sua controladora UniFi como você já faz. 2\. Vá em Configurações (o ícone de engrenagem). 3\. Procure por uma destas opções, conforme a sua versão:    - Sistema > Avançado > Acesso Remoto    - Sistema > Administração > Ativar Acesso Remoto    (em inglês: System > Advanced > Remote Access) 4\. Ligue a chave. 5\. Vai aparecer um pedido de login. Entre com uma conta Ubiquiti (a mesma do    site ui.com). Se ainda não tiver, dá para criar na hora, é grátis. 6\. Se a sua conta tiver verificação em duas etapas, ele vai pedir o código.   ![](https://cdn-assets.productfruits.com/84db7ab9-29dc-43fa-b93a-d10a43354ed4) Pronto. A parte da controladora acabou. ### **PARTE 2:** Gerar a chave de integração (leva 1 minuto) 1\. Acesse [https://unifi.ui.com](https://unifi.ui.com/), procure API no menu do lado esquerdo. 2\. Clique em Create API Key (Criar chave de API). 3\. Dê um nome que você reconheça depois, por exemplo "Hotspot Social". 4\. Copie a chave e nos envie.    ATENÇÃO: a chave só aparece uma vez. Se fechar a tela sem copiar, é só    apagar e gerar outra. ![](https://cdn-assets.productfruits.com/29b38b26-0d40-4566-a35b-8a6cd65875dc) 5\. Junto com a chave, copie também o endereço que aparece no navegador quando    você está gerenciando a controladora.    ![](https://cdn-assets.productfruits.com/d4499bc1-356f-44fa-b0d2-eb8065c3505e) Ele se parece com isto:    [https://unifi.ui.com/consoles/ABC123XYZ.../network/default/dashboard](https://unifi.ui.com/consoles/ABC123XYZ.../network/default/dashboard)    Esse trecho no meio identifica qual controladora é a sua. ![](https://cdn-assets.productfruits.com/b5857f10-8ddb-408a-8008-39e84c92f6c9) PARTE 3: Painel do Hotspot Social Acesse agora o painel do Hotspot Social para vincularmos a controller na licença que vai ser instalado, vá no menu **Revendas > Licenças Hotspot**, localize a licença que vai instalar e clique em **Ações > Vincular Cliente Final:** ![](https://files.wifimanager.online/up/summernote/d41d8cd98f00b204e9800998ecf8427e8923.png)Agora, preencha os dados, ao escolher a opção de equipamento **"UNIFI"**, será exibido o campo para escolher se a instalação vai ser na versão **7.3 ou inferior**, ou na **versão 7.4 ou superior**, escolha a 7.4 e **habilite** a caixa **"Controladora sem acesso externo"**. ![](https://cdn-assets.productfruits.com/d7a85903-c51f-4c45-8168-75cb398357d4) Agora você vai preencher o primeiro campo com a **API Key** e o segundo campo com identificador da sua controladora (trecho no centro do link de acesso da sua controladora)   ![](https://cdn-assets.productfruits.com/c9ccb3fe-5f3d-4044-b6a7-73cf8d28854e) Após preencher os campos, escolha o site onde será configurado o Hotspot Social (Abaixo serão listados os APs conectados ao site) Pronto, feito isso, o Hotspot Social será configurado na Controladora UniFi. Se adicionar um novo Acess Point nela, lembre-se de sincronizar com a licença, isso pode ser feito a qualquer momento em **Revendas > Licenças Hotspot > Ações > Sincronizar APs.**   ![](https://cdn-assets.productfruits.com/7c7988da-8351-48ab-8f98-f2f5bb2ab713) ## **Configurações da Controladora** Após sincronizar os APs, se lembre de na rede Wi-Fi que vai utilizar, marcar a opção "Hotspot", além disso, entre nas configurações do Captive Portal da controladora e verifique se está de acordo com a opção abaixo Não é obrigatório, mas recomendamos habilitar também a caixa da seleção em vermelho ![](https://files.saas-chat.com/r/1/1/image_e0bdb694-2acc-4d5f-aafc-6d86077c5be7.png) Em caso de dúvidas, entre em contato com nossa equipe de suporte pelos canais de atendimento.