Permisos
Cada clave tiene una lista de permisos (scopes) que eligió quien la creó. Todos los permisos de
una clave son de lectura (los de escritura son solo del conector de IA; ver «Permisos del conector de IA» más abajo). Una operación que pide un permiso que la clave no tiene responde
403 insufficient_scope, con el permiso que falta en error.details.requiredScope y en el
encabezado WWW-Authenticate.
| Permiso | Operaciones que abre |
|---|---|
| (ninguno) | GET /me |
clients:read | GET /clients, GET /clients/{clientId} |
work_orders:read | GET /work-orders, GET /work-orders/{workOrderId}, GET /visits |
job_forms:read | GET /work-orders/{workOrderId}/job-forms, GET /job-form-templates, GET /job-form-templates/{templateId}/submissions |
quotes:read | GET /quotes, GET /quotes/{quoteId} |
sale_notes:read | GET /sale-notes, GET /sale-notes/{saleNoteId} |
assets:read | GET /assets, GET /assets/{assetId}, GET /assets/{assetId}/history |
catalog:read | GET /catalog-items, GET /catalog-items/{itemId} |
team:read | GET /team-members |
tickets:read | GET /tickets, GET /tickets/{ticketId} |
Las claves creadas antes de que existiera tickets:read no lo tienen: los permisos de una clave
quedan fijos al crearla (ver «Cambiar los permisos de una clave»).
Datos de contacto del cliente
El correo y el teléfono del cliente son datos personales: solo salen con clients:read.
- Con
clients:read,GET /clientsyGET /clients/{clientId}devuelven el correo, el teléfono y los contactos del cliente. - En
GET /work-orders/{workOrderId},GET /quotes/{quoteId}yGET /sale-notes/{saleNoteId}, el correo y el teléfono del cliente (y, en el trabajo, su contacto) vienen ennullsalvo que la clave tenga tambiénclients:read. El nombre del cliente sale siempre.
Así puedes dar a una integración de cobranza acceso a las notas de venta sin exponer los datos de contacto de tus clientes.
Cambiar los permisos de una clave
Los permisos quedan fijos al crear la clave. Para cambiarlos, crea otra clave con los permisos nuevos y revoca la anterior (ver Autenticación).
Permisos del conector de IA
El conector de IA (Claude, ChatGPT) usa los mismos permisos de lectura de
arriba (con tickets:read ve solo los tickets que tu usuario puede ver en Kellu) y, además, estos permisos que una clave nunca puede tener: al crear una clave no aparecen y
la API los rechaza.
| Permiso | Qué permite |
|---|---|
clients:write | Crear y editar clientes, sus contactos y sus direcciones. |
work_orders:write | Crear trabajos (con visita agendada y técnicos), cambiar o deshacer el estado de una visita, confirmar una visita, marcar un trabajo como «no requiere agenda» y agregar notas. |
quotes:write | Crear cotizaciones en borrador, incluido crear el trabajo que la contiene si no existe, y reemplazar los ítems de un trabajo. Si pides aplicar las condiciones a las cotizaciones futuras, cambia (o borra, si van vacías) las condiciones por defecto del negocio. |
sale_notes:write | Crear notas de venta en borrador, incluido crear el trabajo que la contiene si no existe, y reemplazar los ítems de un trabajo. |
reminders:read | Ver los recordatorios de seguimiento de clientes y de mantención de equipos. |
reminders:write | Crear y editar esos recordatorios. |
tickets:write | Crear tickets, responderlos o agregarles notas internas, cambiar su estado, asignarles responsable, fijarles fecha límite y posponerlos. Una respuesta al cliente o cerrar un ticket le avisa por correo; una nota interna no. |
messages:send | Enviar a tus clientes cotizaciones, notas de venta y confirmaciones de visita, por correo y WhatsApp, con el paso de preparar y confirmar. Enviar un borrador lo emite, así que enviar un documento necesita también quotes:write o sale_notes:write y clients:read; la confirmación de visita, clients:read. |
Los permisos que el asistente usa de verdad son los que aprobaste y cubre tu perfil en Kellu: por
ejemplo, clients:write exige que tu perfil pueda crear y editar clientes.