HubSoft#
A integração com o HubSoft cobre o núcleo do atendimento financeiro: descobrir quem é o cliente, ver o que está em aberto e gerar a segunda via. Ela é deliberadamente menor que as outras, e saber disso antes de desenhar os fluxos evita retrabalho.
Antes de começar#
O HubSoft autentica com quatro credenciais além do endereço:
| Campo | Para que serve |
|---|---|
baseUrl | Endereço da API |
client_id | Identificação da aplicação |
client_secret | Segredo da aplicação |
username | Usuário |
password | Senha |
As duas primeiras identificam a aplicação; as duas últimas, o usuário em nome de quem ela age. É esse usuário que define o que o Doot pode fazer — crie um próprio para a integração, com o mínimo necessário.
Como fazer#
- Vá em Configurações → Integrações e escolha o Hubsoft.
- Informe o endereço e as quatro credenciais.
- Teste a conexão.
- Confira a lista de recursos.
O que ela consegue fazer#
| Recurso | Para que serve |
|---|---|
| Buscar Cliente no ERP | Identificar por CPF/CNPJ |
| Buscar Cliente por Telefone | Identificar sem pedir documento |
| Faturas em aberto do cliente | O que ele deve |
| 2ª Via de Boleto | Gerar a segunda via |
É isso. Não há consulta de contrato, geração de PIX, leitura de ONU, comandos de rede, liberação de acesso nem cadastro de cliente.
O que isso muda no desenho dos fluxos#
Diagnóstico de conexão fica limitado. Sem leitura de sinal nem estado de PPPoE, o fluxo de "estou sem internet" não consegue verificar a rede: ele checa a situação financeira, checa se há ocorrência na região, conduz o roteiro de equipamento e transfere. Veja Diagnóstico de conexão.
Não há liberação automática. Desbloqueio por confiança e liberação temporária precisam ser feitos no próprio HubSoft, por um humano.
A busca por telefone existe, e é um ganho: ela permite identificar o cliente sem pedir o documento, encurtando o começo de toda conversa. Mas lembre que telefone não autentica ninguém — veja Autenticação do cliente.
Se algo der errado#
Falha de autenticação. Confira as quatro credenciais. client_id e client_secret errados dão o mesmo sintoma que usuário e senha errados.
A busca por telefone não encontra um cliente que existe. O telefone cadastrado no HubSoft pode estar em formato diferente do que chega do canal. Normalize antes de consultar.
Você precisa de um recurso que não está na lista. Ele não existe nesta integração. O caminho é transferir para humano no ponto em que ele seria usado.
A segunda via não gera. Confira se há fatura em aberto para aquele cliente — a consulta de faturas em aberto responde isso antes.