Ajuda › Integração com ACS (TR-069)

Integração com ACS (TR-069)

Com o ACS ligado, o NexaChat conversa com o equipamento do cliente (ONU ou roteador): mostra se está online, o modelo, as redes Wi-Fi e os aparelhos conectados, e permite atualizar, trocar o Wi-Fi e reiniciar. Cada empresa usa somente o próprio ACS: o endereço e a chave que você cadastra nunca são usados para outra empresa.

Onde configurar#

Em Integrações › Sistema do provedor › ACS e diagnóstico no equipamento:

1. Marque Usar o ACS no Painel 360° e no robô.
2. Escolha o tipo: Tech ACS (API pública), GenieACS ou Simulado (para conhecer e treinar, sem mexer em nenhum equipamento).
3. Informe o endereço do seu ACS: domínio ou IP, com a porta se não for a padrão, por exemplo https://acs.seuprovedor.com.br ou https://acs.seuprovedor.com.br:8443 (também aceita o IP público). No Tech ACS, o NexaChat completa sozinho o caminho /api/public/v1.
4. No Tech ACS, cole o token da chave e o nome ou prefixo da chave. No GenieACS, informe usuário e senha da API NBI (porta 7557).
5. Clique em Salvar e depois em Testar conexão.

O token e as senhas ficam guardados cifrados e nunca voltam para a tela (aparece só o começo, como acs_…).

A chave do Tech ACS#

Crie no Tech ACS uma chave só para o NexaChat, com estes escopos:

• para consultar: devices:read, wifi:read, clients:read e operations:read;
• para as ações: devices:sync (atualizar), devices:reboot (reiniciar) e wifi:write (trocar o Wi-Fi).

O Testar conexão mostra cada permissão: ✓ funciona, ✗ falta na chave. As permissões de escrita não são testadas (o teste não altera nada) e são conferidas no primeiro uso.

Liberar o acesso do NexaChat#

O NexaChat fica na internet e acessa o ACS a partir do IP 179.48.12.138. Se o seu ACS tiver firewall ou restrição de IP na chave, libere esse IP. O ACS precisa ter um endereço público: endereços de rede interna (10.x, 172.16 a 172.31.x, 192.168.x) não são alcançados, e a tela avisa quando o endereço é interno. Acesso por VPN fica para o futuro.

Mensagens do teste#

• Não conseguimos alcançar o ACS: endereço ou porta errados, ACS fora do ar ou o IP 179.48.12.138 bloqueado no firewall.
• O endereço não foi encontrado (DNS): confira se o domínio está digitado certo.
• Certificado HTTPS vencido, autoassinado ou de outro endereço: corrija o certificado do ACS (por exemplo, com Let’s Encrypt) ou use o domínio que aparece no certificado.
• O ACS recusou a chave: token errado, revogado ou de outro ACS. Gere uma nova chave.
• O nome/prefixo da chave não corresponde: copie o nome exato da chave.
• A chave não aceita o IP do NexaChat: libere o IP 179.48.12.138 na chave.
• Falta a permissão…: edite a chave no ACS e marque o escopo indicado.

No Painel 360°#

Na aba Conexão, o cartão Equipamento mostra: situação (online ou offline) e último contato, modelo e firmware, IP WAN, sinal óptico, redes Wi-Fi 2,4 e 5 GHz e quantos aparelhos estão conectados.

• Atualizar: pede ao equipamento os dados mais recentes e acompanha até ele responder.
• Ver conectados: lista os aparelhos com o sinal de cada um (o MAC aparece mascarado).
• Alterar Wi-Fi: nome e senha de cada rede, com confirmação. A senha precisa ter de 8 a 63 caracteres, letras e números, sem acento e ser diferente do nome da rede.
• Reiniciar equipamento: com confirmação e o aviso de que a internet do cliente cai por 1 a 3 minutos. O reinício só se confirma quando o equipamento volta a falar com o ACS.

O equipamento é encontrado pelo login PPPoE do contrato no ERP. Se não for encontrado, vincule manualmente pelo número de série, MAC ou login. Se mais de um equipamento corresponder, a tela mostra as opções para você escolher.

Ver o equipamento e fazer as ações exige o nível Técnico do Painel do cliente no perfil de permissões do atendente (dono e administradores já têm). Tudo fica na auditoria e na linha do tempo do cliente, com o código da operação do ACS. Para evitar derrubar a internet do cliente sem querer, cada equipamento aceita no máximo 3 reinícios por hora pelo painel e 5 trocas de Wi-Fi por hora.

No robô (modelo “Atendimento de provedor”)#

• Sem conexão: o robô consulta o equipamento. Se estiver offline, orienta conferir energia e cabos e oferece abrir um chamado. Se estiver online, oferece reiniciar (só com o “sim” do cliente) e acompanha até ele voltar.
• Lentidão: informa quantos aparelhos estão conectados e dá dicas antes do roteiro de reinício.
• Troca de senha do Wi-Fi: só para o cliente que já se identificou pelo CPF/CNPJ. O robô envia um link seguro de uso único (vale 20 minutos). A senha nova é digitada nessa página e vai direto para o equipamento: não passa pela conversa e não fica guardada.

Sem ACS configurado, ou se o equipamento não for encontrado, o robô segue o caminho de sempre (status do ERP e roteiro de reinício). Em conversas de teste (simulador), reiniciar e trocar o Wi-Fi são apenas simulados.

Segurança#

A senha do Wi-Fi nunca aparece na tela depois de salva e nunca vai para logs, webhooks, transcrições ou relatórios. Na demonstração do NexaChat, só o ACS simulado altera equipamentos.