Inicio
Primeros pasos
Para llamar api-integration necesitas la cuenta de la empresa, su entity_id (customer_id) y el API key. El JWT se pide después, no al revés.
Esta guía cubre el REST de api-integration. MCP (Claude, Cursor, WhatsApp) usa otra autenticación; parte igual por el portal de empresas.
1. Entra al portal de empresas
El partner vive en el portal de empresas. Entra con el email y la contraseña de la compañía. En Configuración → Integraciones están el customer_id y el header id (API key). Ese mismo usuario es el que luego va en generateToken.
2. entity_id es el customer_id
El UUID de la empresa en el portal es entity_id. En la API ese mismo valor se llama customer_id. Cópialo desde Configuración → Integraciones. Si el token falla, casi siempre el UUID no coincide con la cuenta.
3. API key e identidad
Todas las rutas bajo /api/* (excepto health) llevan el header id con el API key de integración. Lo copias en la misma pantalla de Configuración → Integraciones. El email y la contraseña identifican al usuario; el header identifica al canal.
4. Pide el JWT
Con customer_id, email y password, POST /api/auth/generateToken devuelve un JWT (~2h). El resto de módulos (document, template, file) van con Authorization: Bearer.
Body de generateToken:
{
"customer_id": "<entity_id>",
"email": "admin@empresa.cl",
"password": "••••••••"
}