> ## 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 da API Key

> Permissões do canal RCS: enviar, consultar e cancelar mensagens ricas.

<Tip>
  Cada escopo é uma **porta** na sua chave: enviar, consultar ou cancelar, abra só o necessário.
</Tip>

Cada **escopo** libera um tipo de operação no RCS. Use só o que sua integração precisa.

## Como enviar a chave

**Recomendado**

```http theme={null}
Authorization: Bearer sk_live_sua_chave_aqui
```

**Alternativo**

```http theme={null}
x-api-key: sk_live_sua_chave_aqui
```

<Info>
  A API Key pertence a **um** workspace. Você não acessa outro workspace com a mesma chave.
</Info>

## Combinações comuns

<CardGroup cols={2}>
  <Card title="Só enviar" icon="paper-plane">
    `rcs:send`
  </Card>

  <Card title="Enviar e consultar" icon="magnifying-glass">
    `rcs:send`, `rcs:read`
  </Card>

  <Card title="Com agendamento" icon="clock">
    `rcs:send`, `rcs:cancel`
  </Card>

  <Card title="Fluxo completo" icon="list-check">
    `rcs:send`, `rcs:read`, `rcs:cancel`
  </Card>
</CardGroup>

<Warning>
  Lista de escopos **vazia** na criação = acesso **ADMIN**. Em produção, restrinja sempre.
</Warning>

## Escopos disponíveis

<AccordionGroup>
  <Accordion title="rcs:send">
    Enviar RCS imediato ou agendado para 1 a 100 números por requisição. Tipos: BASIC, CARD, CAROUSEL, FILE.
  </Accordion>

  <Accordion title="rcs:read">
    Consultar status e dados de um envio pelo id.
  </Accordion>

  <Accordion title="rcs:cancel">
    Cancelar mensagem na fila ou agendada. Só com status `QUEUED` ou `SCHEDULED`. Créditos são devolvidos quando aplicável.
  </Accordion>
</AccordionGroup>

## Erros comuns

<AccordionGroup>
  <Accordion title="401: chave ausente, inválida ou revogada">
    Confira `Authorization: Bearer sk_...` e se a chave não foi apagada no painel.
  </Accordion>

  <Accordion title="402: plano bloqueado">
    Workspace suspenso ou expirado. Regularize o plano no painel.
  </Accordion>

  <Accordion title="403: sem escopo ou limite do plano">
    Verifique escopo da operação. Em envio, confira créditos (**60 por mensagem**, `PLAN_LIMIT_CREDITS`) e se agendamento está no plano (`PLAN_LIMIT_SCHEDULING`).
  </Accordion>

  <Accordion title="400: cancelamento inválido">
    Só cancela com status `QUEUED` ou `SCHEDULED`. Depois de enviado, não há cancelamento.
  </Accordion>
</AccordionGroup>

## Próximos passos

* [Quick Start](/rcs-api/como-funciona/quick-start)
* [Eventos dos webhooks](/rcs-api/como-funciona/eventos-do-webhooks)
* [Chaves de API (guia)](/guides/api-key/index)