Integrações
API do SGP, Hubsoft, Voalle e MK Solutions: o que conferir antes de integrar o atendimento
Cada ERP de provedor tem a sua API, com autenticação, nomes de campos e limites próprios. Mas o que o atendimento precisa tirar de qualquer um deles é praticamente o mesmo: quem é o cliente, se ele está conectado, se tem conta em aberto e como abrir um chamado. Este guia organiza essas perguntas para você conferir na documentação do seu ERP antes de começar, seja ele SGP, Hubsoft, Voalle ou MK Solutions.
O que o atendimento precisa do ERP
| Dado | Para que serve | O que testar na API |
|---|---|---|
| Cliente por telefone | Identificar quem chama sem pedir CPF. | Se dá para filtrar por celular e em que formato o número está gravado. |
| Cliente por CPF/CNPJ | Plano B quando o número não está no cadastro. | Se o documento está com ou sem máscara. |
| Status da conexão | Responder "minha internet caiu" e detectar massiva. | Onde fica o online/offline e com que atraso ele atualiza. |
| Faturas em aberto | 2ª via, Pix e aviso de débito. | Filtro por cliente e status, e como obter boleto e Pix. |
| Desbloqueio | Liberar o acesso depois do pagamento. | Se existe rotina de desbloqueio de confiança pela API e quais regras ela segue. |
| Ordem de serviço | Abrir chamado técnico com os dados preenchidos. | Campos obrigatórios e como o chamado chega à equipe. |
| Localização na rede | Agrupar clientes por bairro, OLT ou CTO. | Se o vínculo com o equipamento existe no cadastro e está preenchido. |
Checklist antes de escrever a primeira linha
- Peça a documentação oficialSolicite ao fornecedor do ERP a documentação da API e, se houver, a coleção do Postman. Pergunte também pela versão instalada no seu provedor.
- Crie uma credencial própriaUm usuário ou token só para a integração, com permissão mínima. Nunca use o acesso de um funcionário.
- Pergunte pelos limitesQuantas requisições por minuto a API aceita e se há horários a evitar. Integração que derruba o ERP vira problema de todos.
- Teste com casos reaisCliente com dois cadastros, cliente cancelado, telefone em formato diferente, CPF com e sem máscara. São esses casos que quebram a integração.
- Confira datas e fusoVencimento e última conexão precisam estar no formato e no fuso esperados, ou o agente erra o "está vencido".
- Combine quem responde o quêSe o ERP ou a plataforma já tem um robô próprio, defina qual automação atende cada assunto para não haver dois robôs na mesma conversa.
Notas por ERP
- SGP
- Comum em operações menores e muito citado como integração por ferramentas de atendimento. Confirme com o fornecedor o acesso de API do seu plano.
- Hubsoft
- O Monit360 já integra com o Hubsoft: cadastro, contrato, faturas, status de conexão, bairro e ordens de serviço.
- Voalle
- Mais presente em provedores maiores. Com bases grandes, paginação e limites de requisição merecem atenção desde o início.
- MK Solutions
- Tem robô de atendimento próprio. Ao integrar outro agente, deixe clara a divisão de assuntos entre os dois.
Perguntas frequentes
Onde encontro a documentação da API do meu ERP?
Com o próprio fornecedor: SGP, Hubsoft, Voalle e MK Solutions disponibilizam documentação para clientes. Peça também a versão instalada no seu provedor, porque campos e rotas mudam entre versões.
O Monit360 funciona com SGP, Voalle e MK?
O Monit360 funciona com IXC Provedor, Hubsoft e outros ERPs com API. A compatibilidade com o seu ERP e a sua versão é confirmada no diagnóstico, conferindo os dados da tabela acima.
Preciso de um programador para integrar o ERP?
Para uma integração que atenda clientes reais, sim, ou uma solução pronta. Os casos que quebram a integração (cadastros duplicados, formatos diferentes, falhas da API) pedem tratamento cuidadoso.