TopSapp (ERP)

Com o TopSapp conectado, a IA identifica o cliente pelo CPF ou CNPJ, sabe se o serviço dele está online, faz a liberação em confiança, abre suporte e consulta faturas direto no seu TopSapp, sem ninguém da equipe precisar abrir o sistema.

Antes de conectar

Você precisa de três coisas, todas criadas dentro do seu TopSapp:

• Um operador só para a ConectaAI, com acesso às rotinas que a IA vai usar (clientes, serviços, documentos a receber e suporte). Usar o operador de uma pessoa mistura o que a IA faz com o que essa pessoa faz.
• Um identificador liberado para a API. É o identificador de origem que o TopSapp exige em toda chamada. Sem ele liberado no seu TopSapp, a conexão é recusada.
• Um endereço com certificado SSL válido. Use um domínio com certificado apontado para o servidor do TopSapp, com a porta da API (normalmente 9910), por exemplo https://topsapp.seuprovedor.com.br:9910. A ConectaAI não aceita certificado inválido nem endereço sem https, porque a senha do operador viaja na requisição.

Como conectar

Abra a integração

Vá à Loja e abra o card TopSapp.

Preencha a aba Conexão

Informe o endereço do servidor, o operador, a senha do operador e o identificador. A senha e o identificador ficam guardados cifrados e nunca voltam a aparecer em claro na tela.

Rode o teste de capacidades

Na aba Capacidades, informe o CPF ou CNPJ de um assinante seu e clique em Testar capacidades. É esse teste que liga as consultas que dependem do formato da resposta do seu TopSapp (veja abaixo). Ele só lê: não abre suporte, não libera ninguém e não gera nada no seu sistema.

Ligue as ferramentas no agente

Conectar o ERP não liga sozinho as ferramentas no agente. Confira em Ferramentas nativas quais ações cada agente pode usar.

O que a IA faz assim que você conecta

• Identifica o cliente pelo CPF ou CNPJ.
• Diz se o serviço está online ou offline. Quando o TopSapp não informa o estado da conexão de um serviço, a IA não afirma nem um nem outro.
• Faz a liberação em confiança do serviço do cliente, pelas regras do seu TopSapp. A IA só diz que a internet voltou depois de conferir que o serviço ficou liberado; se a conferência não confirmar, ela diz que o pedido foi enviado.
• Abre suporte e acrescenta histórico a um suporte aberto do cliente.
• Envia a fatura por e-mail pelo próprio TopSapp.
• Derruba a sessão do cliente para ele reconectar.
• Confere se um pagamento foi registrado. A IA só diz que a fatura está paga quando o TopSapp informa a data do pagamento.
• Troca de plano, só se você ligar essa ação na aba Capacidades. Ela nunca vem ligada.

Abrir suporte: configure as categorias

O TopSapp exige, para abrir um suporte, a categoria e o técnico responsável. Na aba Categorias, escolha para cada categoria de atendimento a categoria do suporte e o técnico que recebe esses suportes. Categoria sem essas duas escolhas não abre suporte no TopSapp.

O que liga depois do teste de capacidades

Estas consultas seguem a documentação oficial do TopSapp, mas dependem do formato que a sua instalação responde. Elas começam desligadas e ligam quando o teste de capacidades confirma:

• faturas em aberto, 2ª via com linha digitável, PIX copia e cola e o boleto em PDF;
• faturas já pagas;
• suportes abertos do cliente;
• sinal da ONU;
• histórico de conexões;
• lista de planos;
• sincronização da base de clientes.

Se uma delas não ligar, rode o teste de novo com o CPF de outro assinante, de preferência um que tenha fatura em aberto, fatura paga e suporte aberto.

O que a API do TopSapp não permite

Nestes casos a IA não age e passa o atendimento para a sua equipe:

• Prorrogar o vencimento de uma fatura.
• Encerrar ou transferir um suporte. O TopSapp exige o tipo de atendimento ou o técnico de destino, que ficam com a sua equipe.
• Agendar visita fora do próprio suporte, ou consultar horários livres.
• Reiniciar ou restaurar a ONU, liberar MAC ou liberar franquia.
• Consumo por dia, aviso de incidente por região e consulta de nota fiscal.

Quando a conexão falha

• “O TopSapp recusou o acesso”: confira o operador, a senha e se o identificador está liberado para a API no seu TopSapp.
• Endereço recusado: o endereço precisa começar com https:// e ter certificado válido. Sem isso a conexão é recusada.
• Demora ou tempo esgotado: confira se o servidor do TopSapp aceita conexões vindas da internet na porta da API.