# aidesk Developers

> API pública da aidesk — envio de mensagens, templates, webhooks e integrações.

## Docs

- [Health / auth check](https://developers.aideskbr.com/api-reference/health/health-auth-check.md): Confirma que a API key é válida e retorna organização e scopes. Consome o bucket de rate limit **read**.
- [Enviar mensagem](https://developers.aideskbr.com/api-reference/messages/enviar-mensagem.md): Envia texto, mídia ou template. Requer scope `messages:send`.
- [Status da mensagem](https://developers.aideskbr.com/api-reference/messages/status-da-mensagem.md): Consulta status/delivery de uma mensagem enviada pela API pública. Requer scope `messages:read`. Consome bucket **read**.
- [Atualizar webhook](https://developers.aideskbr.com/api-reference/webhooks/atualizar-webhook.md): Atualiza `url` e/ou `event_types`. `event_types` é obrigatório no PATCH (substitui a lista inteira). Não regenera o secret.
- [Criar webhook](https://developers.aideskbr.com/api-reference/webhooks/criar-webhook.md): Cria endpoint de webhook. O `secret` (`whsec_...`) é retornado **uma vez**. Scope `webhooks:manage` (não vem no default da key — peça na criação).
- [Listar webhooks](https://developers.aideskbr.com/api-reference/webhooks/listar-webhooks.md): Lista endpoints cadastrados (sem secret). Scope `webhooks:manage`.
- [Remover webhook](https://developers.aideskbr.com/api-reference/webhooks/remover-webhook.md): Soft-delete (`disabled_at`). Scope `webhooks:manage`.
- [Autenticação](https://developers.aideskbr.com/authentication.md): API keys, headers e escopos da API pública.
- [Erros e rate limits](https://developers.aideskbr.com/errors-rate-limits.md): Códigos canônicos, buckets send/read e headers 429.
- [Introdução](https://developers.aideskbr.com/index.md): Visão geral da API pública aidesk para integradores.
- [Quickstart](https://developers.aideskbr.com/quickstart.md): Valide a key e envie a primeira mensagem em poucos minutos.
- [Webhooks](https://developers.aideskbr.com/webhooks.md): Receba eventos de delivery com assinatura HMAC.

## OpenAPI Specs

- [openapi](https://developers.aideskbr.com/openapi.yaml)