Pular para o conteúdo
Acessar conta

Asaas

Mande a segunda via da cobrança do Asaas no WhatsApp. O fluxo busca o cliente pelo CPF e as cobranças pendentes pela API, com a chave de API.

IntegraçãoPagamentosPela API
Atualizado em 25/10/2026

O Asaas se liga à NexTags pela API. Num fluxo, a requisição externa consulta o cliente e as cobranças dele no Asaas, com a chave de API da sua conta, e a NexTags manda o link da cobrança na conversa. A NexTags não tem cartão do Asaas em Configurações › Integrações: a chave fica num campo do bot.

O que dá para fazer

Como conectar

Passo 1: Gere a chave de API no Asaas

Com um usuário administrador do Asaas, abra Integrações e gere a chave de API de produção. As chaves do sandbox e da produção são diferentes. Guarde a chave num campo do bot, como Chave do Asaas: veja Campos do bot: um valor para a conta toda. Mais detalhes na documentação do Asaas.

Passo 2: Busque o cliente pelo CPF

Peça o CPF ao contato, só com os números, e guarde num campo, como CPF. Numa etapa Ações, adicione External API Request, com GET e o endereço https://api.asaas.com/v3/customers?cpfCnpj={{CPF}}. Na aba Cabeçalhos, ponha access_token com o campo da chave. Contas do Asaas criadas a partir de 13/06/2024 também precisam do cabeçalho User-Agent, com um nome, como NexTags.

  1. Request Type: aqui, GET.
  2. Request URL: o endereço do Asaas, com o campo do CPF.
  3. As abas da janela: Cabeçalhos, Corpo, Mapeamento de resposta e Testar Agora.
  4. Os cabeçalhos: access_token com {{Chave do Asaas}} e, se a conta pedir, User-Agent.

Passo 3: Guarde o código do cliente

Abra Testar Agora, clique em Testar Agora e veja no Corpo da resposta onde está o id do cliente. Na aba Mapeamento de resposta, guarde esse caminho num campo, como Cliente no Asaas.

  1. JSONPath: o caminho do id do cliente na resposta.
  2. Salvar em um campo personalizado: o campo que recebe o valor.

Passo 4: Busque as cobranças pendentes e mande o link

Adicione outra External API Request, com GET, os mesmos cabeçalhos e o endereço https://api.asaas.com/v3/payments?customer={{Cliente no Asaas}}&status=PENDING. Com o Testar Agora, ache na resposta o link da cobrança e guarde num campo. Depois, mande o link numa mensagem e ligue a saída Falhado a um aviso para a equipe.

  1. Sucesso: siga para a mensagem com o link da cobrança.
  2. Falhado: siga para um caminho de reserva, como passar para a equipe.

O passo a passo completo da requisição está em Requisição externa: enviar e receber dados de outro sistema.

Se não funcionou

O teste mostra access_token_not_found

Falta o cabeçalho access_token. Na aba Cabeçalhos, confira o nome do cabeçalho e se o campo da chave está preenchido.

O teste mostra o código 401

O Asaas não aceitou a chave. Confira se ela é a de produção, inteira, e se não foi apagada no Asaas. Uma chave do sandbox não vale na produção.

O campo ficou vazio

O caminho não bate com a resposta, ou o Asaas não achou o CPF. Abra Testar Agora, veja o Corpo da resposta e corrija o caminho. Veja Erros de requisição externa, webhook e planilha.

Faça com a IA

Copie o pedido e cole no ChatGPT ou no Claude.

Quero mandar a segunda via das cobranças do Asaas pelo WhatsApp com a NexTags. Leia esta página: https://help.nextags.com.br/integracoes/asaas.md

Este é o corpo da resposta do Testar Agora, sem dados reais de clientes: [cole aqui]. Diga os caminhos (JSONPath) do id do cliente e do link da cobrança, a condição para quem não tem cobrança pendente e as mensagens do fluxo. Não me peça a chave de API.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.