Como podemos ajudar?

Vender o contrato é só a metade do caminho. Depois que o cliente assina e o financeiro gera a cobrança, ainda falta o passo que efetivamente coloca o assinante na internet: a ativação técnica. É o momento em que a rede física (fibra ou rádio) é conectada ao cadastro do cliente no sistema, um endereço IP é reservado para ele e o equipamento instalado na casa dele passa a existir, de fato, dentro do Quaza. Sem esse passo, o contrato fica "vendido" mas o cliente não navega. Este artigo mostra o caminho completo desse último passo: do cadastro do Pool de IP até a ONU do cliente ficar ativa e transmitindo.

Visão geral: os dois caminhos técnicos

O Quaza suporta dois modelos de rede para entregar internet ao assinante. Vale entender qual é o do seu provedor antes de seguir os passos:

• Rede tradicional via IP/PPPoE (rádio ou rede metálica): o cliente se conecta a um Concentrador (também chamado de Ponto de Acesso) e autentica via PPPoE. Quando a autenticação acontece, o RADIUS do sistema busca um endereço livre no Pool de IP vinculado àquele Concentrador e entrega ao cliente.
• Fibra óptica via ONU: o cliente tem uma ONU (Optical Network Unit) instalada, conectada a uma OLT (cadastrada no sistema como "Transmissor"). A ONU é vinculada ao login do cliente e, dependendo do Perfil configurado, pode operar em modo Router (ela mesma faz o PPPoE e consome um IP do Pool, exatamente como no caminho anterior) ou em modo Bridge (repassando a sessão para um roteador do cliente).

Em ambos os casos existe um Pool de IP por trás — a diferença é o que entrega o sinal até a casa do cliente: um rádio/concentrador ou uma ONU de fibra. Hoje a fibra é o padrão mais usado, então o restante deste artigo detalha o fluxo de ONU, mas o cadastro de Pool de IP é comum aos dois caminhos e é sempre o primeiro passo.

Passo a passo: cadastrando um Pool de IP

O Pool de IP é o "estoque" de endereços que o sistema distribui automaticamente aos clientes quando eles se conectam. Ele é cadastrado em duas etapas: primeiro o Pool em si (o "recipiente"), depois a faixa de endereços dentro dele.

1. Criar o Pool: acesse o cadastro de IP Pool e preencha:
   • Nome: identificação do pool (ex.: "Navegação Fibra Bairro X").
   • Versão: IPv4 ou IPv6. Essa escolha é travada depois de criado o pool — não é possível editar a versão de um pool já existente.
   • Uso: a finalidade do pool. As opções mudam conforme a versão escolhida:
     • Para IPv4: Navegação, Reservado ou Bloqueio (este último é usado para dar um IP restrito a clientes inadimplentes/suspensos).
     • Para IPv6: Navegação, Túnel, Reservado ou Bloqueio.
   • Entregar nome via radius: define se o sistema deve entregar o nome/identificação do pool via RADIUS ao concentrador durante a autenticação.
   • Percentual alerta: percentual de utilização do pool a partir do qual o sistema deve sinalizar que os IPs estão perto de se esgotar.
2. Adicionar a faixa de IPs ao pool: dentro da tela de IPs do Pool (IP Pool IPv4/IPv6), clique em Adicionar IPs e informe:
   • IP inicial e IP final da faixa. Se o IP final for deixado em branco, o sistema assume que é uma faixa de um único endereço (igual ao inicial).
   O sistema valida o formato dos dois endereços e exige que o IP inicial seja numericamente menor que o final. Antes de criar, ele mostra um aviso de confirmação informando quantos IPs serão gerados (a diferença entre os dois endereços, +1) — confira esse número antes de confirmar, pois faixas digitadas errado podem gerar milhares de registros de uma vez.
3. Conferir a grade de IPs: depois de criada, a listagem mostra, por IP: o Pool ao qual pertence, o próprio endereço, o Uso, se está Fixado (vinculado manualmente a um cliente específico) e se está Conectado (em uso por uma sessão ativa no momento). A coluna Usuário linka direto para o cadastro do cliente dono daquele IP.
4. Vincular o Pool ao Concentrador ou à ONU: o cadastro do Pool de IP, sozinho, não entrega nada — ele precisa estar referenciado no Concentrador (rede tradicional) que vai usá-lo para navegação/bloqueio, ou ser consumido via RADIUS quando a ONU do cliente autentica em modo Router. Se você alterar ou remover um Pool que já está em uso por Concentradores ou Grupos, o sistema avisa quais registros perderão essa referência antes de deixar salvar.

