Hubsoft
Avisar seus clientes do Hubsoft sobre cobranças pelo WhatsApp.
A integração lê as cobranças do Hubsoft e envia mensagem aos clientes nos dias que você definir — antes do vencimento, no dia, ou depois.
O que é o Hubsoft
O Hubsoft é um sistema de gestão (ERP) para provedores de internet: clientes, contratos e cobranças ficam nele.
Para que serve a integração
A integração consulta as cobranças do Hubsoft na rotina que você define e envia ao cliente, pelo WhatsApp, a mensagem de lembrete: antes do vencimento, no dia ou depois, quando a cobrança está em atraso. A equipe não precisa avisar um a um, e menos cobranças ficam esquecidas.
Requisitos
Uma instância ativa na SM Click, para enviar as mensagens. A instância está disponível no plano Gamma ou pode ser adquirida separadamente no gerenciamento da assinatura.
As credenciais de API do Hubsoft. São cinco, todas obtidas no próprio Hubsoft.
Como configurar
No painel, acesse Integrações → Nativas e escolha o Hubsoft.
As credenciais
| Campo | O que é |
|---|---|
| URL do sistema | O endereço do seu Hubsoft, no formato https://suaempresa.hubsoft.com.br/ |
| Client Key | Identificador da aplicação |
| Client Secret | Segredo da aplicação |
| Usuário | O login de acesso |
| Senha | A senha desse login |
Cada provedor tem o próprio endereço. Usar um genérico faz a integração autenticar contra o lugar errado e nunca encontrar cobrança nenhuma.
Confirme o endereço que a sua equipe usa para entrar no Hubsoft.
A rotina
| Campo | O que define |
|---|---|
| Dias da Semana | Em quais dias a rotina roda. Ao menos um é obrigatório |
| Horário | A que horas ela busca as cobranças |
| Fuso Horário | Base para os dias e o horário acima |
| Intervalo entre mensagens | Tempo mínimo e máximo, em segundos, entre um envio e o seguinte |
O envio
| Campo | O que define |
|---|---|
| Instância que enviará as mensagens | De qual canal as mensagens saem |
| ID do Template | Só para instância da API Oficial. Deixe vazio nas demais |
| Enviar arquivo | Anexa o boleto à mensagem |
Para preencher Instância que enviará as mensagens, acesse a Home da SM Click, localize a instância, clique em Copiar token e cole o valor nesse campo.
Envio por API Oficial
Quando a instância utilizar a API Oficial, informe também o ID do Template criado previamente. Nesse caso, não preencha o campo Mensagem, pois o conteúdo já está configurado no template.
Criação de Template para Integração
Para enviar cobranças do Hubsoft por uma instância da API Oficial, crie um template seguindo o processo padrão. Recomendamos a categoria Utilidade, o tipo Mensagem e um nome que identifique o uso na integração. O cabeçalho e o rodapé são opcionais.
No corpo, use variáveis no formato {{1}}, {{2}} e assim por diante. No exemplo de
cada variável, informe somente o nome do placeholder, sem as chaves:
valor, dataVencimento, descricao, linkBoleto, nome, celular e
linhaDigitavel.
Para o botão da cobrança, adicione um botão Acessar Site. No campo de URL, informe
https://api.(host).hubsoft.com.br/pdf/{{1}}, substituindo (host) pelo host da sua
empresa. No exemplo da variável da URL, informe
fatura/c60c6dc95e95d0f457681c94be21d6b85f640dfe2ecfbae31661054a189978b0e493a9bf7d.
Escolha um texto como Acessar Boleto, salve o template e informe seu ID na integração,
deixando o campo Mensagem vazio.
Regras de envio
Cada regra combina quantos dias antes ou depois do vencimento a mensagem sai e o texto dela. É preciso ter ao menos uma.
Como funciona o campo de dias
Em cada regra, o campo Dias a partir de hoje diz em relação ao vencimento quando a mensagem sai. O número é contado a partir de hoje: -1 é um dia antes do vencimento, 0 é o próprio dia e 1 é um dia depois.
| Valor | Quando a mensagem sai | Exemplo (hoje é dia 10) |
|---|---|---|
| -1 | 1 dia antes do vencimento | Cobranças que vencem no dia 11 |
| 0 | No dia do vencimento | Cobranças que vencem hoje, dia 10 |
| 1 | 1 dia depois do vencimento (cobrança em atraso) | Cobranças que venceram ontem, dia 9 |
Para avisar com mais antecedência ou cobrar mais tarde, use outros números: -3 avisa três dias antes e 5 cobra cinco dias depois. Cada regra tem o seu próprio texto, então dá para combinar, por exemplo, um aviso de véspera (-1), um lembrete do dia (0) e uma cobrança de atraso (1), cada um com a mensagem que faz sentido naquele momento.
As mensagens só saem nos dias da semana e no horário que você marcou na rotina. Se a rotina não roda no domingo, uma cobrança que vence no domingo e usa a regra 0 não é enviada.
As variáveis disponíveis aparecem na própria tela, junto do campo de mensagem.
Variáveis da mensagem
Em mensagens comuns, quando a instância não utiliza a API Oficial, você pode incluir as variáveis com as chaves no texto da mensagem. Na API Oficial, utilize o template configurado acima.
| Variável | O que traz |
|---|---|
{valor} | O valor da cobrança |
{dataVencimento} | A data de vencimento da cobrança |
{descricao} | A descrição do serviço cobrado |
{linkBoleto} | O link do boleto |
{nome} | O nome do cliente |
{celular} | O telefone do cliente |
{linhaDigitavel} | A linha digitável do boleto |
Cobrança que chega de madrugada ou no domingo irrita, e irritação vira denúncia — que prejudica seu número.
Dias úteis, entre 8h e 17h, é o que costuma funcionar.
Se parar de funcionar
O motivo mais comum é credencial expirada. Veja recarregar tokens.
Se o problema for a mensagem não chegar ao cliente, o retorno costuma vir da Meta — consulte erros mais comuns.
Atualizado em