Portal de Caixas de Atendimento

Nova CTO

Nome / ID da CTO *

Referência / endereço

OLT

Em qual OLT esta caixa está ativada. Deixe em Automática para usar a regra atual (slot 1 + PON 11–16 = AN6000; resto = AN5516).

Localização no mapa não definida

Clique no mapa ou arraste o pino para fixar. limpar localização

Observação da CTO

Sem localização a CTO fica cadastrada normalmente, mas não aparece no mapa.

Histórico de sinal

1Histórico da porta

Situação agora

—

Cliente

—

ONU

—

Observação atual

Adicionar splitter

Identificação do splitter

Número de portas *

Slot (padrão)

PON (padrão)

OLT deste splitter

Use quando este splitter estiver ativado em uma OLT diferente da CTO. Em Herdar da CTO usa a OLT definida na CTO.

Slot/PON preenchem as portas do splitter. Ao editar, o número de portas só pode aumentar (ou recriar o mesmo, completando as que faltam) — clientes existentes são preservados.

Ajustar portas do splitter

Quantidade padrão desejada

Marque as portas que devem ser apagadas. Já sugeri as sobrantes (número acima do padrão) e as repetidas; portas ocupadas ficam desmarcadas por segurança.

Transformar splitter em CTO

Nome da nova CTO *

Referência / endereço

A localização você define depois, editando a nova CTO.

Transformar CTO em splitter

CTO de destino *

Cadastrar condomínio

Nome do condomínio *

Referência / endereço

Tipo de ligação

Quantas portas tem o splitter?

Nova unidade

Unidade / Apartamento

Nome do cliente *

Importar localizações

Cole abaixo a lista de localizações no formato nome,lat,lng (uma CTO por linha). O portal vai encontrar cada CTO pelo nome e atualizar apenas a localização — as portas e clientes não são alterados.

Alertas e avisos · configuração

Varredura automática

Frequência da varredura

Horário diário

Sinal ruim abaixo de (dBm)

Queda entre varreduras (dB)

Massa: mín. de portas

Massa: % da CTO/PON

Capacidade por PON

Recobrar alerta em aberto a cada (h)

Avisar no grupo sobre

Enviar o resumo mesmo quando não houver nada (nem alerta novo, nem em aberto) — desligado, a varredura só fala quando há problema Ignorar ONU desligada (dying gasp) — só alertar sinal baixo, link loss e offline

Avisar no grupo sobre: filtra o que vai para o Telegram/WhatsApp — novos, em aberto e resolvidos. Sinal baixo, queda, massa e ocupação de PON continuam aparecendo no sininho do portal, só não viram mensagem. ONU desligada pelo cliente (dying gasp) nem vira alerta, pela opção abaixo.

Recobrar alerta em aberto: enquanto o problema não for resolvido, a mensagem volta nesse intervalo com a lista "Continuam com problema". 0 desliga a cobrança — só avisa alerta novo ou que normalizou.

A varredura consulta todas as ONUs na OLT, atualiza o sinal das portas e gera os alertas. O timer do servidor dispara de hora em hora e só executa na hora escolhida aqui.

Telegram

Token do bot

Chat ID do grupo

Crie o bot no @BotFather (/newbot), adicione-o ao grupo da equipe, mande uma mensagem no grupo e abra https://api.telegram.org/bot<TOKEN>/getUpdates para ver o chat.id (negativo).

WhatsApp (Evolution API)

URL da Evolution

API key (global)

Instância

Números / grupos

