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

# Claves API

> Aprenda cómo funcionan las claves API y cómo usarlas para acceder a Notifique.

<Tip>
  Una clave API es la **tarjeta de acceso** de su sistema a Notifique. Sin ella a pedido, la puerta no se abrirá.
</Tip>

## ¿Qué es una clave API?

Es la credencial que identifica **quién** llama a la API y **a qué espacio de trabajo** pertenece. Piense en una tarjeta de acceso a un edificio: no necesita nombre de usuario ni contraseña en cada solicitud, simplemente presente la tarjeta en el encabezado.

Cada clave comienza con `sk_live_...` (producción) o `sk_test_...` (sandbox).

## ¿Para qué sirve?

La clave conecta su código con Notifique. Con ella podrás:

* **Enviar** mensajes (WhatsApp, SMS, correo electrónico, push y otros canales)
* **Consultar** historial, estado y mensajes entrantes
* **Administrar** instancias, plantillas, contactos y automatizaciones (según los ámbitos seleccionados)

Todo sin una sesión de usuario del panel. Su servidor de aplicaciones se comunica directamente con la API.

## ¿Por qué utilizar claves independientes?

| Situación                                   | Qué hacer                                      |
| ------------------------------------------- | ---------------------------------------------- |
| App de producción + app de prueba           | Una clave para cada una                        |
| Dos sistemas en el mismo espacio de trabajo | Una clave por integración                      |
| Se filtra una clave                         | Revocar solo esa; las demás siguen funcionando |

Como darle a cada empleado su propia tarjeta: si uno pierde la suya, cancelas solo esa tarjeta.

## Qué puedes hacer en el panel

En **Desarrollador → Claves API**, administras las tarjetas de acceso al espacio de trabajo:

* **Ver** qué integraciones ya tienen una clave activa
* **Crear** una nueva clave con un nombre y permisos
* **Revocar** una clave comprometida sin afectar a las demás
* **Rotar** el acceso: una clave por aplicación, servicio o entorno

Cada clave pertenece a un espacio de trabajo (la **carpeta** de su cliente en el sistema) y define lo que esa integración puede hacer.

## Sandbox vs producción

Mismo edificio, diferentes puertas:

* **Sandbox** (`sk_test_...`): **simulador de vuelo**. Pruebas el viaje completo, pero en realidad no se entrega nada. Verifique los envíos en **Desarrollador → Bandeja de entrada de Sandbox**
* **Producción** (`sk_live_...`): **vuelo real**. El mensaje sale y se utilizan los créditos.

[Más información sobre sandbox →](/es/guides/sandbox/index)

## Cómo crear una clave

Las claves se crean en el panel. No puedes crearlas a través de la API pública:

1. Abra **Desarrollador → Claves API**
2. Haga clic en **Crear clave**
3. Asígnela un nombre y seleccione los [ámbitos](#ámbitos-y-permisos): las puertas que esta clave puede abrir
4. Cópiela de inmediato. Comienza con `sk_live_...` o `sk_test_...`

<Warning>
  La clave completa se muestra **solo una vez**, como el PIN de una tarjeta nueva. ¿La perdiste? Crea otra. No podemos recuperarla.
</Warning>

## Cómo utilizar en tu integración

En cada llamada API, presente la tarjeta en el encabezado `Authorization`:

También aceptamos `x-api-key` en lugar de `Authorization`. El recorrido completo está en [Empiece aquí](/es/guides/introducao/comece-aqui).

## Buenas prácticas

1. **Nunca** deje la clave en código público. Guárdela en `.env`, como la contraseña del Wi‑Fi de la oficina
2. **Una clave por integración**. Si la app de prueba se filtra, producción sigue segura
3. **¿Se filtró?** Revóquela en **Desarrollador → Claves API** y emita una nueva de inmediato

Más detalles: [Seguridad y confiabilidad](/es/guides/conceitos/seguranca-e-confiabilidade).

## Ámbitos y permisos

Los ámbitos son las **puertas** que abre cada clave. Seleccione solo lo que su integración necesita. No entregue la llave maestra si solo envía SMS.

Elija el canal que integrará y vea la lista completa de permisos:

<CardGroup cols={2}>
  <Card title="WhatsApp" icon="whatsapp" href="/es/whatsapp-api/como-funciona/escopos-api-key">
    Enviar, conectar número, grupos
  </Card>

  <Card title="SMS" icon="comment-sms" href="/es/sms-api/como-funciona/escopos-da-api-key">
    Enviar, consultar, cancelar
  </Card>

  <Card title="Telegram" icon="paper-plane" href="/es/telegram-api/como-funciona/escopos-api-key">
    Enviar, conectar bot, leer mensajes
  </Card>

  <Card title="Instagram" icon="instagram" href="/es/instagram-api/como-funciona/escopos-api-key">
    Enviar, responder comentarios
  </Card>

  <Card title="Email" icon="envelope" href="/es/emails-api/como-funciona/escopos-da-api-key">
    Enviar, configurar dominio
  </Card>

  <Card title="Push" icon="bell" href="/es/push-api/como-funciona/escopos-da-api-key">
    Enviar, administrar apps
  </Card>

  <Card title="RCS" icon="mobile-screen" href="/es/rcs-api/como-funciona/escopos-da-api-key">
    Enviar, consultar, cancelar
  </Card>

  <Card title="Voice" icon="phone" href="/es/voice-api/como-funciona/escopos-da-api-key">
    Llamar, controlar, grabar
  </Card>

  <Card title="Templates" icon="layer-group" href="/es/template-api/como-funciona/escopos-da-api-key">
    Crear plantillas y enviar
  </Card>

  <Card title="Contactos y audiencia" icon="address-book" href="/es/contacts-api/como-funciona/escopos-da-api-key">
    Contactos, etiquetas, campañas
  </Card>

  <Card title="Automatizaciones" icon="diagram-project" href="/es/automations-api/como-funciona/escopos-da-api-key">
    Flujos y eventos
  </Card>

  <Card title="Enlaces cortos" icon="link" href="/es/short-links-api/como-funciona/escopos-da-api-key">
    Enlaces y conversiones
  </Card>

  <Card title="Números virtuales" icon="hashtag" href="/es/phone-numbers-api/como-funciona/escopos-da-api-key">
    Consultar y configurar
  </Card>

  <Card title="Complementos de marketing" icon="puzzle-piece" href="/es/marketing-addons-api/como-funciona/escopos-da-api-key">
    Formularios e integraciones
  </Card>
</CardGroup>

¿Puerta cerrada? Consulte [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

***

## Próximos pasos

* [Empiece aquí](/es/guides/introducao/comece-aqui): envíe su primer mensaje
* [Webhooks](/es/guides/webhooks/index): reciba alertas en su servidor, como una notificación push