> ## 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 para administrar plantillas y ejecutar envíos multicanal.

<Tip>
  **`templates:*`** gestiona modelos; **`whatsapp:send`**, **`sms:send`**, etc. **envían**. Tener `templates:create` **no** basta para enviar.
</Tip>

Cada **alcance** desbloquea un tipo de operación en Plantillas. 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>

## Dos familias de alcance

| Familia             | Para qué                                                                                                                                |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **`templates:*`**   | Crear, listar, editar y eliminar plantillas                                                                                             |
| **Envío por canal** | Enviar con **Enviar por plantilla** (`whatsapp:send`, `sms:send`, `email:send`, `telegram:send`, `rcs:send`, `push:send`, `voice:call`) |

<Warning>
  Tener `templates:create` **no** basta para enviar. Al enviar, cada canal solicitado necesita el alcance de envío de ese canal.
</Warning>

## Combinaciones comunes

<CardGroup cols={2}>
  <Card title="Solo enviar" icon="paper-plane">
    `whatsapp:send`, `sms:send`, `email:send`, `rcs:send`, etc. (según canales usados)
  </Card>

  <Card title="Solo gestionar modelos" icon="folder">
    `templates:read`, `templates:create`, `templates:update`, `templates:delete`
  </Card>

  <Card title="App completa" icon="layer-group">
    Todos los `templates:*` + alcances de envío de los canales de la plantilla
  </Card>

  <Card title="Solo consultar" icon="magnifying-glass">
    `templates:read`
  </Card>
</CardGroup>

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

## Alcances de gestión (`templates:*`)

<AccordionGroup>
  <Accordion title="templates:read">
    Listar plantillas y obtener detalle por ID.
  </Accordion>

  <Accordion title="templates:create">
    Crear plantilla nueva en el espacio de trabajo.
  </Accordion>

  <Accordion title="templates:update">
    Editar plantilla existente (canales, textos, valores predeterminados de variables, traducciones).
  </Accordion>

  <Accordion title="templates:delete">
    Eliminar plantilla.
  </Accordion>
</AccordionGroup>

## Alcances de envío (por canal)

En **Enviar por plantilla**, valide el alcance de **cada** canal en `channels`:

| Canal en `channels` | Alcance necesario                     |
| ------------------- | ------------------------------------- |
| `whatsapp`          | `whatsapp:send`                       |
| `sms`               | `sms:send`                            |
| `email`             | `email:send`                          |
| `telegram`          | `telegram:send`                       |
| `rcs`               | `rcs:send`                            |
| `push`              | `push:send`                           |
| `voice`             | **`voice:call`** (no es `voice:send`) |

El estado de **entrega** (enviado, entregue, fallido) proviene de los **webhooks del canal**, no de un webhook de envío de plantilla.

El estado de **aprobación Meta** (aprobado, rechazado, pausado, categoría) proviene de eventos **`template.*`**. Consulte [Eventos de webhook](/es/template-api/como-funciona/eventos-do-webhooks).

## Errores comunes

| HTTP    | Situación                                                                                                       |
| ------- | --------------------------------------------------------------------------------------------------------------- |
| **403** | Alcance ausente (`Missing scope: templates:read`, `Missing scope: rcs:send`, `Missing scope: voice:call`, etc.) |
| **403** | Créditos insuficientes para toda la solicitud (`INSUFFICIENT_CREDITS`)                                          |
| **402** | Límite de gasto de la clave o espacio de trabajo bloqueado                                                      |

Detalle en la **referencia de API** en la pestaña Plantillas.

## Próximos pasos

* [Inicio rápido](/es/template-api/como-funciona/quick-start)
* [Introducción](/es/template-api/como-funciona/introducao)
* [Plantillas oficiales Meta](/es/template-api/como-funciona/templates-oficiais-meta)
* [Eventos de webhook](/es/template-api/como-funciona/eventos-do-webhooks)