Está tardando más de lo normal. Tu conexión parece débil.
KelluDesarrolladores
Referencia interactivaOpenAPIManual UTCP

Guías

  • Inicio
  • Inicio rápido
  • Autenticación
  • Permisos
  • Paginación y errores
  • Recursos y operaciones
  • Webhooks
  • WhatsApp por webhook
  • Agentes de IA, OpenAPI y UTCP
  • Conector de IA (Claude y ChatGPT)
  • Guía: usar Kellu desde Claude y ChatGPT
  • Kellu AI connector: user guide (English)

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.

PermisoOperaciones que abre
(ninguno)GET /me
clients:readGET /clients, GET /clients/{clientId}
work_orders:readGET /work-orders, GET /work-orders/{workOrderId}, GET /visits
job_forms:readGET /work-orders/{workOrderId}/job-forms, GET /job-form-templates, GET /job-form-templates/{templateId}/submissions
quotes:readGET /quotes, GET /quotes/{quoteId}
sale_notes:readGET /sale-notes, GET /sale-notes/{saleNoteId}
assets:readGET /assets, GET /assets/{assetId}, GET /assets/{assetId}/history
catalog:readGET /catalog-items, GET /catalog-items/{itemId}
team:readGET /team-members
tickets:readGET /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 /clients y GET /clients/{clientId} devuelven el correo, el teléfono y los contactos del cliente.
  • En GET /work-orders/{workOrderId}, GET /quotes/{quoteId} y GET /sale-notes/{saleNoteId}, el correo y el teléfono del cliente (y, en el trabajo, su contacto) vienen en null salvo que la clave tenga también clients: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.

PermisoQué permite
clients:writeCrear y editar clientes, sus contactos y sus direcciones.
work_orders:writeCrear 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:writeCrear 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:writeCrear notas de venta en borrador, incluido crear el trabajo que la contiene si no existe, y reemplazar los ítems de un trabajo.
reminders:readVer los recordatorios de seguimiento de clientes y de mantención de equipos.
reminders:writeCrear y editar esos recordatorios.
tickets:writeCrear 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:sendEnviar 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.