Passo a passo: da ONU "não autorizada" à ONU ativa

Quando uma ONU nova é fisicamente conectada a uma porta da OLT, ela não aparece direto no cadastro de ONUs do sistema. Ela cai numa lista de espera chamada ONU não autorizada — é aí que o técnico/administrador identifica o equipamento e o libera para o cliente correto.

1. Pré-requisito — a OLT precisa estar cadastrada: em Fibra > Transmissor, a OLT do provedor precisa existir no sistema com fabricante/modelo, IP, credenciais de acesso (login/senha) e o Tipo de Provisionamento (Manual, Automático ou Automático Agregado). Sem a OLT cadastrada e habilitada, nenhuma ONU aparece.
2. Buscar as ONUs conectadas na OLT: na tela de "ONU não autorizada", use o botão Buscar não autorizadas, escolha a OLT (ou "Todas") e confirme. O sistema consulta a OLT via SNMP/API e lista tudo o que está fisicamente conectado nas portas PON e que ainda não tem cadastro de ONU ativo. Cada item aparece com Placa (slot), Pon, Serial (MAC) e Modelo detectado.
   Para OLTs da fabricante Parks é possível também inserir manualmente uma não autorizada informando Interface/Placa, Porta/Pon e Serial, caso ela não seja detectada automaticamente.
3. Abrir o registro da ONU não autorizada e vinculá-la ao cliente: ao editar um item da lista, o formulário muda de acordo com o fabricante da OLT (Huawei, ZTE, Fiberhome, Parks, Intelbras, Nokia, Datacom, etc. — cada um exige campos próprios de perfil/flow profile/gemport). Os campos comuns a preencher são:
   • Perfil: obrigatório sempre. Define o comportamento da ONU — Router (a ONU faz o PPPoE com login/senha do cliente), WAN Bridge ou Bridge pura (repassa a sessão para o roteador do cliente).
   • Nome: identificação da ONU. O sistema sugere um nome automaticamente com base no cliente/caixa/porta selecionados, mas pode ser digitado manualmente se a configuração da empresa permitir.
   • Caixa de atendimento e Porta: a caixa (CTO/NAP) e a porta física onde a fibra do cliente está conectada. Pode ser obrigatório dependendo da permissão configurada para o grupo do usuário.
   • Usuário (login), Condomínio ou Ponto de Acesso: é obrigatório informar pelo menos um dos três — normalmente o login do contrato do cliente que está sendo ativado. Ao selecionar o login, o sistema já verifica se aquele cliente possui reserva de porta feita previamente no mapa de rede e preenche caixa/porta automaticamente.
   • VLAN, PONID, MAC: normalmente preenchidos automaticamente a partir da placa/porta da OLT; não costumam precisar de edição manual.
   • Campos de Wi-Fi (nome/senha da rede) e Telefonia: só aparecem quando o modelo da ONU detectado suporta Wi-Fi embutido ou telefonia — nesse caso, nome e senha do Wi-Fi passam a ser obrigatórios.
4. Autorizar a ONU: com os campos obrigatórios preenchidos, use o botão Autorizar ONU e confirme no aviso. Nesse momento o sistema:
   1. Cria o registro definitivo da ONU (fora da lista de "não autorizadas");
   2. Envia a configuração para o equipamento físico na OLT (aplica o perfil, a VLAN, o Wi-Fi etc. diretamente na ONU);
   3. Se tudo correu bem, marca a ONU como Ativa e, se ela estiver vinculada a um login, libera o MAC reservado daquele contrato e normaliza o estado do contrato (tira de "pré-cadastro"/pendente de instalação, se for o caso);
   4. Redireciona para a tela da ONU já criada, mostrando um resumo da ativação.

Erros comuns

