> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como criar uma chave de API

> Crie, copie, desative, regenere e exclua as chaves de API da WizeBot em Configurações > API Keys

![Tela API Keys com duas chaves ativas, Integração com a loja virtual e Sistema de pedidos](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/capa.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=2134e825d828941cc1b5bd02c54f825c)

A chave de API é a senha que o seu sistema usa para falar com a WizeBot pela [API](https://help.wizebot.com.br/tutoriais/api/introducao-api-whatsapp.md): enviar mensagens, consultar contatos, aplicar etiquetas. Cada chave pertence a uma empresa e só enxerga os dados dela.

As chaves ficam em **Configurações** > **API Keys**, na seção **Automação** do menu. Só o dono da empresa e os administradores conseguem criar e gerenciar chaves.

**1. Abra a tela de chaves**

Acesse **Configurações**, clique em **API Keys** e depois em **Nova API Key**. Se ainda não houver nenhuma chave, o botão **Criar primeira API Key** no meio da tela faz o mesmo.

![Tela API Keys com o botão Nova API Key destacado](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/01-nova-api-key.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=ba95e7a666d7a4ad9d8a289b97b0f987)

**2. Dê um nome à chave**

Na janela **Nova API Key**:

1. Em **Nome da Chave**, escreva para que ela serve, como "Integração com a loja virtual". Esse campo é obrigatório.
2. Em **Descrição (opcional)**, anote um detalhe que ajude a reconhecer a chave depois.
3. Clique em **Criar Chave**.

Use uma chave por sistema. Assim, se um deles vazar ou for desligado, você exclui só a chave dele e os outros continuam funcionando.

![Janela Nova API Key com Nome da Chave, Descrição (opcional) e o botão Criar Chave numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/02-nome-descricao.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=c1cf3cf5ed1178bd236a9b439e01d375)

**3. Copie a chave agora**

A janela muda para **API Key Criada!** e mostra a chave completa. Clique no botão de copiar (1) e cole a chave no sistema que vai usá-la ou num cofre de senhas. O ícone de olho ao lado esconde e mostra a chave na tela. Depois clique em **Fechar** (2).

![Janela API Key Criada! com a chave de exemplo, o botão de copiar e o botão Fechar numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/03-chave-criada.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=fac01f5729305d8e86f4f66648b569d2)

> [!WARNING]
>
> A chave completa aparece uma única vez. A WizeBot guarda só um resumo criptográfico dela, então não há como ver a chave de novo depois que a janela fecha. Se você perder a chave, use **Regenerar** (passo 5) para gerar outra.

**4. Confira a chave na lista**

A chave nova aparece no topo da lista com o selo **Ativa**. No quadro cinza fica só o começo da chave, seguido de reticências, para você saber qual é qual. Esse trecho não funciona como chave: o botão de copiar ao lado dele copia apenas o começo.

Abaixo aparecem **Uso** (quantas requisições a chave já fez), **Último uso**, **Limite/min** (requisições por minuto) e a data em que foi **Criada**.

![Lista de chaves com o início da chave Integração com a loja virtual destacado](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/04-chave-na-lista.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=4a1e3e2c8e2d87b6f58c71a122501f92)

**5. Desative, regenere ou exclua quando precisar**

Cada chave tem três controles:

1. **Chave liga/desliga**: desligada, a chave passa a **Inativa** e toda requisição feita com ela é recusada. Ligue de novo para voltar a usar a mesma chave.
2. **Regenerar**: gera uma chave nova no lugar desta, com o mesmo nome. A chave antiga para de funcionar na hora, e a nova aparece uma única vez, como no passo 3. Use quando a chave vazou ou foi perdida.
3. **Excluir**: apaga a chave de vez.

![Cartão da chave com a chave liga/desliga, o botão Regenerar e o botão Excluir numerados](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/05-gerenciar.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=a5c05c5d9ac05ecc8abcf0ab2c6ef484)

**6. Confirme a exclusão**

Ao clicar em **Excluir**, a WizeBot pede confirmação. Clique em **Excluir** de novo para apagar. Não dá para desfazer, e todo sistema que usa essa chave para de funcionar.

![Janela Excluir API Key? com o botão Excluir destacado](https://mintcdn.com/wizebot-d8529edc/avKgCLahmW1whcNE/images/chave-api/06-excluir.png?fit=max\&auto=format\&n=avKgCLahmW1whcNE\&q=85\&s=be5e94917f2bdc83c1c35f93e1552e03)

## Onde usar a chave

Envie a chave no cabeçalho de cada requisição, por exemplo `Authorization: Bearer SUA-CHAVE`. As formas aceitas, o teste de conexão e os erros de autenticação estão em [Autenticação da API](https://help.wizebot.com.br/tutoriais/api/autenticacao-api-whatsapp.md).

> [!WARNING]
>
> A chave dá acesso aos dados da sua empresa. Use-a só no seu servidor, nunca em página web, aplicativo de celular ou código público.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.