Tudo o que você precisa para colocar seu Wi-Fi para vender e funcionar

Siga esta ordem na primeira configuração. Cada etapa tem um capítulo próprio nesta wiki.

1. Acesse o painelEntre no painel com o usuário e a senha recebidos na contratação. Toda a configuração é feita por lá, de qualquer navegador.
2. Conecte o equipamentoNo MikroTik, crie o túnel de VPN WireGuard e cadastre o roteador em Equipamentos. No Grandstream ou Omada, siga o capítulo da sua controladora.
3. Crie o hotspotEm Hotspots → Novo Hotspot, escolha a controladora e a rede. O painel prepara tudo sozinho (veja Cadastrar hotspot).
4. Configure o recebimentoCadastre o Mercado Pago ou o Efí Bank e crie seus planos.
5. Escolha os métodos de loginDefina como o cliente entra: PIX, WhatsApp, voucher, CPF de assinante ou cadastro (Métodos de login).
6. Deixe com a sua caraMonte o tema do portal, preencha os termos de uso e, se quiser, ative anúncios.
7. Teste com um celularConecte no Wi-Fi, faça um login completo e um pagamento de valor baixo. Se algo travar, consulte Solução de problemas.

A VPN liga o seu MikroTik ao nosso servidor por um túnel seguro. É por ela que o painel cria o hotspot, aplica bloqueios e lê o status do roteador, mesmo que ele não tenha IP público.

Requisitos

• MikroTik com RouterOS 7 ou superior (o WireGuard não existe no RouterOS 6).
• Acesso ao roteador pelo WinBox ou pelo terminal.
• Saída de internet liberada em UDP para o endereço do túnel informado no painel.

Passo a passo

1. Abra a tela de VPNNo painel, acesse VPN WireGuard e clique em criar um novo peer.
2. Dê um nome ao peerUse algo que identifique o local, como Loja-Centro. O painel reserva automaticamente um IP do túnel para esse roteador.
3. Copie o scriptO painel gera um script pronto do RouterOS com chaves, endereço e rota do túnel.
4. Cole no MikroTikAbra WinBox → New Terminal, cole o script inteiro e pressione Enter.
5. Confira o handshakeEm WireGuard → Peers, o campo Last Handshake deve mostrar poucos segundos. No painel o peer aparece como conectado.
6. Anote o IP do túnelEsse IP (faixa 10.8.x.x) é o que você vai usar como Host ao cadastrar o MikroTik.

Com a VPN ativa, cadastre o roteador para o painel conseguir configurá-lo pela API do RouterOS.

1. Crie um usuário de API no MikroTik

Use um usuário exclusivo para o painel, nunca o admin. No terminal do roteador:

/user group add name=iconect policy=api,read,write,policy,test,sensitive,ftp
/user add name=iconect group=iconect password=TroqueEstaSenhaForte
/ip service set api disabled=no port=8728

2. Cadastre no painel

1. Abra EquipamentosAcesse Equipamentos → MikroTik e clique em adicionar.
2. Preencha os dadosNome do equipamento, Host = IP do túnel da VPN, usuário e senha criados acima e porta da API 8728.
3. SalveO painel testa a conexão, gera um segredo RADIUS exclusivo para o equipamento, registra o roteador no servidor RADIUS e instala as regras de anti-compartilhamento.

3. Recomendações de firewall

Bloqueie o QUIC (UDP 443) para quem ainda não fez login. Sem essa regra, alguns aplicativos (WhatsApp, Instagram, YouTube) conseguem trafegar antes do pagamento:

/ip firewall filter add chain=forward action=drop protocol=udp dst-port=443 hotspot=!auth comment="Bloqueia QUIC sem login"

Os APs Grandstream são gerenciados pela GWN Cloud. O painel cuida do portal, dos usuários e do RADIUS; a política de portal e o SSID são configurados na própria GWN Cloud.

1. Conecte sua conta GWN Cloud ao painel

1. Ative a APINa GWN Cloud, ative o modo desenvolvedor da sua conta e gere um App ID e um Secret Key.
2. Cadastre a controladoraNo painel, acesse Equipamentos → Grandstream, informe App ID e Secret Key e salve. Use Testar conexão para confirmar.
3. Sincronize os APsO painel lê suas redes e seus APs pela API. O AP precisa estar online para o IP aparecer.

2. Crie o hotspot

