Como Gerar Cobranças PIX com IA no N8N (Tutorial Asaas + Gemini)

---

Bora pra ação! Quer automatizar suas cobranças e permitir que uma Inteligência Artificial gere um PIX a partir de uma simples conversa? Neste tutorial, vamos construir um fluxo no N8N que usa o poder do Google Gemini para entender um pedido, calcular um valor e usar a API do Asaas para criar uma cobrança PIX na hora.

A partir das instruções que vou te trazer, você será capaz de adaptar essa automação para qualquer sistema, seja para fechar um pedido de delivery, cobrar uma fatura ou qualquer outra necessidade do seu negócio. Já deixa um like e vamos construir!

Passo 1: Configurando a Conta Asaas

Antes de ir para o N8N, precisamos preparar nossa conta no Asaas para receber as instruções da nossa IA. Se você ainda não tem uma, crie sua conta gratuitamente.

1. Complete seu Cadastro: Para ter acesso à geração de PIX via API, é fundamental que seu cadastro no Asaas esteja 100% completo e verificado.
2. Cadastre uma Chave PIX: Vá até a seção de chaves PIX da sua conta e certifique-se de que você tem pelo menos uma chave aleatória ou CNPJ/CPF cadastrada. É essa chave que usaremos para gerar as cobranças.
3. Gere sua Chave de API: Este é o passo mais importante. Vá em Integrações > Chaves de API e gere uma nova chave. Dê um nome a ela (ex: "N8N_ZDG") e guarde bem esse código. Ele é o nosso access_token que autorizará as requisições.

Passo 2: Construindo o Agente de IA no N8N

Agora, no N8N, vamos montar o cérebro da nossa operação. O fluxo pode ser iniciado por qualquer gatilho (um Webhook da Z-PRO, um formulário, etc.), mas para este exemplo, usaremos o Chat Trigger para testar em tempo real.

1. Adicione o Nó "AI Agent": Este será o nosso assistente.
2. Configure o Modelo de Chat: Em Chat Model, selecione Gemini e adicione sua credencial. Temos um vídeo aqui no canal ensinando a gerar sua chave gratuita no Google AI Studio.
3. Configure a Memória: Em Memory, use a Simple Memory para que o agente se lembre do contexto da conversa com cada usuário.
4. Crie uma "Tool" (Ferramenta): Este é o pulo do gato. Vamos criar uma ferramenta chamada "PIX" que o nosso agente poderá "usar". Essa ferramenta será um nó de HTTP Request.

Passo 3: Criando a Ferramenta para Gerar o PIX

A "Tool" que o agente de IA usará é, na verdade, um nó de HTTP Request configurado para se comunicar com a API do Asaas.

Configure o nó da seguinte forma:

• URL:

  POST - https://www.asaas.com/api/v3/pix/qrCodes/static

• Authentication: Selecione Header Auth.
  • Name: access_token
  • Value: Cole aqui a sua chave de API do Asaas que você gerou no Passo 1.
• Body Content Type: JSON.
• Body: Deixe em branco por enquanto. A IA irá preencher isso dinamicamente.

Volte ao seu nó "AI Agent" e, na seção de Tools, adicione a ferramenta que você acabou de criar.

Passo 4: Ensinando a IA a Usar a Ferramenta (Configurando o Prompt)

Agora, precisamos dizer à IA o que fazer e como usar a ferramenta PIX. Isso é feito através do prompt principal e da descrição dos parâmetros da ferramenta.

Configurando o Prompt Principal

No campo System Prompt do seu nó AI Agent, insira a instrução principal:

Você será um assistente que irá fazer as contas e, ao final, com o valor recebido da conta, gerará um QR Code PIX usando a ferramenta "PIX".

Definindo os Parâmetros da Ferramenta

Na configuração da sua Tool "PIX" (dentro do AI Agent), vamos descrever cada campo que a IA precisa preencher. A IA usará essas descrições para construir o JSON que será enviado no corpo (Body) da nossa requisição HTTP.

Adicione os seguintes parâmetros:

• addressKey: Descrição: "Sua chave PIX cadastrada no Asaas." (Informe sua chave PIX aqui).
• description: Descrição: "A descrição da cobrança. Ex: Venda de Produto X".
• value: Descrição: "Este campo SÓ DEVERÁ receber o valor final da conta calculada."
• format: Descrição: "O formato de retorno. Use 'ALL' para receber a imagem e o payload."

Com essas instruções, a IA saberá que, ao receber "10 + 10", ela deve calcular o resultado (20), usar esse resultado para o campo value e preencher os outros campos para chamar a API do Asaas.

Passo 5: Testando e Finalizando o Fluxo

Com tudo configurado, use o Chat Trigger para testar. Envie uma mensagem como "quanto é 15 + 30?". Você verá o N8N executar os seguintes passos:

1. O AI Agent recebe a mensagem.
2. Ele entende que precisa calcular "45".
3. Ele ativa a ferramenta "PIX", passando o valor 45 e os outros parâmetros.
4. O nó HTTP Request envia a requisição para o Asaas.
5. O Asaas retorna a cobrança PIX, incluindo o payload (código copia e cola) e a imagem do QR Code em Base64.

A partir daí, você pode tratar essa saída para enviá-la de volta ao seu cliente, seja via Z-PRO, WhatsApp ou qualquer outro canal integrado!

Quer levar suas automações para o próximo nível e construir soluções completas? Venha para a Comunidade ZDG, a maior do Brasil em APIs e automações para WhatsApp, com mais de 7 mil alunos. Ou, se busca um sistema Omnichannel White Label pronto para revenda, conheça o Z-PRO.

Qualquer dúvida, é só chamar. Tamo junto!