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
- Acesse Configurações → Integrações e clique no card Asaas.
- Preencha a Chave de API — gere no painel do Asaas (Integrações → Chave de API); ela começa com
$aact_. - Escolha o Ambiente: Produção ou Sandbox (testes).
- 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
- Gatilho Disparo agendado (diário) + fonte Asaas — Cobranças, modo vencidas, 1 dia;
- 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}}";
- Crie um segundo fluxo com gatilho Evento de integração → Pagamento confirmado que agradece e encerra a conversa — a etiqueta
inadimplente-asaassai e apago-asaasentra 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.