Em Hotspots → Novo Hotspot → Grandstream, escolha o AP e informe o nome do SSID. Ao salvar, o painel mostra a URL do portal externo, o servidor RADIUS e o segredo RADIUS. Guarde essas informações para o próximo passo.

3. Configure o portal na GWN Cloud

1. Crie a política de portalVá em Wi-Fi → Política do portal (não use "Página inicial", que é só o visual do splash). Escolha portal externo e cole a URL do portal informada pelo painel.
2. Configure o RADIUSNa mesma política, preencha o servidor RADIUS de autenticação e de contabilização e o segredo exibidos pelo painel.
3. Libere os domínios antes do loginNas regras de pré-autenticação, libere *.topwifi.com.br, *.iconectline.com e os domínios dos bancos (lista em Solução de problemas).
4. Aumente o tempo do cliente não autenticadoAjuste para 10 minutos. Com 1 minuto, o cliente não consegue abrir o app do banco e voltar para concluir o pagamento.
5. Ligue a política no SSIDEm LAN sem fio → engrenagem do SSID, ative o captive portal e selecione a política criada.

Os APs Omada ficam na Controladora Central iConect. Você não precisa manter uma controladora própria.

1. Coloque seu AP na Controladora Central

Fale com o suporte para receber o site da sua empresa na Controladora Central e adotar seu AP nele. Anote o nome do site, o nome do AP e o MAC do AP (está na etiqueta do equipamento).

2. Crie o hotspot no painel

1. Novo hotspot OmadaEm Hotspots → Novo Hotspot → Omada, preencha: nome do hotspot, nome do site, nome do AP, MAC do AP e SSID.
2. Validação automáticaO painel confere na controladora se aquele MAC realmente está no site informado e busca o IP do AP sozinho.

3. Portal na controladora

O portal Omada é configurado como RADIUS Server com autenticação PAP e External Web Portal. Na Controladora Central isso já é feito pela equipe iConect quando o site é criado. Se você tiver controladora própria, use a URL do portal e os dados RADIUS que o painel exibe ao criar o hotspot.

O hotspot é a sua rede Wi-Fi com portal. No MikroTik, o painel monta toda a rede no roteador para você.

MikroTik: o que preencher

O que o painel cria no roteador

Ações na lista de hotspots

Na lista de hotspots, clique no ícone de cadeado para escolher como os clientes se conectam. Pode ativar vários ao mesmo tempo; eles aparecem como abas no portal.

Termos de uso e política de privacidade

Todos os métodos exigem o aceite dos termos. Preencha os textos da sua empresa nas configurações do painel. Sem texto cadastrado, o portal mostra "não configurado" no lugar.

Troque os métodos de login sozinho ao longo do dia. Exemplo: WhatsApp grátis de manhã e PIX à tarde.

1. Ative a automaçãoNo ícone de calendário do hotspot, ligue "Alternar métodos automaticamente" e escolha o fuso horário.
2. Crie as faixasPara cada faixa, marque os dias, o horário de início e de fim e os métodos liberados. Se o fim for menor que o início, a faixa atravessa a meia-noite.
3. Defina o padrãoEm "Fora dos horários", escolha o que vale quando nenhuma faixa estiver ativa.

O botão 🏪 Exemplo comércio cria um modelo pronto: WhatsApp das 08h às 14h, PIX das 14h01 às 18h e PIX fora do horário.

Liga e desliga o hotspot sozinho conforme o expediente do estabelecimento (MikroTik).

• Ative o controle de horário, escolha o fuso e marque os dias com horário de abertura e fechamento.
• Atalhos prontos: dias úteis 08h–18h, todos os dias 08h–22h e 24 horas.
• Ao desativar o controle, o hotspot é religado na hora.

A lista de hotspots mostra 🟢 Aberto ou 🔴 Fechado na coluna Horário.

Sua licença define quantos hotspots podem ficar ativos ao mesmo tempo. Hotspots pausados não contam.

Ao pausar

• O portal deixa de aparecer e mostra "Wi-Fi temporariamente indisponível".
• No MikroTik, o servidor de hotspot e o DHCP são desligados: ninguém pega IP nem navega.
• A vaga é liberada e você pode criar ou retomar outro hotspot.
• Nada é apagado. Planos, tema e configurações continuam guardados.

Ao retomar

Só é possível retomar se houver vaga. Exemplo: com licença de 1 hotspot e outro já ativo, pause o ativo antes de retomar este.

Uma tela de cadastro antes dos métodos de login, para você conhecer seu público e cumprir a LGPD.

