# Integração Asaas

![Integração Asaas](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN2hsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4ff1e8ec39f04333333c57ea2948ac381b413a7f/simplesdesk-asaas.png)

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.