Conta Azul
Avisar seus clientes do Conta Azul sobre cobranças pelo WhatsApp.
A integração lê as cobranças do Conta Azul e envia mensagem aos clientes nos dias que você definir — antes do vencimento, no dia, ou depois.
O que é o Conta Azul
O Conta Azul é um sistema de gestão financeira para pequenas e médias empresas: contas a receber, cobranças, notas e fluxo de caixa.
Para que serve a integração
A integração consulta as cobranças do Conta Azul 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.
Um aplicativo criado no Conta Azul, de onde saem o Client ID e o Client Secret.
Como configurar
No painel, acesse Integrações → Nativas e escolha o Conta Azul.
A conexão é por autorização, não por senha
Diferentemente das integrações que pedem um token, esta usa o fluxo de autorização do próprio Conta Azul. São quatro campos, e os dois últimos fazem parte desse fluxo:
| Campo | O que fazer |
|---|---|
| Client ID | Do aplicativo que você criou no Conta Azul |
| Client Secret | Do mesmo aplicativo |
| Redirect URI | A SM Click mostra o endereço. Cadastre-o no aplicativo do Conta Azul |
| Autorização Conta Azul | O botão que abre a tela do Conta Azul para você autorizar |
O endereço que a SM Click exibe tem de estar registrado no aplicativo criado no Conta Azul, exatamente igual. É a conferência que o Conta Azul faz antes de devolver a autorização.
Se a autorização abre e termina em erro, este é o primeiro lugar a olhar — quase sempre é uma barra a mais ou a menos no fim do endereço.
Depois de autorizar, a SM Click guarda a permissão e passa a renová-la sozinha. Você não precisa repetir o processo a cada acesso.
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 |
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 Conta Azul por uma instância da API Oficial, crie um template seguindo o processo padrão. Recomendamos:
- Categoria: Utilidade.
- Tipo: Mensagem.
- Nome: escolha um nome que identifique o uso na integração com o Conta Azul.
- Cabeçalho: opcional; preencha ou deixe vazio.
No corpo, use variáveis no formato padrão dos templates, como {{1}} e {{2}}. No
exemplo de cada variável, informe o nome da tag correspondente do Conta Azul, sem as
chaves. Por exemplo, para Olá {{1}}, informe o nome da tag disponível no sistema como
exemplo da primeira variável.
Variáveis disponíveis no Conta Azul
No template da API Oficial, use {{1}}, {{2}} e assim por diante no corpo da mensagem.
No campo de exemplo de cada variável, informe somente o nome da variável, sem as chaves:
nome, dataVencimento, linkBoleto, valor, document e telephone.
O rodapé é opcional. Você pode deixá-lo vazio ou usar um texto como
Acesse a fatura clicando abaixo.
Para enviar o link da cobrança pelo botão:
- Adicione um botão do tipo Acessar Site.
- No campo de URL, informe
https://faturas.contaazul.com/#/fatura/visualizar/{{1}}. - No exemplo da variável da URL, informe
307385b0-30ad-11f1-8ec5-9f713fadd90a. - No campo Texto do Botão, use Acessar Fatura ou outro texto de sua preferência.
- Salve o template.
Ao configurar a integração, informe o ID desse template e deixe 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.
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.
Variáveis da mensagem
As variáveis só podem ser usadas diretamente no texto da mensagem quando a conexão não
for uma API Oficial. Nesse caso, inclua as chaves, como em Olá {nome}, sua fatura vence em {dataVencimento}. 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 |
{linkBoleto} | O link da fatura para pagamento |
{nome} | O nome do cliente |
{document} | O documento do cliente |
{telephone} | O telefone do cliente |
Se parar de funcionar
Numa integração por autorização, o motivo mais comum é a permissão ter sido revogada no Conta Azul — por alguém removendo o aplicativo, ou por troca de conta. Nesse caso, refaça a autorização pelo botão.
Veja também 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