# 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.

Endereço: https://help.nextags.com.br/integracoes/asaas/
Tipo: Integração

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

- Mandar a segunda via do boleto ou do Pix quando o cliente pede. Veja [Requisição externa: enviar e receber dados de outro sistema](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).
- Pedir o CPF e guardar no contato. Veja [Adquirir Dados: perguntar e salvar a resposta](https://help.nextags.com.br/tutoriais/fluxos/perguntar-e-salvar-resposta/).
- Seguir um caminho para quem tem cobrança pendente e outro para quem está em dia. Veja [Etapa Condição: caminhos diferentes para cada contato](https://help.nextags.com.br/tutoriais/fluxos/condicoes/).

## 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](https://help.nextags.com.br/tutoriais/fluxos/campos-do-bot/). Mais detalhes na [documentação do Asaas](https://docs.asaas.com/docs/autenticacao-1).

### 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`.

![Janela External Request: tipo POST, endereço da API e, na aba Cabeçalhos, o cabeçalho Authorization com a chave guardada num campo.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao.webp)
*A janela da requisição. O print mostra outra API: no Asaas, o método é GET e o cabeçalho é access_token.*

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`.

![Aba Mapeamento de resposta: cada JSONPath da resposta com o campo personalizado onde o valor fica salvo.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao-mapeamento.webp)
*Cada caminho da resposta com o campo que guarda o valor.*

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.

![Etapa no quadro com a requisição externa e as duas saídas, Sucesso e Falhado.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao-saidas.webp)
*As saídas da requisição no quadro.*

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](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).

## 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](https://help.nextags.com.br/tutoriais/erros/erros-de-requisicao-externa/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
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.
```