Asaas
Conectar a SM Click ao Asaas.
Envio automático das cobranças de mensalidade pelo WhatsApp.
O que é o Asaas
O Asaas é uma plataforma de cobranças e pagamentos: a empresa emite boletos, Pix e cobranças por cartão e acompanha quem já pagou.
Para que serve a integração
A integração consulta as cobranças do Asaas 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 acesso ao Asaas:
- Chave de API — obtida na área de integrações do Asaas
Como configurar
No painel, acesse Integrações → Nativas e escolha o Asaas. Informe as credenciais acima e defina as regras de envio.
Para indicar a instância que fará o envio:
- Acesse a página Home da SM Click.
- Localize a instância que será utilizada na integração.
- Clique em Copiar token.
- 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 Asaas por uma instância de 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 Asaas.
- 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 Asaas, 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: nome, dataVencimento, linkBoleto, linkPdf, valor, descricao, email e celular.
O rodapé é opcional. Você pode deixá-lo vazio ou usar um texto como
Acesse o boleto 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://www.asaas.com/b/pdf/{{1}}. - No exemplo da variável da URL, informe
07defsbnbsedmkas. - No campo Texto do Botão, use Acessar Boleto 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
Você configura quantos dias antes ou depois do vencimento a mensagem sai, além dos dias da semana e do horário.
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.
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.
Dá para escolher se envia o PDF do boleto (somente quando a instância não for API Oficial) ou apenas o link de pagamento, e se o envio vale para clientes assinantes ou não assinantes.
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, em reais, da cobrança |
{dataVencimento} | O dia do vencimento da cobrança, no padrão DD/MM/YYYY |
{descricao} | A descrição do produto cobrado no boleto |
{linkBoleto} | A URL da cobrança no sistema Asaas |
{linkPdf} | O arquivo PDF da cobrança no sistema Asaas |
{nome} | O nome do cliente cadastrado no Asaas |
{email} | O e-mail do cliente cadastrado no Asaas |
{celular} | O número do celular do cliente cadastrado no Asaas |
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