ISPFY com IA no atendimento
Adapter construído sobre a collection oficial do ISPFY. Durante a construção descobrimos que a API perdia 24 de 39 cobranças por um detalhe de serialização do PHP, e que dinheiro vem como centavo em texto. Corrigido no mapeador, não no discurso.
O que a IA faz
- Identifica o assinante por CPF
- Informa status de conexão e plano
- Envia 2ª via com linha digitável e PIX
- Faz desbloqueio de confiança por 3 dias
- Abre chamado no setor certo
Ficha técnica: o que a IA faz no ISPFY
Isto não é uma tabela de marketing. É a superfície real da API do fornecedor, do jeito que o produto a enxerga.
- Histórico de conexõesA consulta de sessões existe, mas ignora qualquer filtro: pedir as sessões de um assinante devolve as de outros. E a tabela cresce sem limite, ordenada da mais antiga: achar as sessões recentes de um cliente exigiria baixar o histórico inteiro do provedor a cada pergunta. O agente informa a última conexão, que vem no status do ponto.
- Consumo diárioA consulta de consumo soma os registros de conexão que caem no intervalo pedido, e cada registro traz o total acumulado de uma sessão inteira, carimbado no dia em que foi fechado. Pedindo dia a dia, a metade dos dias não tem registro nenhum e o dia que tem recebe o tráfego de semanas. Medindo 25 acessos, a mediana foi 2 dias com resposta em 7. O agente informa o consumo do MÊS, que a mesma consulta responde corretamente.
- Aviso de incidente na regiãoNão há objeto de incidente na API, e a alternativa que parecia servir não sobrevive à medição: `/object/pop/device` traz uma flag `online` por equipamento, e `ponto.nas` casa com `device.ipv4` (5 de 5), o que daria para dizer 'o concentrador do seu bairro caiu'. Só que a tabela não tem carimbo de tempo (não dá para saber se a flag é de agora ou de ontem), e no único caso testável em 2026-08-21 ela mentia: o cliente atrás da base `ATIVE_BERNARDI`, marcada offline, estava ONLINE. Afirmar uma queda para quem está conectado atrasa o conserto real do cliente.
- Enviar fatura por e-mail/SMSNão há rota de envio de fatura pelos canais do ERP.
- Prorrogar vencimentoNão há endpoint de prorrogação de vencimento.
- Liberação temporáriaNão há rota de liberação temporária da internet. A liberação fica com a sua equipe.
- Adicionar mensagem ao chamadoA API expõe apenas criar e finalizar chamado, sem rota para adicionar interação.
- Transferir chamado para setorNão há rota de transferência de chamado.
- Ordens de serviçoO ISPFY não separa ordem de serviço de chamado.
- Consultar horários de visitaNão há rota de agenda ou disponibilidade na API do ISPFY.
- Agendar visita técnicaNão há endpoint de agendamento. O agente abre um chamado no setor técnico e um humano agenda.
- Sinal da ONU (RX/TX)A tabela de estações registra sinal de RÁDIO, não óptico. O próprio dado nomeia o setor de 5,8 GHz e traz CCQ de enlace sem fio. As leituras vão de -85 a -15 dBm, enquanto fibra vive entre -8 e -28, então tratar um pelo outro faria a IA declarar crítico um enlace saudável.
- Reiniciar ONUOperação de ONU é tela do sistema, não existe na API.
- Restaurar ONU de fábricaOperação de ONU é tela do sistema, não existe na API.
- Liberar MAC travadoAlteração de MAC/serial é tela do sistema, não existe na API.
- Derrubar sessão (reconectar)O ISPFY envia o comando internamente pela interface, mas não expõe rota para disparar.
- Liberar franquia (FUP)Não há endpoint de liberação de franquia.
- Notas fiscaisNão há rota de notas fiscais na API.
- Trocar plano (upsell)A API tem `POST /tool/assinante/plano/teste`, que parece troca de plano e não é: ela concede um plano de TESTE com prazo (o ponto ganha um campo `testando_plano_ate`) e depois reverte sozinha. Vender um upgrade que expira em silêncio deixaria o cliente com a velocidade antiga e sem explicação, então a troca comercial continua com um humano. A listagem dos planos elegíveis por ponto existe e funciona: é upsell assistido, não automático.
A API do ISPFY não oferece agendamento de visita, mensagem em chamado existente, reinício de ONU nem desconexão RADIUS. Essas ações escalam para um humano. Exige HTTPS na porta 8043 e liberação do nosso IP no seu firewall.
Conectar o ISPFY ao seu atendimento
20 minutos de conversa para entender a sua operação e mostrar a IA atendendo com os seus dados.
Agendar demonstraçãoPerguntas frequentes
O ConectaAI integra com o ISPFY?
Sim. 9 ações confirmadas: cliente, 2ª via, desbloqueio e chamado. A conexão é feita na tela de integrações do ConectAI, com as credenciais do próprio provedor.
O que a IA consegue fazer com o ISPFY?
Identifica o assinante por CPF. Informa status de conexão e plano. Envia 2ª via com linha digitável e PIX. Faz desbloqueio de confiança por 3 dias. Abre chamado no setor certo.
O que a IA não faz no ISPFY?
Histórico de conexões: A consulta de sessões existe, mas ignora qualquer filtro: pedir as sessões de um assinante devolve as de outros. E a tabela cresce sem limite, ordenada da mais antiga: achar as sessões recentes de um cliente exigiria baixar o histórico inteiro do provedor a cada pergunta. O agente informa a última conexão, que vem no status do ponto. Consumo diário: A consulta de consumo soma os registros de conexão que caem no intervalo pedido, e cada registro traz o total acumulado de uma sessão inteira, carimbado no dia em que foi fechado. Pedindo dia a dia, a metade dos dias não tem registro nenhum e o dia que tem recebe o tráfego de semanas. Medindo 25 acessos, a mediana foi 2 dias com resposta em 7. O agente informa o consumo do MÊS, que a mesma consulta responde corretamente. Aviso de incidente na região: Não há objeto de incidente na API, e a alternativa que parecia servir não sobrevive à medição: `/object/pop/device` traz uma flag `online` por equipamento, e `ponto.nas` casa com `device.ipv4` (5 de 5), o que daria para dizer 'o concentrador do seu bairro caiu'. Só que a tabela não tem carimbo de tempo (não dá para saber se a flag é de agora ou de ontem), e no único caso testável em 2026-08-21 ela mentia: o cliente atrás da base `ATIVE_BERNARDI`, marcada offline, estava ONLINE. Afirmar uma queda para quem está conectado atrasa o conserto real do cliente. Enviar fatura por e-mail/SMS: Não há rota de envio de fatura pelos canais do ERP. Prorrogar vencimento: Não há endpoint de prorrogação de vencimento. Liberação temporária: Não há rota de liberação temporária da internet. A liberação fica com a sua equipe. Adicionar mensagem ao chamado: A API expõe apenas criar e finalizar chamado, sem rota para adicionar interação. Transferir chamado para setor: Não há rota de transferência de chamado. Ordens de serviço: O ISPFY não separa ordem de serviço de chamado. Consultar horários de visita: Não há rota de agenda ou disponibilidade na API do ISPFY. Agendar visita técnica: Não há endpoint de agendamento. O agente abre um chamado no setor técnico e um humano agenda. Sinal da ONU (RX/TX): A tabela de estações registra sinal de RÁDIO, não óptico. O próprio dado nomeia o setor de 5,8 GHz e traz CCQ de enlace sem fio. As leituras vão de -85 a -15 dBm, enquanto fibra vive entre -8 e -28, então tratar um pelo outro faria a IA declarar crítico um enlace saudável. Reiniciar ONU: Operação de ONU é tela do sistema, não existe na API. Restaurar ONU de fábrica: Operação de ONU é tela do sistema, não existe na API. Liberar MAC travado: Alteração de MAC/serial é tela do sistema, não existe na API. Derrubar sessão (reconectar): O ISPFY envia o comando internamente pela interface, mas não expõe rota para disparar. Liberar franquia (FUP): Não há endpoint de liberação de franquia. Notas fiscais: Não há rota de notas fiscais na API. Trocar plano (upsell): A API tem `POST /tool/assinante/plano/teste`, que parece troca de plano e não é: ela concede um plano de TESTE com prazo (o ponto ganha um campo `testando_plano_ate`) e depois reverte sozinha. Vender um upgrade que expira em silêncio deixaria o cliente com a velocidade antiga e sem explicação, então a troca comercial continua com um humano. A listagem dos planos elegíveis por ponto existe e funciona: é upsell assistido, não automático.