Claves API

​

¿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?

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 →

​

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: las puertas que esta clave puede abrir
4. Cópiela de inmediato. Comienza con sk_live_... o sk_test_...

​

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

​

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.

​

Á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: ¿Puerta cerrada? Consulte Respuestas de error.

---

​

Próximos pasos

• Empiece aquí: envíe su primer mensaje
• Webhooks: reciba alertas en su servidor, como una notificación push