Como criar e usar a chave de API da WavUps CRM
Crie a chave de API da conta para seus sistemas criarem leads, negócios e mensagens na WavUps CRM, veja como usar, o limite de requisições e como revogar.
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.
- 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.
- 1
Passo 1: Abra o menu API
No menu lateral, em Configurações, clique em API.
- 2
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.
- 3
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ó
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.
- Envie a chave no cabeçalho
Tokende 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.
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
| 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. |
Site próprio criando leads
A situaçãoUma escola de idiomas tem um formulário no próprio site e copiava os cadastros para o CRM.
Como a WavUps CRM ajudaO 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
A situaçãoUma agência usa o N8N para ligar vários sistemas.
Como a WavUps CRM ajudaEla cria a chave "Integração N8N" e usa nas chamadas. Se trocar de ferramenta, revoga a chave e gera outra.
Os planos Pro e Advanced.
Não. Ela aparece uma vez só, no painel Chave criada. Depois, a lista mostra só os últimos 4 caracteres.
Não. Cada conta tem uma chave ativa. Para trocar, revogue a atual e gere outra.
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
Ainda com dúvida?
Fale com a nossa equipe pelo WhatsApp.