• Você escolhe quais campos aparecem (nome, celular, e-mail, CPF, data de nascimento, endereço etc.) e quais são obrigatórios.
• A configuração vale para todos os seus hotspots.
• O cliente preenche uma única vez. Nas próximas visitas ele é reconhecido pelo aparelho e vai direto para o login.
• Desativando todos os campos, a etapa de cadastro some.

Os planos ficam em Planos PIX → Planos e são usados pelo PIX, pelo cartão, pelos vouchers e pelo PDV.

A aba 💰 Pagamentos mostra receita bruta, taxas, receita líquida, ticket médio, conversão, gráfico por dia ou mês, receita por método e exportação em CSV.

1. Pegue as credenciaisNo Mercado Pago, acesse Seu negócio → Configurações → Credenciais (ou o painel de desenvolvedores) e copie o Access Token e a Public Key de produção.
2. Cadastre no painelEm Planos PIX → Gateways, no card Mercado Pago, ative, cole as credenciais e salve.
3. Configure o webhookNo Mercado Pago, em Suas integrações → Webhooks, cadastre a URL abaixo marcando o evento de Pagamentos.
4. Escolha o banco do hotspotNos métodos de login do hotspot, ative o PIX e selecione Mercado Pago.

https://wifi.topwifi.com.br/webhook-mp.php

1. Crie a aplicaçãoNo app ou painel do Efí, acesse API → Aplicações, crie uma aplicação com o escopo de PIX e copie o Client ID e o Client Secret de produção.
2. Gere o certificadoEm API → Meus certificados, gere o certificado de produção e baixe o arquivo .p12.
3. Tenha uma chave PIXUse uma chave PIX cadastrada na conta Efí (CPF, CNPJ, e-mail, telefone ou aleatória).
4. Cadastre no painelEm Planos PIX → Gateways, no card Efí Bank, preencha Client ID, Client Secret, chave PIX, envie o .p12, ative e salve.

Configurado em Planos PIX → Métodos de Pagamento.

Cartão de crédito e débito

Com o Mercado Pago ativo (Access Token e Public Key), o cliente escolhe entre PIX e cartão depois de selecionar o plano. Defina o número máximo de parcelas; débito é sempre à vista.

Acesso grátis ao copiar o PIX

Libera a internet por alguns minutos quando o cliente toca em Copiar PIX, para ele abrir o app do banco e pagar.

Em Planos PIX → Configuração Login você decide em que momento o portal pede os dados do cliente.

Na mesma aba, a tabela de campos define quais dados aparecem, quais são obrigatórios e se valem para PIX, Free ou ambos.

Um plano gratuito que aparece junto com os pagos, ideal para atrair o cliente.

• Defina nome, selo (ex.: GRÁTIS), descrição, duração e velocidade.
• Intervalo de reuso: horas até o mesmo aparelho poder usar de novo. Zero significa uso único.
• Escolha em quais hotspots o plano Free aparece.

Códigos de acesso para vender no balcão, distribuir em eventos ou dar de cortesia.

Gerar um lote

1. Escolha o planoO voucher usa o tempo e a velocidade dos seus planos.
2. Defina o códigoQuantidade, tipo (só números, só letras ou misto), tamanho, separador e prefixo opcional.
3. Personalize a impressãoEnvie a logo do lote e, se quiser, ative o QR Code de conexão automática no Wi-Fi.
4. ImprimaOs vouchers saem em cartões lado a lado, com logo, nome da rede, código, plano e valor.

• A lista é organizada por lote: ver vouchers, imprimir todos ou só os disponíveis e excluir.
• O tempo do voucher conta a partir do primeiro uso. Ao voltar, o cliente digita o mesmo código e usa o tempo restante, sempre no mesmo aparelho.
• Vouchers usados entram no relatório de Pagamentos junto com o PIX.

Venda acesso no balcão pelo aplicativo de PDV, com voucher impresso na hora.

Pontos de venda

1. Crie um pontoEm Planos PIX → Configuração PDV, dê um nome ao ponto (ex.: Balcão Centro), o tempo de sessão, o rodapé e a logo do voucher.
2. Copie o tokenO token aparece uma única vez. Cole no aplicativo do PDV daquele aparelho.
3. Atendente entraLiberado o aparelho, o atendente faz login com e-mail e senha.

Você pode editar, revogar (o aparelho perde acesso na hora) ou excluir cada ponto.

