Configuración

API keys

Las API keys te permiten usar la API de Waiify desde tus propios sistemas. Se gestionan en Configuración → Desarrolladores (/settings).

Crear una API key

En la sección Desarrolladores, elige Crear API key.
Ponle un nombre descriptivo (ej. “Integración ERP”).
Copia la clave: solo se muestra una vez. Guárdala en un lugar seguro (un gestor de secretos).

Estados

Estado	Significado
Activa	Funciona normalmente
Revocada	Desactivada manualmente
Expirada	Llegó a su fecha de expiración

Cada key muestra su prefijo (para identificarla sin exponerla), su fecha de creación y su último uso.

Revocar

Si una clave se filtró o ya no se usa, revócala. Deja de funcionar de inmediato; las integraciones que la usaban deberán cambiar a una nueva.

Buenas prácticas de seguridad

Una API key da acceso completo a ese workspace, equivalente al dueño (OWNER) — no es un token de solo lectura. Trátala como una contraseña.
Una key por integración — así puedes revocar una sin afectar las demás.
Nunca la publiques en código cliente, repositorios o capturas.
Guárdala en variables de entorno o un gestor de secretos.
Revoca las que ya no uses.

Cómo se usa

La key se envía en el header Authorization: Bearer <api-key>. Ver autenticación de la API.

ID del workspace

Además de la key, casi todos los endpoints necesitan el ID del workspace en la ruta (/workspaces/:workspaceId/...).

Lo encuentras en esta misma sección Desarrolladores, en la tarjeta ID del workspace: pulsa el botón de copiar y pégalo en tu integración. Si tienes varios workspaces, la tarjeta muestra el del workspace activo — copia el que corresponda a la key que vas a usar, porque una key solo sirve para el workspace donde se creó.

A diferencia de la key, el ID del workspace no es un secreto: puedes volver a consultarlo cuando quieras.

Relacionado

Referencia de API · Roles y permisos