Alcances de la API Key

Cada alcance es una puerta en tu clave: app, usuario, conversación o mensaje — abre solo lo necesario.

El JWT del usuario no usa estos alcances. Autentica la app del cliente en /v1/chat/* y en el WebSocket. La API Key es para tu backend.

Authorization: Bearer sk_live_tu_clave

La clave pertenece a un workspace. No envíes x-workspace-id en v1.

Combinaciones habituales

chat:apps:create, chat:apps:manage, chat:apps:list

chat:users

chat:conversations:read, chat:conversations:write

chat:messages:send, chat:messages:read

Lista de alcances vacía al crear = acceso ADMIN. Restringe en producción.

chat:apps:list — listar y consultar Chat Apps
chat:apps:create — crear (la respuesta incluye el signing secret)
chat:apps:manage — actualizar y rotar el secret
chat:apps:delete — borrar (soft delete)
chat:users — upsert, JWT y agentes
chat:conversations:read / chat:conversations:write
chat:messages:send (1 crédito CHAT_MESSAGE) / chat:messages:read / chat:messages:delete

Quién	Crea conversación (flags off)	Envía mensaje
API Key	Sí	Sí (`senderExternalUserId`)
JWT	No (`CHAT_CLIENT_CREATE_DISABLED`)	Sí, si es miembro

Errores: 401 CHAT_INVALID_TOKEN, 403 sin alcance u origen, 402 créditos, 409 CHAT_DIRECT_EXISTS.