Maquininha Mercado Pago Point

• Vincule a Point à sua conta pelo app do Mercado Pago e clique em Atualizar no painel.
• Clique em Ativar PDV e reinicie a maquininha.
• Use Testar para imprimir um cupom e confirmar a comunicação.

PIX por QR Code no PDV

Em Planos PIX → PIX QR, informe o token de uma aplicação Mercado Pago do tipo Pagamentos presenciais / QR Code, a cidade e o estado da loja. O painel cria a loja e o caixa automaticamente.

A forma mais rápida de usar o login por WhatsApp: você usa um número seu, conectado à nossa API.

1. Receba a instânciaA equipe iConect libera uma instância de WhatsApp para a sua conta.
2. Conecte o númeroNa tela de WhatsApp do painel, abra o QR Code e leia pelo celular em WhatsApp → Aparelhos conectados → Conectar aparelho.
3. Vincule ao hotspotSelecione qual instância cada hotspot usa. Sem escolha, é usada a instância padrão da sua conta.
4. Ative o métodoNos métodos de login do hotspot, ligue o WhatsApp.

Personalize a mensagem

Use as variáveis abaixo no texto do código de verificação:

{GREETING}, {NAME}! Seu código de acesso ao Wi-Fi é: *{CODE}*
Ele expira em {MINUTES} minutos. Não compartilhe este código.

Regras do acesso por WhatsApp

• Tempo de conexão: quanto tempo o cliente navega por login.
• Velocidade: limites de download e upload do acesso.
• Bloqueio entre acessos: tempo de espera antes do mesmo número pedir um novo código.

Para quem precisa de alto volume com número verificado. O envio é feito pela WhatsApp Business Platform, sem celular conectado.

Antes de começar

• Conta no Meta Business Manager com a empresa verificada.
• Um número de telefone cadastrado na WhatsApp Business Platform (não pode estar em uso no app WhatsApp).
• Um token de acesso permanente de usuário do sistema com permissão de mensagens do WhatsApp.

1. Cadastre as credenciaisNa configuração de WhatsApp do painel, escolha o tipo Meta e informe os dados da sua conta Meta.
2. Crie o template de códigoCrie um modelo de mensagem da categoria Autenticação com a variável do código, por exemplo codigo_verificacao, e aguarde a aprovação da Meta.
3. Selecione o templateNo painel, informe o nome do template aprovado e ative a API Meta para o hotspot.

Se você é provedor, seus assinantes podem usar o Wi-Fi sem pagar: o cliente informa o CPF ou CNPJ e o sistema consulta o seu ERP.

1. O cliente digita o CPF/CNPJPelo método CPF/CNPJ ISP ou pelo botão "Já sou cliente" do Cadastro.
2. O sistema consulta seus ERPsNa ordem SGP, IXC, MK-Auth e ReceitaNet, e por último os cadastros locais.
3. Contrato ativo liberaAssinante com contrato ativo navega com a velocidade e o tempo configurados para clientes.
4. Não encontrado ou bloqueadoQuem não é assinante segue para o PIX. Contrato suspenso, cancelado ou com fatura em aberto (MK-Auth) recebe a mensagem do motivo.

