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:
- O fluxo gera um QR Code PIX via Asaas e envia ao contato
- O fluxo aguarda até o prazo definido
- Quando o pagamento é confirmado, o webhook Asaas notifica o sistema e o fluxo segue pelo caminho Pago
- 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
- Acesse Integrações → Pagamentos no menu lateral
- No card Nó PIX no FlowBuilder (topo da página), clique em Configurar chave
- Insira sua Chave API Asaas — encontrada em Asaas → Minha Conta → Integrações → API
- 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:
- Ainda no card "Nó PIX no FlowBuilder", copie a URL do Webhook
- No painel do Asaas: Minha Conta → Integrações → Webhooks → Adicionar webhook
- Cole a URL e ative o evento Pagamento Confirmado
- 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
- Automação e Flow Builder — Como funcionam os fluxos de automação
- Variáveis Dinâmicas — Usar variáveis dinâmicas nos campos do fluxo