Nó Asaas

O nó de workflow Asaas cria uma cobrança via API de Pagamentos do Asaas. Suporta PIX, boleto, cartão de crédito e tipo de cobrança indefinido (cliente escolhe).

ID do nó no editor: asaas_payment
Endpoint da API: POST https://api.asaas.com/v3/payments

O que faz

• Cria um pagamento vinculado a um cliente existente no Asaas
• Retorna o id da cobrança, status, invoiceUrl, bankSlipUrl e dados da transação PIX
• Autentica com sua API key do Asaas via header access_token

Pré-requisitos

1. Uma conta Asaas (sandbox ou produção)
2. API key em Asaas → Integrações → API
3. Um Customer ID (cus_...) — cobranças devem referenciar um cliente existente
4. Chave de integração asaas_api_key em Configurações → Chaves de API

Sandbox: O Asaas oferece ambiente sandbox com API keys e base URL separadas. Confirme que o ambiente da conta corresponde à chave que você configurar.

Como configurar

Etapa 1 — Garantir que o cliente existe no Asaas

O campo Customer ID é obrigatório. Crie o cliente primeiro:

• Manualmente no dashboard do Asaas, ou
• Via API Asaas (POST /v3/customers) usando o nó HTTP genérico, ou
• Armazene cus_... em campos personalizados do contato / variáveis de workflow de uma sincronização anterior

Etapa 2 — Adicionar credenciais

1. Copie sua API key do Asaas
2. Em Configurações → Chaves de API, adicione:
   • Nome: asaas_api_key
   • Valor: sua API key do Asaas

Etapa 3 — Adicionar e configurar o nó

Exemplo com variáveis:

• Customer ID: {{variables.asaas_customer_id}}
• Amount: {{trigger.body.total}}
• Due date: {{date:today}} (ajuste com nó Variable se precisar de +3 dias)
• External reference: {{trigger.body.order_id}}

Etapa 4 — Enviar link de pagamento ao cliente

O Asaas retorna URLs de fatura hospedadas. Após a execução do nó:

Hi {{contact.name}}! Pay here: {{asaas_1.invoiceUrl}}

Para boleto, use {{asaas_1.bankSlipUrl}}. Para PIX, inspecione a saída da execução para detalhes de pixTransaction (QR code, payload copia e cola).

Etapa 5 — Escutar confirmação de pagamento

Configure webhooks do Asaas (PAYMENT_RECEIVED, PAYMENT_CONFIRMED) apontando para um workflow Webhook do WhatsWave para notificar clientes e atualizar o CRM quando pago.

Saídas do nó

Dicas e boas práticas

• Crie clientes antes das cobranças — o nó não cria clientes automaticamente
• Sincronize IDs de clientes Asaas para campos personalizados de contato do WhatsWave para reutilizar entre workflows
• Use externalReference para associar eventos de webhook a pedidos ou cards do CRM
• Para cobrança recorrente, explore a API de assinaturas do Asaas via HTTP ou nós flexíveis no estilo Vindi
• Teste no sandbox do Asaas com API keys de sandbox antes da produção
• Defina datas de vencimento realistas — cobranças vencidas disparam regras de cobrança do Asaas
• Cobranças PIX costumam confirmar em minutos; boleto pode levar 1–3 dias úteis

Exemplos de casos de uso

Boleto para fatura B2B

1. Webhook do ERP com ID de cliente Asaas e valor da fatura
2. Asaas — billing type BOLETO, data de vencimento +7 dias
3. Enviar WhatsApp — link do boleto {{asaas_1.bankSlipUrl}}

PIX para cobrança imediata

1. Card do CRM movido para "Aguardando pagamento"
2. Asaas — billing type PIX, vencimento hoje
3. Send message com URL da fatura ou PIX copia e cola do log de execução

Fluxo de lembrete de vencimento

1. Gatilho Schedule diário
2. HTTP — listar cobranças pendentes do Asaas (chamada customizada)
3. Loop + Enviar WhatsApp lembrete com invoiceUrl

FAQ

Por que a API retorna "Customer not found"?
O Customer ID é inválido ou pertence a outro ambiente Asaas (sandbox vs produção).

Posso criar um cliente no mesmo workflow?
Não apenas com este nó. Adicione um nó HTTP chamando POST /v3/customers primeiro e passe o id retornado ao nó Asaas via nó Variable.

Qual a diferença entre invoiceUrl e bankSlipUrl?
invoiceUrl é a página geral de pagamento; bankSlipUrl é específica do PDF do boleto quando billing type é BOLETO.

O billing type UNDEFINED funciona para todos os clientes?
Permite que o cliente escolha entre os métodos habilitados na sua conta Asaas na página da fatura.

Como usar o sandbox?
Crie uma conta sandbox no Asaas, use API keys de sandbox e garanta que a base URL da API corresponda ao ambiente (produção usa api.asaas.com).

Referência da API

Relacionados

• Visão geral de pagamentos
• Nó HTTP / APIs — para criação de clientes
• Webhooks recebidos