SGP/TSMX#
A integração com o SGP (TSMX) cobre o essencial de um atendimento de provedor: identificar o cliente, gerar segunda via e PIX, ler o sinal da ONU e agir sobre a conexão.
Antes de começar#
Você precisa do endereço da API e das credenciais. E aqui está a parte que costuma travar a configuração: o SGP aceita mais de um método de autenticação, e o campo authMethod decide quais dos outros campos são obrigatórios.
| Campo | Para que serve |
|---|---|
baseUrl | Endereço da API do seu SGP |
authMethod | Qual método de autenticação será usado |
token | O token, no método que usa token |
app | Identificação da aplicação |
username | Usuário, no método que usa usuário e senha |
password | Senha, no método que usa usuário e senha |
Preencher os campos do método errado produz uma falha de autenticação que não diz qual campo faltou. Confirme com quem administra o SGP qual método a sua instalação usa antes de preencher.
Como fazer#
- Vá em Configurações → Integrações e escolha o SGP TSMX.
- Informe o endereço da API.
- Escolha o método de autenticação.
- Preencha só os campos daquele método.
- Teste a conexão.
- Confira a lista de recursos disponíveis.
O que ela consegue fazer#
Cadastro e cobrança#
| Recurso | Para que serve |
|---|---|
| Buscar Cliente no ERP | Identificar por CPF/CNPJ |
| Contrato | Plano e situação |
| 2ª Via de Boleto | Gerar a segunda via |
| Baixar Boleto PDF | O arquivo do boleto |
| Gerar PIX | Cobrança por PIX |
| PDF do Contrato | O contrato |
Rede e equipamento#
| Recurso | Para que serve |
|---|---|
| Conexões PPPoE (Radius) | Ver se o cliente está conectado |
| Ver Potência ONU | Ler o sinal óptico |
| Listar Fibra/ONU | Identificar o equipamento |
| Reiniciar ONU | Reiniciar remotamente |
| Desconectar Cliente | Derrubar a sessão |
| Limpar MAC | Liberar o MAC preso |
Liberação#
| Recurso | Para que serve |
|---|---|
| Desbloqueio Confiança | Liberar mediante promessa de pagamento |
| Liberar Temporariamente | Liberar por tempo determinado |
O que ela não tem, e o IXC tem#
Comparada ao IXC, faltam aqui: busca de cliente por telefone, consulta de faturas em aberto e pagas como recursos próprios, liberação permanente, e todo o bloco de cadastro de cliente, prospecto e lead.
Veja a comparação lado a lado em O que cada integração consegue fazer. Isso muda o desenho dos fluxos: sem busca por telefone, a identificação começa sempre pedindo o documento.
Recursos que agem#
Os blocos de rede e liberação mudam o estado do cliente. Antes de expô-los num fluxo ou como ferramenta de agente, autentique o cliente — veja Autenticação do cliente.
Desbloqueio por confiança tem consequência financeira: combine a regra com quem responde pela cobrança antes de automatizar.
Se algo der errado#
Falha de autenticação. Quase sempre é o método errado, ou campos do método errado preenchidos. Confirme com quem administra o SGP.
Conecta e os recursos falham. A credencial pode não ter permissão para aqueles endpoints no SGP.
A segunda via não gera. Confira se o contrato informado existe e se há título em aberto.
A leitura da ONU não retorna. Depende do equipamento e da OLT. Preveja o caminho para leitura ausente.
O PIX não é gerado. Confira se a cobrança por PIX está habilitada no SGP para aquela carteira.