A URL deve ser alcançável pelo servidor do sinal (se a Evolution roda na mesma máquina, http://127.0.0.1:8080). Vários destinos separados por vírgula.

Avisar quando um carro da frota passar perto de CTO com alarme

Raio (metros)

Alertas que avisam

Dias

Das

Até

Intervalo mínimo (min)

O aviso sai quando o veículo entra no raio. Enquanto ele ficar por perto não repete; se sair e passar de novo, avisa de novo. Intervalo mínimo 0 = a cada passagem; maior que zero limita dois avisos do mesmo carro na mesma CTO.

Alertas de sinal

A varredura automática consulta todas as ONUs na OLT todo dia às 03:00, atualiza o sinal das portas e avisa por Telegram/WhatsApp. Reconhecer tira o alerta do contador (continua aberto até normalizar); Fechar encerra — se o problema persistir, a próxima varredura abre outro.

PONs da OLT · capacidade e sinal

Usuários e permissões

Admin pode tudo · Usuário adiciona/remove clientes (marque Vendas para liberar também a viabilidade) · Vendas só vê a viabilidade.

Novo ponto no mapa

O que deseja fazer?

Tipo

Porta

Número da porta

Status da porta

Nome do cliente *

ID da ONU (Physical Address)

Slot

PON

Localização do cliente (opcional)

Observação da porta

Transferir cliente

Destino — CTO ou Condomínio

Trocar de splitter

Escolha a porta livre de destino em outro splitter desta CTO:

Importar planilha

Link público da planilha (ou ID)

A planilha precisa estar publicada na web ou compartilhada como “qualquer pessoa com o link”. Arquivo → Compartilhar → Publicar na web.

Reconheço automaticamente: blocos de CTO (linha com “CTO-...”), portas marcadas como LIVRE, e as colunas Nome, Porta, Slot, PON e Physical Address. Cada bloco vira um splitter dentro da CTO.

Integração TopSapp (ERP)

Vincula cada porta ocupada ao serviço do TopSapp pelo ID da ONU (serial FHTT, igual nos dois sistemas) e traz a localização do serviço (coordenada e endereço de instalação) para a porta. Cliente com mais de um serviço recebe a posição de cada instalação. Entram serviços liberados e bloqueados; desativados ficam de fora.

Credenciais da API

URL do TopSapp

Usuário (operador)

Identificador

Senha

Chave Google Geocoding (opcional)

Raio máximo da CTO (km)

Ignorar latitude/longitude do TopSapp e localizar só pelo endereço (rua, número, bairro, cidade) Sincronizar automaticamente todo dia às 04:30 — busca no ERP, grava sozinho só o que é seguro (mesmo serviço de antes, ou vínculo novo com o nome batendo) e avisa pelo Telegram/WhatsApp o que ficou para revisar

A senha e a chave ficam só no servidor (/opt/sinal/topsapp.env, permissão 600) e nunca voltam para o navegador. Cadastre o identificador em TopSapp > API e use um operador dedicado com acesso a todas as cidades. O servidor do TopSapp precisa aceitar conexões do servidor do portal na porta 9910. Sem a chave do Google, endereços sem coordenada são buscados no OpenStreetMap (mais lento, ~1 por segundo). Raio máximo: coordenada do ERP fora desse raio da CTO é ignorada e o serviço vai pelo endereço; resultado do endereço precisa estar na cidade cadastrada e dentro do raio. Porta cujo pino da integração não passa mais nessas regras entra em "Remover pino errado". Cliente cujo endereço/coordenada cai além do raio fica sem pino e vira um alerta "Cliente longe da CTO" no sininho.

Sincronização de localizações

A busca baixa os serviços do ERP, cruza com as portas e monta uma prévia — nada é gravado até você clicar em Aplicar. Ao aplicar, a coordenada do ERP sobrescreve a marcada à mão; o nome do cliente não é alterado. O estado anterior de cada porta fica guardado no servidor e Desfazer devolve tudo como estava (uma vez por aplicação).

Integração ACS (TR-069)

Liga cada cliente ao equipamento cadastrado no TECH ACS pelo ID da ONU da porta (o mesmo serial usado no TopSapp). No modal da porta e na prévia do cliente no mapa aparece o botão Painel do cliente, com sinal, histórico, WAN, roteador, Wi-Fi e aparelhos conectados.

Servidor principal — TECH ACS

Endereço do ACS

Nome / prefixo da chave

Token da API (KEY)

E-mail do painel TECH ACS (para o login PPPoE)

Senha do painel

A API pública não informa o login PPPoE dos equipamentos. Com o e-mail e a senha do painel, o servidor baixa o "CSV completo" do TECH ACS (MAC, serial e PPPoE de todos os equipamentos) a cada 30 min e liga cada roteador ao serviço do TopSapp pelo PPPoE. Use um usuário só de leitura; a senha fica só no servidor.

O token fica só no servidor (/opt/sinal/acs.env, permissão 600) e nunca volta para o navegador. Prefira o prefixo da chave no campo do nome: ele não muda se o nome amigável for alterado. Se a chave tiver restrição de IP, libere 138.94.88.29 (servidor do portal). Escopos usados: devices:read, wifi:read, clients:read, devices:sync, operations:read. Login e senha do painel não são necessários.

Outros servidores ACS

Servidores que rodam em paralelo ao TECH ACS (ex.: o GenieACS próprio, durante a migração). Aqui você cadastra, testa e ativa cada um.

Testar com uma ONU — TECH ACS

Cole o ID de uma ONU (ex.: FHTT12345678) para conferir se o ACS encontra o equipamento e ver o que ele devolve. Usa os campos acima mesmo sem salvar.

Importar ONUs (cruzamento por nome)

Carregue o arquivo importar_onus.json gerado no cruzamento. O sistema vai preencher ONUs faltantes e substituir ONUs divergentes, casando por CTO + splitter + porta + nome do cliente. Antes de gravar, mostra um resumo para você confirmar, e guarda um ponto de retorno para desfazer.

Arquivo de importação (.json)

Atividade recente

Prévia

Mapa de cobertura

Dashboard

Situação das CTOs

Sinal das ONUs lidas

Clientes adicionados e removidos · últimos 30 dias

PONs mais ocupadas

Viabilidade · 30 dias

Alertas abertos

SLA · link loss

Em andamento

Voltaram, mas o sinal não normalizou

Possível problema na rede

Possível problema no assinante

Histórico

Viabilidade técnica

Últimas consultas

Revisão de cadastro

—

CTOs da mesma PON

ScreenMonitor

Portal de Caixas de Atendimento

Atividade recente

Prévia

Mapa de cobertura

Dashboard

Situação das CTOs

Sinal das ONUs lidas

Clientes adicionados e removidos · últimos 30 dias

PONs mais ocupadas

Viabilidade · 30 dias

Alertas abertos

SLA · link loss

Em andamento

Voltaram, mas o sinal não normalizou

Possível problema na rede

Possível problema no assinante

Histórico

Viabilidade técnica

Últimas consultas

Revisão de cadastro

—

CTOs da mesma PON

Nova CTO

Histórico de sinal

1Histórico da porta

Adicionar splitter

Ajustar portas do splitter

Transformar splitter em CTO

Transformar CTO em splitter

Cadastrar condomínio

Nova unidade

Importar localizações

Alertas e avisos · configuração

Varredura automática

Telegram

WhatsApp (Evolution API)

Avisar quando um carro da frota passar perto de CTO com alarme

Alertas de sinal

PONs da OLT · capacidade e sinal

Usuários e permissões

Novo usuário

Novo ponto no mapa

Porta

Transferir cliente

Trocar de splitter

Importar planilha

Integração TopSapp (ERP)

Credenciais da API

Sincronização de localizações

Integração ACS (TR-069)

Servidor principal — TECH ACS

Outros servidores ACS

Novo servidor

Testar com uma ONU — TECH ACS

Importar ONUs (cruzamento por nome)