Situação	O que está acontecendo	O que verificar
A ONU não aparece na lista de "não autorizadas" mesmo depois de conectada na fibra	O "Buscar não autorizadas" consulta a OLT em tempo real; se a OLT estiver com Tipo de Provisionamento "Automático" ela segue outro fluxo (importação direta), e se a OLT/fabricante estiver desabilitada ou não corresponder ao filtro escolhido, ela nem aparece na busca.	Confira se selecionou a OLT correta (ou "Todas"), se o cadastro do Transmissor está com Estado = Habilitado, e se o modo de operação da empresa (Autorização Manual x Automática, em Configuração de ONU) é o esperado. Para OLTs Parks, use a inserção manual informando Interface/Placa, Porta e Serial.
Ao tentar autorizar, o sistema barra com mensagens como "É necessário informar o usuário, condomínio ou ponto de acesso" ou "Usuário é obrigatório para o modo selecionado"	Faltou vincular a ONU a alguém: nenhum dos três campos (login, condomínio, ponto de acesso) foi preenchido, ou o Perfil escolhido é do tipo Router (WAN ROUTE), que exige obrigatoriamente um login de contrato para fazer o PPPoE.	Selecione o login do contrato do cliente (campo Usuário) antes de autorizar. Se o cliente já tiver outro equipamento ativo vinculado ao mesmo login, o sistema também bloqueia com "O usuário selecionado já possuí um equipamento ativo no sistema" — nesse caso é preciso remover/desativar o equipamento antigo primeiro.
A ONU é autorizada, mas aparece um toast vermelho com uma mensagem de erro e ela não fica Ativa	O cadastro no sistema foi salvo, mas a aplicação da configuração diretamente no equipamento (via SNMP/telnet/API, dependendo do fabricante) falhou — normalmente problema de comunicação com a OLT, ONU que caiu da rede entre a busca e a autorização, ou combinação inválida de Perfil/Flow Profile/Gemport para aquele modelo.	Leia a mensagem exibida no toast (ela vem direto da resposta da OLT). Use o botão "Resumo da ativação" na tela da ONU para ver o histórico do que foi tentado, confira se a ONU segue conectada fisicamente na porta certa e tente aplicar novamente pelo botão "Aplicar configurações".
ONU ativa, mas o cliente reclama que não navega, e o sinal óptico está fora da faixa esperada	O sistema classifica automaticamente a qualidade do sinal (ONU TX, ONU RX e OLT RX) comparando com faixas mínimas/máximas cadastradas por fabricante em "Qualidade ONU" — sinal fora da faixa aparece destacado em amarelo/vermelho.	Abra a ONU, use "Atualizar leitura" para forçar uma nova coleta, e veja a aba "Leitura" (histórico de ONU TX, ONU RX, OLT RX, temperatura e voltagem). Um sinal RX muito baixo ou muito alto costuma indicar rompimento, emenda malfeita ou conector sujo na fibra — é um problema físico, não de cadastro.
Faixa de IPs criada errada no Pool (IPs a mais, a menos, ou sobrepostos)	O cadastro de faixa não faz merge nem detecção de sobreposição entre pools diferentes — ele cria um registro por IP dentro do intervalo informado, então um IP inicial/final digitado errado gera a quantidade exata (e só) do que foi pedido.	Sempre confira o número de IPs mostrado no aviso de confirmação antes de clicar em criar. Para remover IPs, use a remoção em massa pela grade — o sistema avisa separadamente se algum dos IPs selecionados está "Fixado" (vinculado a um cliente específico), pois removê-lo tira o IP fixo daquele contrato.

Como confirmar que deu certo

Depois de autorizar a ONU (ou de conectar o cliente via Concentrador/PPPoE tradicional), confira estes pontos para ter certeza de que a internet está realmente funcionando na casa do assinante:

• Status de conexão no topo da tela da ONU: quando a ONU está vinculada a um login e o contrato correspondente está com sessão ativa, o sistema exibe um selo verde "Conectado" no cabeçalho da tela de edição da ONU. Se aparecer "Desconectado", o cadastro está correto mas o cliente ainda não autenticou (roteador desligado, PPPoE errado no roteador do cliente, etc.).
• Aba "Leitura" (histórico de sinal óptico): mostra data, ONU TX, ONU RX, OLT RX, temperatura e voltagem da última coleta. Use o botão Atualizar leitura para forçar uma nova consulta na hora. Sinal dentro da faixa esperada (classificação verde/azul) é um bom indício de que a fibra está fisicamente saudável.
• Grade do Pool de IP: volte à listagem de IPs do pool usado e confira se o endereço entregue ao cliente aparece marcado como Conectado — isso confirma que o RADIUS de fato atribuiu um IP àquela sessão.
• Resumo da ativação: na tela da ONU recém-autorizada, o botão "Resumo da ativação" mostra o histórico de mensagens da última tentativa de aplicar configuração — deve constar "Configurações aplicadas com sucesso" sem erro na sequência.
• Acesso remoto ao equipamento: quando disponível para o modelo/fabricante, o botão "Acessar onu" abre a interface web da ONU em uma nova aba, permitindo conferir configuração e sinal direto na fonte.
• Vínculo com o cliente: os botões "Ver usuário" / "Ver condomínio" / "Ver ponto de acesso" na tela da ONU levam direto ao cadastro vinculado — use para confirmar que a ONU foi realmente presa ao contrato certo, e não a outro cliente por engano.