1. Gere o acesso no SGPNo seu SGP, crie um token de integração da API de URA e anote o nome do app e o token.
2. Configure no painelAbra a integração SGP, informe a URL do seu SGP (ex.: https://seuprovedor.sgp.net.br), o app e o token e ative.
3. Defina os limitesConfigure a velocidade de download e upload e o tempo de sessão dos assinantes.

Entra quem tiver ao menos um contrato com status Ativo. Outros status mostram ao cliente a situação do cadastro.

1. Crie o token no IXCNo IXC, gere um token de API para um usuário com permissão de leitura de clientes e contratos.
2. Configure no painelInforme a URL do seu IXC e o token, defina os limites dos assinantes e ative.

Libera clientes com status ativo. Cancelados, bloqueados, suspensos e inativos recebem a mensagem correspondente. O nome do plano do contrato é registrado no acesso.

1. Crie a aplicação no MK-AuthGere um Client ID e um Client Secret de API.
2. Configure no painelInforme a URL do MK-Auth, as credenciais e se o certificado SSL deve ser validado. Defina os limites e ative.

1. Pegue o token da URANo sistema ReceitaNet, acesse Integrações → URA e copie o token.
2. Configure no painelAbra a integração ReceitaNet, cole o token e use Testar conexão.
3. Defina os limitesConfigure velocidade e tempo de sessão para clientes e não clientes e ative.

Contrato Ativo libera o acesso. Contrato Suspenso ou inativo é recusado.

O método Cadastro abre uma tela de boas-vindas com dois caminhos.

A configuração de não clientes fica dentro de cada integração (aba Não Clientes): velocidade, tempo de sessão, inatividade e controle de sessões.

O tema é a cara do seu portal: logo, cores, fundo e textos. Todo hotspot novo começa com o tema padrão.

Atribuir a um hotspot

Cada hotspot pode ter o próprio tema. Hotspot sem tema atribuído usa o primeiro tema da sua conta e, se não houver nenhum, o tema padrão do sistema.

Mostre imagens e vídeos em tela cheia para quem se conecta. Ótimo para divulgar promoções do estabelecimento ou vender espaço para parceiros.

Modos de exibição

Opções do anúncio

• Carrossel: várias imagens e vídeos no mesmo anúncio, cada um com seu tempo de exibição.
• Permitir pular: mostra o botão "Pular". Desligado, o anúncio fecha sozinho ao final.
• Link: adiciona o botão "Saiba mais" e contabiliza os cliques.
• Hotspots: escolha em quais redes aparece. Sem seleção, aparece em todas as suas redes.
• Métodos de login: exiba só para quem entra por PIX, WhatsApp, voucher etc.

Com vários anúncios ativos, o sistema faz rodízio e cada cliente vê um anúncio diferente a cada acesso. Visualizações e cliques ficam registrados em cada anúncio.

Transforme seu Wi-Fi em mídia: comerciantes da região compram espaço de anúncio direto com você.

• Envie ao anunciante um link de convite para ele se cadastrar.
• Ele escolhe o plano de anúncio, envia as mídias e paga por PIX.
• O pagamento cai na sua conta e o anúncio roda apenas nos seus hotspots.
• Você acompanha pedidos e planos de anúncio pelo painel.

Impede que alguém fique conectado ao Wi-Fi aproveitando os sites liberados sem nunca fazer login.

O cliente vê um contador no portal com o tempo restante para logar. Se for bloqueado, aparece uma tela com o motivo e o horário de liberação. Configuração em Configurações do Sistema.

Detecta quem paga um acesso e roteia a internet do celular para outras pessoas (MikroTik).

• O dono do compartilhamento vê "Acesso suspenso" com o passo a passo para desligar o roteador do celular.
• Quem pega carona vê um aviso de conexão compartilhada e um convite para contratar o próprio acesso.
• Escolha bloqueio por tempo fixo ou bloqueio até a pessoa parar de compartilhar. A cada reincidência, o tempo aumenta.
• Pelo painel você libera usuários bloqueados e gerencia a lista de aparelhos liberados.

As regras são instaladas automaticamente ao cadastrar o MikroTik.

O Marco Civil da Internet exige que provedores guardem os registros de conexão. O iConect faz isso por você.

• As conexões ficam registradas com usuário, MAC, IP interno, portas, IP de destino e horário.
• Na página Logs de Porta, busque por usuário, IP, MAC, período, hotspot, porta ou IP de destino.
• Exporte em PDF (com selo de integridade SHA-256) ou CSV para responder a ordens judiciais.
• Toda busca e exportação fica registrada em auditoria.

Envie eventos do hotspot para outros sistemas (CRM, n8n, planilhas, automações de WhatsApp) em tempo real.

1. Cadastre a URLNa tela de Webhooks, informe a URL do sistema que vai receber os dados.
2. Escolha os eventosEx.: ao criar uma ordem de pagamento, ao confirmar o pagamento ou ao conectar.
3. TesteFaça um login ou pagamento de teste e confira a chegada dos dados no seu sistema.

O evento de criação de ordem envia, entre outros, nome, telefone, e-mail, CPF, valor, plano, duração, gateway, status e o PIX copia e cola, ideal para cobrar o cliente que gerou o PIX e não pagou.

Domínios que devem estar liberados antes do login

No walled garden do MikroTik ou nas regras de pré-autenticação do Grandstream e do Omada:

*.topwifi.com.br
*.iconectline.com
*.mercadopago.com
*.mercadopago.com.br
*.mlstatic.com
*.efipay.com.br
*.gerencianet.com.br
*.sejaefi.com.br
*.bcb.gov.br

Central de Ajuda do Top Wifi by iConect Line