API Keys
Cómo crear API keys para integraciones máquina a máquina (M2M).
Las API keys permiten que sistemas externos se autentiquen contra CX Inbox sin usar credenciales de usuario. Son ideales para integraciones máquina a máquina (M2M), webhooks y automatizaciones.
Crear una API key
Ve a Configuración → API Keys y haz clic en + Nueva API key.
| Campo | Descripción |
|---|---|
| Nombre | Nombre descriptivo (ej: "Integración CRM", "Zapier") |
| Descripción | (Opcional) Para qué se usa esta key |
Al crear la key, se muestra el valor completo una sola vez. Cópiala y guárdala en un lugar seguro.
La API key solo se muestra al momento de crearla. Si la pierdes, deberás eliminar la key y crear una nueva.
Formato y uso
Las API keys tienen el prefijo cxi_ y se envían en el header X-API-Key:
X-API-Key: cxi_tu_api_key_aquiLa key se hashea con SHA-256 — CX Inbox nunca almacena el valor en texto plano.
Gestionar keys
La tabla muestra todas las keys con:
| Columna | Descripción |
|---|---|
| Nombre | Nombre de la key |
| Prefijo | Primeros caracteres (para identificarla) |
| Última vez usada | Fecha del último uso |
| Creada | Fecha de creación |
| Acciones | Eliminar |
Limitaciones
Las API keys autentican a nivel de organización pero no tienen userId. Esto significa que endpoints que requieren un usuario específico (ej: asignarse una conversación) no funcionan con API keys.
Para la referencia completa de los endpoints disponibles, consulta la documentación de la API.
¿Esta página fue útil?