# Como criar e usar a chave de API da WavUps CRM

> A chave de API conecta os seus sistemas à WavUps CRM. Um administrador abre o menu **API**, clica em **Nova chave**, dá um nome e clica em **Gerar chave**: a chave aparece uma única vez, então copie e guarde num lugar seguro. A API está disponível nos planos **Pro** e **Advanced**.

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

## Antes de começar

- A API está disponível nos planos **Pro** e **Advanced**. Em outros planos, a tela mostra **A API está disponível nos planos Pro e Advanced** e o botão **Ver planos**.
- O menu **API** aparece só para administradores e o proprietário da conta, e só eles criam ou revogam a chave.
- Cada conta tem **uma chave**. Para trocar, revogue a atual e gere outra.

![Tela API de uma conta sem plano com API, mostrando a mensagem A API está disponível nos planos Pro e Advanced e o botão Ver planos.](https://crm.wavups.com/images/docs/integracoes-api-bloqueada.png)

## Passo a passo: criar a chave

### Passo 1: Abra o menu API

No menu lateral, em **Configurações**, clique em **API**.

![Tela API com o item API do menu lateral, a seção Chave de API, o botão Nova chave, o uso da API e a documentação.](https://crm.wavups.com/images/docs/integracoes-api.png)

### Passo 2: Crie a chave

Na seção **Chave de API**, clique em **Nova chave**. No painel **Nova chave de API**, escreva o **Nome da chave**, que serve só para lembrar onde ela é usada (por exemplo, "Integração N8N" ou "Sistema interno"). Clique em **Gerar chave**.

![Painel Nova chave de API com o nome da chave preenchido e o botão Gerar chave.](https://crm.wavups.com/images/docs/integracoes-api-nova-chave.png)

### Passo 3: Copie e guarde

O painel **Chave criada** mostra a chave completa. Clique em **Copiar**, guarde num lugar seguro (como um gerenciador de senhas) e clique em **Concluído**.

> **A chave aparece uma vez só**
> Por segurança, a WavUps CRM guarda só os últimos 4 caracteres. Depois de fechar o painel, ninguém consegue ver a chave de novo. Se perder, revogue a chave e gere outra.

## Como usar a chave

A seção **Como usar** da tela **API** mostra o endereço base das requisições, como enviar a chave e um exemplo pronto para **listar leads** em cURL, JavaScript e Python.

![Seção Como usar da tela API com o endereço base das requisições, o cabeçalho de autenticação e um exemplo pronto.](https://crm.wavups.com/images/docs/integracoes-api-como-usar.png)

- Envie a chave no cabeçalho `Token` de cada requisição.
- O limite é de **100 requisições por minuto** por conta. Acima disso, a resposta é **429**.
- Chave ausente ou inválida responde **401**.
- Para ver todos os recursos disponíveis, clique em **Abrir documentação**, na mesma seção.

A seção **Uso da API** mostra quantas requisições a conta fez nas **Últimas 24 horas**, **Hoje**, nos **Últimos 7 dias** ou nos **Últimos 30 dias**.

## Revogar a chave

Na lista de chaves, clique na lixeira ao lado da chave e confirme em **Revogar chave**. As integrações que usam essa chave param de funcionar na hora e a ação não pode ser desfeita. Depois, clique em **Nova chave** para gerar outra e atualize os seus sistemas.

> **Quando revogar**
> Revogue a chave sempre que ela puder ter vazado (por exemplo, se foi colada num lugar público) ou quando um fornecedor que usava a integração deixar de trabalhar com você.

## Se algo der errado

| Mensagem ou situação | O que fazer |
| --- | --- |
| **A API está disponível nos planos Pro e Advanced** | Mude de plano em **Meu plano** para liberar a API. |
| O botão **Nova chave** está desativado | A conta já tem uma chave ativa ou você não é administrador. Revogue a atual para criar outra. |
| **Dê um nome para lembrar onde a chave é usada** | Preencha o **Nome da chave**. |
| Respostas **401** | A chave está errada, incompleta ou foi revogada. Confira o cabeçalho `Token`. |
| Respostas **429** | Passou de 100 requisições por minuto. Espalhe as requisições no tempo. |

## Na prática

### Site próprio criando leads

**Situação:** Uma escola de idiomas tem um formulário no próprio site e copiava os cadastros para o CRM.

**Como a WavUps CRM ajuda:** O desenvolvedor usa a chave de API para criar o lead na WavUps CRM assim que o formulário do site é enviado.

### Ferramenta de automação externa

**Situação:** Uma agência usa o N8N para ligar vários sistemas.

**Como a WavUps CRM ajuda:** Ela cria a chave "Integração N8N" e usa nas chamadas. Se trocar de ferramenta, revoga a chave e gera outra.

## Perguntas frequentes

### Quais planos têm acesso à API?

Os planos **Pro** e **Advanced**.

### Posso ver a chave depois de criada?

Não. Ela aparece uma vez só, no painel **Chave criada**. Depois, a lista mostra só os últimos 4 caracteres.

### Posso ter mais de uma chave?

Não. Cada conta tem uma chave ativa. Para trocar, revogue a atual e gere outra.

### Membros podem ver a chave?

Não. O menu **API** é só para administradores, e mesmo eles só veem a chave completa no momento em que ela é criada.

## Veja também

- [Como configurar o webhook da WavUps CRM](https://crm.wavups.com/docs/integracoes/webhook)
- [Como ver o uso do plano, trocar de plano e baixar cobranças na WavUps CRM](https://crm.wavups.com/docs/conta-e-equipe/meu-plano)
- [Como conectar o Asaas para gerar cobranças na WavUps CRM](https://crm.wavups.com/docs/integracoes/asaas)