Superlógica Condomínios - Integração da API do Superlógica com PABX

Visão geral

A integração entre o PABX e a API da Superlógica permite que um sistema telefônico consulte automaticamente um CPF ou RG informado pelo usuário e envie por e-mail as cobranças em aberto vinculadas ao cadastro encontrado.

Essa funcionalidade é normalmente utilizada em centrais de atendimento automatizadas (URA/PABX), reduzindo a necessidade de intervenção manual para envio de segunda via de boletos.

Quando usar este artigo

Utilize este artigo quando desejar integrar um sistema PABX, URA ou outra solução de atendimento automatizado à API pública da Superlógica para consulta e envio de cobranças em aberto.

Sintoma ou cenário

A administradora deseja permitir que moradores solicitem automaticamente suas cobranças em aberto através de um atendimento telefônico automatizado, utilizando CPF ou RG como identificador.

Benefício para o usuário ou operação

Automatiza o envio de cobranças em aberto.
Reduz atendimentos manuais da administradora.
Permite integração com sistemas de PABX e URA.
Facilita o acesso dos moradores às suas cobranças.

Onde acessar / contexto de uso

A integração é realizada diretamente através da API pública disponibilizada pela Superlógica.

Pré-requisitos (Antes de começar)

Perfil Exato: Administrador da licença ou responsável técnico pela integração.
Recursos Sistêmicos: Licença com plano Enterprise I ou superior.
Insumos e Dados Técnicos: Nome da licença; CPF ou RG cadastrado no sistema; Sistema PABX ou URA com capacidade de realizar requisições HTTP.

Causas prováveis

Necessidade de automatizar o envio de cobranças em aberto para moradores através de atendimento telefônico.

Como fazer ou corrigir

Para realizar a integração, siga os passos abaixo:

Verifique se a licença possui plano Enterprise I ou superior.
Configure o PABX para realizar uma requisição HTTP para a URL abaixo:

http://LICENCA.superlogica.net/condor/atual/publico/emailcobrancasemaberto?cpf=NNNNNNNNNNN

Substitua:

LICENCA pelo nome da licença.
NNNNNNNNNNN pelo CPF ou RG informado pelo usuário.

Caso o documento esteja cadastrado com pontuação, a consulta poderá ser realizada utilizando o mesmo formato cadastrado:

http://LICENCA.superlogica.net/condor/atual/publico/emailcobrancasemaberto?cpf=151.599.401-54

Ao receber a requisição, o sistema pesquisará o documento informado na base de dados da licença.
Caso exista um cadastro correspondente, será enviado automaticamente um e-mail para o endereço vinculado à unidade contendo as cobranças em aberto.

Resultado esperado

Ao informar um CPF ou RG válido, o sistema localizará o cadastro correspondente e enviará automaticamente para o e-mail da unidade as cobranças em aberto existentes.

Quando escalar

A API retorna erro durante a consulta.
O e-mail não é enviado mesmo com cadastro localizado.
O CPF ou RG existe na licença, mas não retorna resultado.
Dúvidas sobre a implementação do PABX ou URA.

Informações que devem ser reunidas antes do escalonamento

Nome da licença.
CPF ou RG utilizado no teste.
Data e horário da tentativa.
URL utilizada na integração.
Retorno recebido pela API.
Evidências do comportamento apresentado.

Regras importantes / Observações

A configuração do PABX não é realizada pela Superlógica.
A implementação da integração deve ser feita pela equipe responsável pelo sistema telefônico da administradora.
O envio ocorre apenas para e-mails cadastrados na unidade encontrada.
O documento informado deve existir na base de dados da licença.
O retorno HTTP 200 indica que o documento foi localizado e o envio foi processado.

Problemas comuns e como resolver

Problema: A API não retorna resultado.
Causa provável: CPF ou RG não encontrado na licença.
Ação recomendada: Verifique se o documento está cadastrado corretamente na unidade.

Dúvidas relacionadas

P: A Superlógica realiza a configuração do PABX? R: Não. A configuração do PABX ou da URA deve ser realizada pela equipe técnica responsável pela solução telefônica utilizada pela administradora.

P: Posso utilizar RG no lugar do CPF? R: Sim. A consulta pode ser realizada utilizando o documento cadastrado na unidade.

P: Como validar se a consulta funcionou corretamente? R: Verifique se a API retornou status HTTP 200 e se o e-mail de cobranças foi enviado para o contato cadastrado.

Palavras-chave de busca

integração PABX Superlógica, API cobrança Superlógica, URA Superlógica, envio automático de boletos, consulta CPF cobrança, consulta RG cobrança, API email cobranças em aberto, integração telefonia condomínio, segunda via automática boleto, API pública Superlógica

Superlógica Condomínios Integração da API do Superlógica com PABX