Ir para o conteúdo
Gestor › Integrações › Nativas › Financeiro e cobrança

Hinova

Conectar a SM Click ao Hinova.

Envio automático de mensagens a partir do Hinova, usado por associações de proteção veicular.

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 acesso ao Hinova:

  • Token de Acesso — o bearer token, obtido com o suporte do Hinova ou na área de integrações do sistema

Como configurar

No painel, acesse Integrações → Nativas e escolha o Hinova. Informe as credenciais acima e defina as regras de envio.

Para indicar a instância que fará o envio:

  1. Acesse a página Home da SM Click.
  2. Localize a instância que será utilizada na integração.
  3. Clique em Copiar token.
  4. Cole o token no campo Instância que enviará a mensagem.

Envio por API Oficial

Quando a instância utilizar a API Oficial, informe também no campo ID do Template o ID de um template criado previamente. Nesse caso, não preencha o campo Mensagem: o conteúdo do envio já está configurado no template.

Criação de Template para Integração

Para enviar cobranças do Hinova por uma instância de 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 o nome da tag correspondente do Hinova, sem as chaves. Por exemplo, para Olá {{1}}, informe nome como exemplo da primeira variável.

No campo de exemplo de cada variável, informe somente o nome do placeholder, sem as chaves: valor, dataVencimento, linkBoleto, pix, linhaDigitavel, nome e celular.

Para o botão da cobrança, adicione um botão Acessar Site, use a URL https://short.hinova.com.br/v2/{{1}}, informe dcmBrbTq.pdf como exemplo da variável da URL e escolha um texto como Acessar Boleto. Salve o template e informe seu ID na integração, deixando o campo Mensagem vazio.

Regras de envio

Você configura quantos dias antes ou depois do vencimento a mensagem sai, além dos dias da semana e do horário.

Envie em horário comercial

A recomendação é disparar em dias úteis, de segunda a sexta, entre 8h e 17h. Cobrança que chega de madrugada ou no domingo irrita, e irritação vira denúncia — que prejudica seu número.

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ávelO que traz
{valor}O valor, em reais, da cobrança
{dataVencimento}O dia do vencimento da cobrança, no padrão DD/MM/YYYY
{linkBoleto}A URL da cobrança no sistema Hinova
{pix}O código PIX copia e cola para pagamento
{linhaDigitavel}A linha digitável do boleto (será enviada como mensagem separada)
{nome}O nome do associado cadastrado no Hinova
{celular}O número do celular do associado cadastrado no Hinova
Escreva a mensagem com o cliente em mente

Uma mensagem com variáveis parece pessoal, e não um disparo automático. Com as variáveis desta integração, algo como:

Olá {nome}, sobre {valor} em {dataVencimento}. Aqui está o link: {linkBoleto}

Sem elas, sobra o texto genérico que o cliente ignora.

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