Nó PIX no FlowBuilder

5 min de leitura

Categoria: Automação e Fluxos
Última atualização: 2026-05-15
Tempo de leitura: 5 min

O nó PIX permite cobrar clientes automaticamente dentro de um fluxo de automação. Quando o contato chega nesse ponto do fluxo, o sistema gera um QR Code PIX e envia para ele — e o fluxo só continua após o pagamento ser confirmado (ou o tempo esgotar).


Dois modos de operação

O nó PIX tem dois modos: Dinâmico e Estático. Você escolhe o modo no painel de configuração do nó.

Modo Dinâmico — via Asaas

Gera uma cobrança real na sua conta Asaas. O fluxo pausa e aguarda a confirmação de pagamento.

Requer: Chave API Asaas configurada em Integrações → Pagamentos → Nó PIX no FlowBuilder.

Saídas disponíveis:

  • Pago → o contato pagou dentro do prazo
  • Expirado → o prazo esgotou sem pagamento
  • Erro → falha ao gerar a cobrança (chave inválida, API fora do ar, etc.)

Funcionamento:

  1. O fluxo gera um QR Code PIX via Asaas e envia ao contato
  2. O fluxo aguarda até o prazo definido
  3. Quando o pagamento é confirmado, o webhook Asaas notifica o sistema e o fluxo segue pelo caminho Pago
  4. Se o prazo expirar sem pagamento, o fluxo segue pelo caminho Expirado

Modo Estático — QR Code local

Gera um QR Code PIX com payload EMV/BCB localmente, sem depender de nenhum gateway de pagamento. Não há confirmação automática de pagamento — o fluxo continua imediatamente após o envio.

Não requer conta Asaas nem nenhuma integração externa. Zero taxas, zero dependências.

Saída disponível:

  • Enviado → QR Code enviado ao contato (fluxo continua sem aguardar pagamento)

Quando usar: Cobranças informais, valores combinados previamente, ou quando você quer enviar um PIX fixo sem monitorar o pagamento dentro do fluxo.


Configuração do nó

Campos disponíveis (ambos os modos)

Campo Descrição
Modo Dinâmico (Asaas) ou Estático
Chave PIX Chave do recebedor (CPF, CNPJ, e-mail, telefone ou chave aleatória)
Valor (R$) Deixe em branco para QR Code de valor livre

Campos adicionais (Modo Dinâmico)

Campo Descrição
Descrição da cobrança Texto exibido ao pagador (ex: "Pagamento do Plano Premium")
Tipo de valor Fixo (valor definido aqui) ou Variável (lido de uma variável do fluxo)
Prazo (dias) Quantos dias o QR Code fica válido (padrão: 1 dia)
Timeout (minutos) Tempo máximo que o fluxo aguarda antes de seguir pelo caminho Expirado
Mensagem de envio Texto enviado junto com o QR Code
Mensagem de confirmação Mensagem enviada automaticamente quando o pagamento é confirmado
Mensagem de expiração Mensagem enviada quando o prazo esgota sem pagamento

Campos adicionais (Modo Estático)

Campo Descrição
Nome do beneficiário Nome exibido no comprovante do pagador
Cidade Cidade do beneficiário (obrigatório pelo padrão PIX)
Mensagem de envio Texto enviado junto com o QR Code

Como configurar o Asaas (Modo Dinâmico)

Passo 1 — Configure a chave API

  1. Acesse Integrações → Pagamentos no menu lateral
  2. No card Nó PIX no FlowBuilder (topo da página), clique em Configurar chave
  3. Insira sua Chave API Asaas — encontrada em Asaas → Minha Conta → Integrações → API
  4. Clique em Salvar chave

O card exibirá o badge ✅ Chave configurada quando estiver ativo.

Importante: Este card é exclusivo para o FlowBuilder. É diferente da integração geral de pagamentos (card Asaas abaixo, usado para cobranças manuais). Você pode configurar um, o outro, ou ambos — independentemente.

Passo 2 — Configure o webhook no Asaas

Para que o fluxo avance automaticamente quando o pagamento for confirmado:

  1. Ainda no card "Nó PIX no FlowBuilder", copie a URL do Webhook
  2. No painel do Asaas: Minha Conta → Integrações → Webhooks → Adicionar webhook
  3. Cole a URL e ative o evento Pagamento Confirmado
  4. Salve

Dica: Use o ambiente Sandbox do Asaas para testar sem movimentar dinheiro real. Basta usar a chave API do sandbox e configurar o webhook apontando para a URL correta.


Exemplo de fluxo com PIX

[Gatilho: mensagem "quero comprar"]
       ↓
[Mensagem: "Ótimo! Preparando sua cobrança..."]
       ↓
[Nó PIX Dinâmico — R$ 97,00 — prazo 1 dia]
   ↙         ↓          ↘
[Pago]   [Expirado]   [Erro]
  ↓           ↓           ↓
[Libera   [Lembrete  [Mensagem
 acesso]   manual]    de suporte]

Perguntas frequentes

O cliente pode pagar em qualquer valor no QR Code de valor livre? Sim. Quando o campo Valor está em branco (Modo Estático) ou zerado, o pagador digita o valor desejado no app do banco.

O fluxo pode continuar se o cliente não pagar? Sim — use o caminho Expirado para enviar um lembrete, oferecer desconto ou encerrar o atendimento.

Preciso de CNPJ para usar o Asaas? Não. O Asaas aceita CPF (pessoa física). Para volumes maiores, recomendamos usar CNPJ para melhores limites de recebimento.

O QR Code expira? No Modo Dinâmico, você define o prazo (em dias). No Modo Estático, o QR Code tecnicamente não expira, mas o sistema envia a mensagem e segue imediatamente — sem rastrear pagamento.

As taxas do PIX são cobradas por quem? No Modo Dinâmico, o Asaas cobra suas tarifas diretamente na sua conta. O ConvertaFlow não cobra taxas sobre transações PIX.


Artigos relacionados

Última atualização 31/10/2026 · Versão 2 · ref f0b1241c65da