> ## 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 RCS: enviar, consultar y cancelar mensajes enriquecidos.

<Tip>
  Cada alcance es una **puerta** en su clave: envíe, consulte o cancele. Abra solo lo que necesite.
</Tip>

Cada **alcance** desbloquea un tipo de operación RCS. Use solo lo que su integración necesita.

## Cómo enviar la clave

**Recomendado**

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

**Alternativo**

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

<Info>
  Cada clave API pertenece a **un** espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.
</Info>

## Combinaciones comunes

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

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

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

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

<Warning>
  Lista de alcances **vacía** al crear = acceso **ADMIN** (todo). En producción, restrinja siempre.
</Warning>

## Alcances disponibles

<AccordionGroup>
  <Accordion title="rcs:send">
    Enviar RCS inmediatos o programados a entre 1 y 100 números por solicitud. Tipos: BASIC, CARD, CAROUSEL, FILE.
  </Accordion>

  <Accordion title="rcs:read">
    Consultar estado y datos de un envío por id.
  </Accordion>

  <Accordion title="rcs:cancel">
    Cancelar mensaje en cola o programado. Solo con estado `QUEUED` o `SCHEDULED`. Créditos reembolsados cuando corresponda.
  </Accordion>
</AccordionGroup>

## Errores comunes

<AccordionGroup>
  <Accordion title="401: clave ausente, inválida o revocada">
    Verifique `Authorization: Bearer sk_...` y que la clave no se eliminó en el panel.
  </Accordion>

  <Accordion title="402: plan bloqueado">
    Espacio de trabajo suspendido o caducado. Corrija el plan en el panel.
  </Accordion>

  <Accordion title="403: alcance ausente o límite del plan">
    Verifique el alcance de la operación. Al enviar, confirme créditos (**60 por mensaje**, `PLAN_LIMIT_CREDITS`) y si la programación está en el plan (`PLAN_LIMIT_SCHEDULING`).
  </Accordion>

  <Accordion title="400: cancelación inválida">
    Cancelar solo funciona con estado `QUEUED` o `SCHEDULED`. Después del envío, la cancelación no está disponible.
  </Accordion>
</AccordionGroup>

## Próximos pasos

* [Inicio rápido](/es/rcs-api/como-funciona/quick-start)
* [Eventos de webhook](/es/rcs-api/como-funciona/eventos-do-webhooks)
* [Guía de claves API](/es/guides/api-key/index)