# Como conectar o Asaas para gerar cobranças na WavUps CRM

> Para gerar cobranças pela WavUps CRM, um administrador abre **Integrações**, clica em **Conectar** no cartão do **Asaas**, cola a **Chave de API** da conta Asaas e clica em **Conectar**. A plataforma configura o retorno automático dos pagamentos e passa a gerar e acompanhar as cobranças dos seus leads.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/integracoes/asaas (atualizado em 8 de outubro de 2026)

## Antes de começar

- Só **administradores** e o proprietário da conta conectam gateways de pagamento.
- Tenha uma conta ativa no Asaas e acesso à área de desenvolvedores dela, onde fica a chave de API.
- Hoje o **Asaas** é o gateway disponível. Outros aparecem em **Integrações** como **Em breve**.

## Passo a passo: conectar o Asaas

### Passo 1: Copie a chave no Asaas

Na sua conta Asaas, abra a área de desenvolvedores e copie a chave de API. Ela começa com `$aact_`.

### Passo 2: Abra o painel do Asaas

Na WavUps CRM, abra **Integrações** e, na categoria **Financeiro**, clique em **Conectar** no cartão do **Asaas**.

![Tela Integrações com o botão Conectar do cartão do Asaas destacado.](https://crm.wavups.com/images/docs/integracoes-visao-geral.png)

### Passo 3: Cole a chave e salve

No painel **Conectar Asaas**, cole a chave no campo **Chave de API** e clique em **Conectar**. Aparece **Asaas conectado!**.

![Painel Conectar Asaas com o campo Chave de API e o botão Conectar.](https://crm.wavups.com/images/docs/integracoes-asaas-painel.png)

### Passo 4: Confira o webhook

Clique em **Gerenciar** no cartão. O painel mostra **Credenciais configuradas**, a data em **Conectado em** e o aviso **Webhook configurado automaticamente**: é assim que o Asaas avisa a plataforma quando a cobrança é paga, vence, é alterada ou cancelada. O bloco **Métodos de pagamento da sua conta** mostra quais métodos estão **Habilitado** ou **Não habilitado** no seu Asaas.

> **Webhook pendente**
> Se o painel mostrar **Webhook pendente**, a plataforma não conseguiu se registrar no Asaas, geralmente por uma chave errada ou sem permissão. Confira a chave e salve as credenciais de novo.

## Trocar a chave, sincronizar e remover

- **Trocar a chave**: em **Gerenciar**, preencha **Nova chave de API** e clique em **Salvar alterações**. Por segurança, a chave atual nunca é exibida. Aparece **Credenciais do Asaas atualizadas!**.
- **Sincronizar faturas**: no bloco **Faturas do Asaas**, clique em **Sincronizar faturas** para trazer as cobranças que já existem no Asaas. Cada cobrança é ligada ao lead pelo CPF/CNPJ e, se não achar, pelo e-mail. As cobranças novas entram sozinhas, pelo webhook.
- **Remover a integração**: clique em **Remover integração** e confirme. A plataforma deixa de gerar e acompanhar cobranças pelo Asaas. Você pode conectar de novo depois.

## Se algo der errado

| Mensagem ou situação | O que fazer |
| --- | --- |
| **Preencha o campo "Chave de API".** | Cole a chave de API antes de salvar. |
| **Não foi possível salvar.** | Confira se a chave foi copiada inteira, sem espaços, e tente de novo. |
| **Webhook pendente** | Salve as credenciais novamente. Se continuar, gere uma nova chave no Asaas e use ela. |
| **Informe o que deseja atualizar.** | Em **Gerenciar**, preencha a nova chave antes de salvar. |

## Na prática

### Cobrança sem sair do CRM

**Situação:** Um escritório de contabilidade emitia boletos no Asaas e anotava no CRM quem pagou.

**Como a WavUps CRM ajuda:** Com o Asaas conectado, a cobrança é gerada pela plataforma e a situação do pagamento é atualizada sozinha quando o cliente paga.

## Perguntas frequentes

### Quais gateways de pagamento a WavUps CRM aceita?

Hoje, o Asaas. Outros gateways aparecem em **Integrações** como **Em breve**.

### Onde encontro a chave de API do Asaas?

Na área de desenvolvedores da sua conta Asaas. A chave começa com `$aact_`.

### A WavUps CRM mostra a minha chave depois de salva?

Não. Por segurança, a chave atual não é exibida. Para trocar, informe uma nova.

## Veja também

- [Como criar e usar a chave de API da WavUps CRM](https://crm.wavups.com/docs/integracoes/chave-de-api)
- [Como configurar o webhook da WavUps CRM](https://crm.wavups.com/docs/integracoes/webhook)
- [Gatilhos das automações: o que pode iniciar uma automação na WavUps CRM](https://crm.wavups.com/docs/automacoes/gatilhos)