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

# API keys

> Crie chaves para integrar sistemas externos com a aidesk.

# API keys

API keys permitem que o seu CRM, ERP ou backend envie mensagens e receba webhooks pela **API pública**.

Documentação técnica completa: [developers.aideskbr.com](https://developers.aideskbr.com).

## Quem pode criar

Owners/admins com permissão `integrations.manage_api` (padrão para esses papéis).

## Como criar (visão produto)

1. Entre no [app](https://app.aideskbr.com) como admin.
2. Abra as configurações de **integrações / API keys** da organização.
3. Crie uma key com nome claro (ex. “CRM produção”).
4. Escolha os **scopes** necessários (`messages:send`, `messages:read`, etc.).
5. **Copie o secret `ak_live_...` imediatamente** — ele não é mostrado de novo.
6. Guarde em um cofre de secrets (nunca no código-fonte público).

Para webhooks, inclua o scope `webhooks:manage` (não vem no default).

## Rotacionar e revogar

* **Rotacionar** — gera um secret novo (o antigo deixa de funcionar).
* **Revogar** — invalida a key na hora para novos requests.

Mensagens já enfileiradas antes da revogação podem continuar no worker.

## Base URL

```
https://api.aideskbr.com
```

Teste rápido:

```bash theme={null}
curl -sS https://api.aideskbr.com/api/public/v1/ping \
  -H 'Authorization: Bearer ak_live_SUA_KEY'
```

Continue no [Quickstart da API](https://developers.aideskbr.com/quickstart).