API pública · v1 plan dcf053ee9096
Verbos y lecturas declaradas. Nunca tablas.
Ni tablas ni filtros libres. Esta API ejerce una acción declarada pública, o contesta una lectura declarada pública, con la autorización que su dueño encendió, y te dice con precisión qué pasó.
Una llave actúa, una persona leeUna llave con su alcance ejerce acciones. Las lecturas piden OAuth, en nombre de una persona y con su rol.Tres desenlacesHecho, negado con un motivo con nombre, o esperando una firma.Reintentar es seguroCon una Idempotency-Key nada corre dos veces.Las mismas acciones en todas partesSDK, CLI, n8n y el servidor MCP se generan de un solo plan.
Las acciones de hoy
Ver todo →CRM
crm.call_loggedAnota en la ficha de un cliente, dicho por su nombre, lo que se habló en una llamada; opcionalmente deja creado el seguimiento con su fecha.crm.owner_assignedCambia de quién es un cliente, diciendo el nombre del cliente y el nombre (o correo) del miembro del equipo.crm.stage_movedMueve el negocio abierto de un cliente a otra etapa del pipeline, diciendo el nombre del cliente y el de la etapa.crm.task_createdCrea un recordatorio (tarea con fecha y hora) sobre un cliente dicho por su nombre.crm.deal_createdAbre un negocio nuevo en el pipeline para un cliente dicho por su nombre, con título, valor opcional en USD, etapa opcional (por nombre; sin ella, la primera) y responsable opcional.crm.note_addedGuarda una nota en la ficha de un cliente dicho por su nombre: algo que hay que saber la próxima vez, sin llamada ni fecha.crm.contact_addedAñade una persona (nombre, y opcionalmente correo, teléfono y cargo) a la ficha de un cliente dicho por su nombre.
Kiipu · facturación
kiipu.invoice_proposedDeja preparada una factura como BORRADOR para un cliente dicho por su nombre, con sus líneas e impuestos.kiipu.draft_voidedAnula un BORRADOR de factura (uno creado con kiipu.invoice_proposed y todavía no emitido), por su id o por el nombre del cliente si es su único borrador.kiipu.payment_reportedDeja en la cola de aprobación de Kiipu el aviso de que un cliente (por su nombre) pagó cierto monto de una factura abierta.
Miira · leads y WhatsApp
miira.lead_createCrea un lead nuevo en el CRM del workspace a partir de sus datos de contacto.miira.broadcast_quotedPresupuesta mandar el MISMO mensaje de WhatsApp a varios clientes dichos por su nombre (hasta 50).miira.broadcast_sentEnvía la difusión de WhatsApp presupuestada por miira.broadcast_quoted, exactamente a quienes y como dijo el presupuesto.
Las lecturas de hoy
Ver todo →crm.clients_searchCuenta y busca los clientes del CRM, opcionalmente por parte del nombre, estado, etiqueta o fecha de alta.crm.month_summary_getLee cómo va el mes, pieza por pieza y con las mismas cifras que daría cada lectura: clientes nuevos, lo cobrado, propuestas enviadas y aceptadas, tratos ganados, citas y el resultado contable.kiipu.collections_getLee lo que se debe: el total pendiente, lo vencido por tramo de antigüedad, los 15 clientes que más deben con su vencido y desde cuándo, y las próximas cuotas.kiipu.collected_month_getLee cuánto se cobró este mes hasta hoy (lo que registró el libro), el mismo tramo del mes pasado para comparar y lo que sigue pendiente.kiipu.client_invoices_listLista las últimas facturas y pagos de UN cliente dicho por su nombre: número, estado, total, saldo, y cuándo y cómo pagó.kiipu.month_result_getLee el estado de resultados del mes según el libro: ingresos, gastos, resultado, las cuentas que más pesan y el mes anterior.miira.conversations_waiting_getLee cuántas conversaciones lleva una persona del equipo, cuántas esperan respuesta, cuántas llevan más del umbral de la empresa y la espera más larga.miira.funnel_getLee el embudo de leads de Miira por etapa (la misma regla del tablero), cuántos están calificados, cuántos entraron este mes y los 15 más recientes con su etapa.ciita.agenda_getLee las citas de hoy, esta semana, la próxima o este mes: cuántas por estado y las 15 primeras con día, hora en la zona de la empresa, cliente, recurso y estado.
Paquetes
Ver todo →TypeScript · 0.3.0@vorluno/niiko-sdkEl cliente de TypeScript. Un método tipado por acción y por lectura, una unión Result con los desenlaces, cero dependencias.Python · 0.1.0niikoEl cliente de Python. Dataclasses por acción y por lectura, y un Result con los desenlaces, cero dependencias.TypeScript · 0.3.0niiko-cliLa API de niiko desde la terminal: acciones con una llave, lecturas con un token OAuth, salida JSON y el desenlace en el código de salida.n8n · 0.1.2n8n-nodes-niikoCada acción pública como operación de n8n, las negativas como dato, usable como herramienta de un AI Agent. En inglés y español.MCP · 2026-10-18niiko-mcp-serverEl servidor MCP remoto. Conecta Claude o cualquier cliente con OAuth y cada acción y lectura que concedas se vuelve una herramienta; las lecturas, marcadas de solo lectura.
Últimos cambios
Ver todo →- Los SDK y la CLI leen
@vorluno/niiko-sdk,niikoyniiko-cli0.3.0 aceptan un token de acceso OAuth (accessToken,access_token=,niiko login --token) y tienen un método de solo lectura por lectura:getCollections(),get_collections(),niiko read kiipu.collections_get. - Una difusión puede declararse promoción
miira.broadcast_quotedacepta unpurposeopcional:notice(el de siempre, sin cambios) opromotion. - Lecturas declaradas, solo con OAuth
POST /api/v1/reads/{id}contesta nueve lecturas declaradas —lo que se debe, lo cobrado, la agenda, el embudo, el mes—, nunca tablas ni texto que alguien escribió. - Las difusiones ya no esperan a las horas de silencioniiko ya no difiere ni excluye envíos por la hora del día.