Asaas
Gerar cobranças Pix, boletos, links e assinaturas, consultar pagamentos e reenviar dados sem duplicar cobranças.
O que faz
Cobre pelo atendimento: gere Pix com QR Code na hora, boleto com linha digitável, link de pagamento ou mensalidade recorrente, consulte se o cliente já pagou e reenvie os dados de pagamento sem criar cobrança nova. O agente é avisado assim que o pagamento entra.
Quando usar: Use quando o seu fluxo precisar gerar cobranças Pix, boletos, links e assinaturas, consultar pagamentos e reenviar dados sem duplicar cobranças.
Exemplo de situação: Consultar um pedido ou executar uma ação comercial durante o atendimento.
Antes de começar
Conexão necessária: Conexão do workspace ou do canal.
Confirme que a integração ou o canal já está conectado no workspace.
Passo a passo
- Adicione Asaas ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Confirme que a integração ou o canal já está conectado no workspace.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Buscar ou Criar Cliente | Busca ou Criar Cliente com o bloco Asaas. |
| Cobrar por Pix | Cobra por Pix com o bloco Asaas. |
| Cobrar por Boleto | Cobra por Boleto com o bloco Asaas. |
| Criar Link de Pagamento | Cria Link de Pagamento com o bloco Asaas. |
| Cobrar Parcelado | Cobra Parcelado com o bloco Asaas. |
| Consultar Cobrança | Consulta Cobrança com o bloco Asaas. |
| Listar Cobranças do Cliente | Lista Cobranças do Cliente com o bloco Asaas. |
| Reenviar Dados de Pagamento | Reenvia Dados de Pagamento com o bloco Asaas. |
| Cancelar Cobrança | Cancela Cobrança com o bloco Asaas. |
| Estornar Cobrança (sensível) | Estorna Cobrança (sensível) com o bloco Asaas. |
| Confirmar Recebimento em Dinheiro (sensível) | Confirma Recebimento em Dinheiro (sensível) com o bloco Asaas. |
| Criar Assinatura | Cria Assinatura com o bloco Asaas. |
| Consultar Assinatura | Consulta Assinatura com o bloco Asaas. |
| Cancelar Assinatura | Cancela Assinatura com o bloco Asaas. |
| Consultar Saldo e Extrato | Consulta Saldo e Extrato com o bloco Asaas. |
| Verificar Conexão de Cobrança | Verifica Conexão de Cobrança com o bloco Asaas. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Buscar ou Criar Cliente · Cobrar por Pix · Cobrar por Boleto · Criar Link de Pagamento · Cobrar Parcelado · Consultar Cobrança · Listar Cobranças do Cliente · Reenviar Dados de Pagamento · Cancelar Cobrança · Estornar Cobrança (sensível) · Confirmar Recebimento em Dinheiro (sensível) · Criar Assinatura · Consultar Assinatura · Cancelar Assinatura · Consultar Saldo e Extrato · Verificar Conexão de Cobrança
- Exemplo:
- Buscar ou Criar Cliente
Conta Asaas
Usa a conta do Asaas conectada no workspace. A chave de API nunca é exposta a este bloco nem ao agente. O agente não movimenta dinheiro para fora: não existe saque, transferência nem pagamento de conta.
- Exemplo:
- (escolha na lista do campo)
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <asaas.response>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<asaas.response> | json | Resposta da API v3 do Asaas para a operação executada. |
Exemplo de uso
Objetivo: Consultar um pedido ou executar uma ação comercial durante o atendimento.
- Operação
- Buscar ou Criar Cliente
- Conta Asaas
- (escolha na lista do campo)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <asaas.response>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Bling ERPConsultar estoque, movimentar saldo, administrar pedidos, notas fiscais e clientes no Bling ERP.
- CatálogoMostrar o catálogo ou um produto do WhatsApp Business (Z-API) dentro de um fluxo de conversa.
- Melhor EnvioCotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.
- NuvemshopConsultar a loja, recuperar carrinhos, criar cupons e administrar produtos, pedidos e clientes na Nuvemshop.
- PIXEnviar pelo WhatsApp (Z-API) um botão que copia a chave PIX.
- Recuperar carrinhoAcompanhar um carrinho abandonado no CRM e enviar recuperação opcional sem repetir mensagens; o pagamento confirmado encerra o negócio como ganho.