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

# Autenticação

Para viabilizar a comunicação segura entre sua aplicação e a Wegly, utilizamos o padrão **JSON Web Token (JWT)** via protocolo **Bearer Token**. Este método garante a integridade e a autenticidade de cada interação com nossa API.

O token gerado deve ser incluído obrigatoriamente no cabeçalho (*header*) de cada requisição HTTP para que o sistema valide as permissões de acesso. Caso o token não seja enviado ou esteja expirado, a requisição não será processada.

Abaixo, detalhamos o fluxo técnico necessário para a geração e o gerenciamento desse token, assegurando que a integração ocorra dentro dos padrões de segurança estabelecidos.

### Como criar uma Chave de Acesso (API) na Wegly

### 1. Acessar as Configurações

1. No canto **superior direito** da tela, clique no ícone de **engrenagem** ⚙️ para acessar as configurações.
2. Role a página até encontrar a seção **Integrações**.
3. Clique na opção **Gerenciar chaves**.

### 2. Criar uma Nova Chave

1. Na tela de gerenciamento, clique no botão **Nova chave**.
2. Preencha os campos necessários:
   * **Nome:** Dê um nome para a chave (Ex: "Chave demonstrativa").
   * **Domínio (Opcional):** Você pode restringir o acesso a um domínio específico para aumentar a segurança.
   * **Data de Validade (Opcional):** Defina até quando essa chave funcionará.

### 3. Configurar Permissões

É recomendado seguir o princípio do privilégio mínimo:

1. **Desative** a seleção de todas as permissões.
2. Clique em **Gerenciar permissões**.
3. Selecione **apenas** o que será utilizado.
   * *Exemplo:* Se for para um formulário de contato, marque apenas **Criar Leads**.

### 4. Salvar e Copiar

1. Clique em **Salvar**.
2. Clique em **Criar chave**.
3. **⚠️ IMPORTANTE:** Clique imediatamente no botão **Copiar**.
   * A chave completa é exibida apenas uma vez. Se você fechar a janela sem copiar, não conseguirá vê-la novamente.
   * Salve-a em um local seguro (como seu gerenciador de senhas ou variáveis de ambiente).