Lecturas
Lecturas
Cada pregunta que contesta la API, agrupada por módulo. Cada lectura tiene su contrato, sus ejemplos en cuatro clientes y los motivos por los que puede negarse. Nunca una tabla, y nunca texto que escribió un cliente o el equipo.
Última actualización
Solo con OAuth
Una lectura se hace en nombre de la persona que autorizó tu aplicación, con su rol: contesta con lo que esa persona ve en su propia pantalla. Una llave de API recibe reads_need_a_person. Autenticación →
CRM
crm.clients_searchv1Cuenta y busca los clientes del CRM, opcionalmente por parte del nombre, estado, etiqueta o fecha de alta. Devuelve el total, el total por estado y hasta 15 clientes con su estado, su dueño y su día de alta. Sin datos de contacto ni notas.crm.month_summary_getv1Lee 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. Una pieza que el rol de la persona no ve, o cuya lectura está apagada, vuelve enunavailable.crm.client_overview_getv1Lee cómo está UN cliente dicho por su nombre: sus facturas abiertas con su saldo y desde cuándo se deben, el total adeudado, y por qué canales se ha hablado con el día de su último mensaje. Nunca lo que se dijo, ni teléfono ni correo.
Kiipu · facturación
kiipu.collections_getv1Lee 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. No cambia nada ni escribe a nadie.kiipu.collected_month_getv1Lee 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. No dice quién debe: eso es kiipu.collections_get.kiipu.client_invoices_listv1Lista las últimas facturas y pagos de UN cliente dicho por su nombre: número, estado, total, saldo, y cuándo y cómo pagó. Con varios que coinciden se niega conambiguousy los candidatos; sin ninguno,not_found.kiipu.month_result_getv1Lee el estado de resultados del mes según el libro: ingresos, gastos, resultado, las cuentas que más pesan y el mes anterior. Si el libro no cuadra ahora mismo no da cifras; sin asientos lo dice, nunca cero.kiipu.client_balance_getv1Lee cuánto debe en total UN cliente dicho por su nombre, según el libro, y su próxima cuota. Un cliente al que nunca se le facturó vuelve comonever_invoiced, nunca como al día; un lead o un cliente perdido, comonot_a_client. Con varios que coinciden se niega conambiguous; sin ninguno,not_found.
Miira · leads y WhatsApp
miira.conversations_waiting_getv1Lee 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. Solo cifras: ni nombres ni mensajes.miira.funnel_getv1Lee 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. Los que ya compraron están en el CRM, no aquí.miira.catalog_searchv1Busca en el catálogo publicado por palabras y devuelve hasta 5 ofertas activas y públicas con nombre, resumen, precio, moneda y por qué se cobra; si solo coincide una, también su descripción completa y sus atributos. Lo interno, lo pausado y lo descontinuado nunca vuelven.miira.knowledge_searchv1Busca por palabras en la base de conocimiento que el equipo le cargó al agente de ventas (manuales, casos, respuestas a objeciones) y devuelve hasta 6 fragmentos con su documento y su sección. Solo documentos activos y ya indexados. No es la fuente de un precio: eso es miira.catalog_search.miira.agent_config_getv1Lee cómo está configurado hoy el agente de ventas: su persona, el guion en orden con lo que guarda y puntúa cada pregunta, las etapas del embudo, las respuestas de referencia, los documentos que se piden por tipo de cliente y los hitos. Conconfigured: falseel workspace sigue con la configuración de demostración. No cambia nada.