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

# API Keys

> Crie e gerencie chaves de API para integrar serviços externos com sua conta Jelou

As API keys permitem que você autentique requisições à API Jelou a partir de aplicativos ou serviços externos. Com elas você pode enviar mensagens, gerenciar campanhas, consultar conversas e muito mais, de forma programática.

## Acessando as API Keys

Para gerenciar suas API keys, vá em **Configurações** > **API Keys** no menu lateral.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/settings-sidebar.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae70ce82a0d0a9c840af8a93191ad784" alt="Menu lateral de configurações mostrando a opção API Keys na seção Geral" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/settings-sidebar.png" />
</Frame>

Você verá uma tabela com todas as API keys existentes na sua conta, incluindo:

* **Chave**: Identificador parcialmente oculto da chave
* **Data de criação**: Quando foi gerada
* **Ações**: Opções disponíveis para cada chave

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-keys-list.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae8a8c68e75a94df0134eee969ae0f4b" alt="Visualização em tabela das API Keys mostrando as chaves existentes com sua data de criação e ações disponíveis" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-keys-list.png" />
</Frame>

## Criar uma API key

<Steps>
  <Step title="Iniciar a criação">
    Clique no botão **Criar** localizado no canto superior direito da página.
  </Step>

  <Step title="Confirmar a criação">
    Uma caixa de diálogo de confirmação será exibida. Clique em **Criar** para gerar a nova chave.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/create-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=6dcaa96abbf0f9a0017d1b81e61a0bcd" alt="Caixa de diálogo de confirmação para criar uma nova API key" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/create-api-key-modal.png" />
    </Frame>
  </Step>

  <Step title="Copiar sua chave">
    A chave gerada será exibida na tela. Use o botão de cópia para salvá-la na área de transferência.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-key-created.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=8c124f1e1fbb8b3cc7bd3babc0ac7519" alt="Caixa de diálogo mostrando a API key recém-criada com um botão de cópia e aviso de visibilidade única" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-key-created.png" />
    </Frame>

    <Warning>
      A chave é exibida apenas **uma vez**. Copie-a e armazene-a em um lugar seguro antes de fechar a caixa de diálogo. Se você a perder, precisará criar uma nova.
    </Warning>
  </Step>
</Steps>

## Excluir uma API key

Para excluir uma chave que você não precisa mais, clique no ícone de excluir (lixeira) na coluna **Ações** da chave correspondente.

Uma caixa de diálogo de confirmação será exibida antes de prosseguir.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/delete-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=1536199cea71c2ac4a7d573bd0c99632" alt="Caixa de diálogo de confirmação para excluir uma API key, alertando que a ação não pode ser desfeita" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/delete-api-key-modal.png" />
</Frame>

<Warning>
  Excluir uma API key é uma ação **irreversível**. Qualquer integração que use essa chave deixará de funcionar imediatamente. Verifique se nenhum serviço ativo depende da chave antes de excluí-la.
</Warning>

## Usar sua API key

Inclua a API key no cabeçalho `x-api-key` das suas requisições HTTP:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://gateway.jelou.ai/platform/v1/company/{companyId} \
    --header 'x-api-key: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://gateway.jelou.ai/platform/v1/company/{companyId}",
    {
      headers: {
        "x-api-key": "YOUR_API_KEY",
      },
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://gateway.jelou.ai/platform/v1/company/{companyId}",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  ```
</CodeGroup>

<Tip>
  Consulte a [referência da API](/pt/api/introducao) para ver todos os endpoints disponíveis.
</Tip>

## Boas práticas

* **Não compartilhe chaves** em repositórios públicos ou mensagens. Use variáveis de ambiente para armazená-las.
* **Rotacione suas chaves periodicamente**. Crie uma nova chave, atualize suas integrações e exclua a antiga.
* **Use uma chave por integração**. Se uma chave for comprometida, você pode revogá-la sem afetar outros serviços.