> Como conectar o TopSapp ao conecta/ai, o que a IA faz no seu TopSapp assim que você conecta, o que liga depois do teste de capacidades e o que a API do TopSapp não permite. # 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. > **Nota.** > **Uma empresa usa um ERP por vez.** Se a sua organização já tem outro ERP conectado, desconecte-o antes de conectar o TopSapp. ## 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 ## 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. > **Nota.** > **Até a sincronização ligar, o cliente entra pelo CPF.** O assinante passa a aparecer no conecta/ai quando a IA o identifica numa conversa. ## 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.