> ## 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.

# Alcances clave API

> Permisos del canal SMS: enviar, leer historial y cancelar mensajes programados.

<Tip>
  La **clave API** es su tarjeta de acceso: cada **alcance** abre una puerta. En producción, conceda solo lo que su integración necesita.
</Tip>

## En breve

* Los alcances `sms:*` cubren envío, lectura y cancelación.
* SMS **no utiliza instancias**; no hay `instanceIds` en este canal.
* Guía general: [Claves API](/es/guides/api-key/index). Primer envío: [Inicio rápido](/es/sms-api/como-funciona/quick-start).

***

## Cómo enviar la clave

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

Alternativa: `x-api-key: sk_live_xxxxx`.

<Warning>
  Alcances **vacíos** al crear = acceso **ADMIN** (todo). En producción, restrinja siempre.
</Warning>

***

## Combinaciones listas

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

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

  <Card title="Con programación" icon="clock">
    `sms:send`, `sms:cancel`
  </Card>

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

***

## Alcances disponibles

<AccordionGroup>
  <Accordion title="sms:send">
    Enviar SMS inmediato o programado (`POST /v1/sms/messages`).
  </Accordion>

  <Accordion title="sms:read">
    Listar enviados, consultar por id y SMS recibidos (MO).
  </Accordion>

  <Accordion title="sms:cancel">
    Cancelar programado (`SCHEDULED`); créditos reembolsados.
  </Accordion>
</AccordionGroup>

***

## Errores comunes

| HTTP / `code`                   | Qué hacer                                |
| ------------------------------- | ---------------------------------------- |
| **401** `UNAUTHORIZED`          | Verifique `Authorization: Bearer sk_...` |
| **403** alcance ausente         | Agregue el alcance de la ruta a la clave |
| **403** `PLAN_LIMIT_CREDITS`    | Créditos insuficientes para enviar       |
| **403** `PLAN_LIMIT_SCHEDULING` | Programación no incluida en su plan      |

Catálogo completo: [Respuestas de error](/es/guides/conceitos/resposta-de-erros) (acordeón **SMS**).

***

## Próximos pasos

* [Inicio rápido](/es/sms-api/como-funciona/quick-start)
* [Eventos webhook](/es/sms-api/como-funciona/eventos-do-webhooks)
* [Introducción](/es/sms-api/como-funciona/introducao)