Integração Asaas
Integração Asaas
Conecte o Asaas ao SimplesDesk e transforme o atendimento em uma central de cobrança: o Agente de IA cadastra clientes,
cria cobranças PIX/boleto e envia a 2ª via na conversa; os fluxos verificam inadimplência e roteiam o atendimento; e a
régua de cobrança dispara sozinha — por vencimento ou por evento de pagamento.
Quando utilizar
- Sua empresa emite cobranças pelo Asaas e o time atende no WhatsApp;
- Você quer réguas automáticas de cobrança (lembrete antes do vencimento, aviso de atraso);
- Atendimento com Agente de IA que consulta débitos, gera cobrança com link de pagamento e manda 2ª via com PIX
copia-e-cola.
Como conectar
1. Acesse Configurações → Integrações e clique no card Asaas.
2. Preencha a Chave de API — gere no painel do Asaas (Integrações → Chave de API); ela começa com $aact_.
3. Escolha o Ambiente: Produção ou Sandbox (testes).
4. Clique em Testar e conectar — a conexão é validada antes de salvar.
Ao conectar, o webhook de pagamentos é registrado automaticamente: pagamento confirmado etiqueta o contato como
pago-asaas e cobrança vencida como inadimplente-asaas — use as etiquetas em filtros, acionadores e réguas. O vínculo com
o contato é feito pelo e-mail ou telefone do cliente Asaas.
Com a conta conectada, quatro frentes ficam disponíveis: Agente de IA, nós de fluxo, fonte de contatos para disparos
agendados e eventos de integração.
Agente de IA
Nas configurações do assistente (Central IA → seu assistente → Integrações), ative o Asaas. A IA passa a fazer:
| Grupo | O que a IA passa a fazer | | --- | --- | | Cliente | Localizar por CPF/CNPJ, e-mail ou telefone (usa os dados
do contato da conversa por padrão), cadastrar novo cliente e atualizar dados cadastrais | | Cobranças | Listar por
situação (pendentes, vencidas, pagas), criar cobrança PIX, boleto, cartão ou link (o cliente escolhe) e enviar a 2ª via
com link de pagamento, linha digitável e PIX copia-e-cola | | Assinaturas | Listar as cobranças recorrentes do cliente:
valor, ciclo, status e próximo vencimento |
💡 Antes de criar uma cobrança, a IA sempre confirma valor, vencimento e forma de pagamento com o cliente. Na 2ª via, se
não houver uma cobrança específica, ela usa a pendente/vencida mais próxima do vencimento.
Nós de fluxo
No editor de fluxos, a paleta ganha a categoria Asaas:
- Buscar Cliente (Asaas) — localiza por CPF/CNPJ (campo aceita {{variables.cpf}}); vazio, tenta e-mail/telefone do
contato. Salva {{variables.asaas_cliente_id}} e {{variables.asaas_cliente_nome}} e vincula o cliente ao contato para
os próximos nós. Não achou = saída vermelha.
- Verificar Cobranças (Asaas) — consulta vencidas e a vencer do cliente e roteia por saída tripla: vermelho = tem
vencida, âmbar = só a vencer, verde = em dia. Salva {{variables.asaas_vencidas_count}},
{{variables.asaas_pendentes_count}}, {{variables.asaas_total_aberto}} e os dados da cobrança mais próxima do
vencimento: {{variables.asaas_cobranca_id}}, {{variables.asaas_cobranca_valor}},
{{variables.asaas_cobranca_vencimento}}, {{variables.asaas_link_pagamento}}.
- Criar Cobrança (Asaas) — cria a cobrança para o cliente localizado. Configure Valor (aceita variável), Vencimento em
(dias) e Forma de pagamento (PIX, boleto, cartão ou "cliente escolhe no link"), com descrição opcional. Salva
{{variables.asaas_link_pagamento}}, {{variables.asaas_boleto_url}} e {{variables.asaas_pix_copia_cola}} — prontos
para um Enviar Mensagem.
Se o Asaas estiver indisponível, os nós de cobrança saem por um caminho de falha com o erro em {{variables.asaas_erro}}
— a régua não para, você trata o desvio.
Fonte de contatos: cobranças por vencimento
No gatilho Disparo agendado, a fonte "Asaas — Cobranças" busca as cobranças pelo vencimento e dispara o fluxo para cada
cliente. Configure:
- Modo — "a vencer" ou "vencidas";
- Dias — a vencer EM n dias / vencidas HÁ n dias (padrão 1).
Cada disparo chega com as variáveis prontas: {{variables.asaas_cliente_nome}} · {{variables.asaas_valor}} ·
{{variables.asaas_vencimento}} · {{variables.asaas_descricao}} · {{variables.asaas_tipo}} ·
{{variables.asaas_link_pagamento}} · {{variables.asaas_link_boleto}} · {{variables.asaas_cobranca_id}}.
Eventos de integração
No gatilho Evento de integração, escolha o app Asaas e o evento que inicia o fluxo:
- Pagamento recebido · Pagamento confirmado — agradeça, envie o recibo, remova etiquetas de cobrança;
- Cobrança vencida — inicie a régua de atraso na hora.
As variáveis do evento: {{variables.asaas_cobranca_id}} · {{variables.asaas_valor}} · {{variables.asaas_vencimento}} ·
{{variables.asaas_link_pagamento}} · {{variables.asaas_cliente_nome}}. Retentativas de webhook são deduplicadas — o
fluxo não roda duas vezes para o mesmo evento.
Exemplo: régua de cobrança vencida
1. Gatilho Disparo agendado (diário) + fonte Asaas — Cobranças, modo vencidas, 1 dia;
2. Enviar Mensagem: "Olá {{variables.asaas_cliente_nome}}, sua cobrança de R$ {{variables.asaas_valor}} venceu em
{{variables.asaas_vencimento}}. Pague por aqui: {{variables.asaas_link_pagamento}}";
3. Crie um segundo fluxo com gatilho Evento de integração → Pagamento confirmado que agradece e encerra a conversa — a
etiqueta inadimplente-asaas sai e a pago-asaas entra automaticamente.
💡 Teste a régua no ambiente Sandbox antes de ativar em produção.
📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.
