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

# Escopos

> Permissões OAuth — os mesmos escopos da API Key, aprovados pelo usuário na tela de consentimento.

<Tip>
  **Escopo** = o que o token pode fazer. Peça só o necessário — o usuário vê a lista inteira antes de aprovar.
</Tip>

## Como funcionam no OAuth

Você declara escopos em **dois momentos**:

1. **Registro do cliente** — padrão do app (painel ou `POST /oauth/register`)
2. **Autorização** — o que pede naquele login (`scope` na URL `/oauth/authorize`)

O token só funciona nos endpoints que o escopo cobre — **igual à API Key**.

## Lista por canal

Os escopos OAuth são os mesmos de cada canal:

| Canal     | Guia                                                                             |
| --------- | -------------------------------------------------------------------------------- |
| E-mail    | [Escopos (E-mail)](/emails-api/como-funciona/escopos-da-api-key)                 |
| WhatsApp  | [Escopos (WhatsApp)](/whatsapp-api/como-funciona/escopos-api-key)                |
| SMS       | [Escopos (SMS)](/sms-api/como-funciona/escopos-da-api-key)                       |
| Contatos  | [Escopos (Contatos)](/contacts-api/como-funciona/escopos-da-api-key)             |
| Webhooks  | `webhooks:read`, `webhooks:manage` — [Webhooks](/guides/webhooks/index)          |
| Logs      | `logs:read` — [Logs](/guides/logs/index)                                         |
| Workspace | `workspace:read`, `workspace:create`, … — [Workspaces](/guides/workspaces/index) |

<Info>
  Hosts MCP costumam pedir escopos amplos. No seu app, restrinja ao mínimo.
</Info>

## Exemplos comuns

| Caso                       | Escopos                                             |
| -------------------------- | --------------------------------------------------- |
| Enviar e-mail transacional | `email:send`                                        |
| CRM + disparo              | `contacts:read`, `contacts:create`, `whatsapp:send` |
| Só ler logs de integração  | `logs:read`                                         |

Múltiplos escopos na query: `scope=email:send%20contacts:read` (separados por espaço).

## Próximos passos

* [Quick Start](/oauth-api/como-funciona/quick-start)
* [Introdução](/oauth-api/como-funciona/introducao)
* [Chaves de API](/guides/api-key/index) — mesmos escopos, modelo diferente