Documentación

Herramientas

El conector tiene 29 herramientas: 12 de lectura y 17 de escritura. Cada herramienta aparece solo si la credencial tiene todos los permisos que pide; las de escritura necesitan además que la escritura esté activada en el servicio.

Cómo leer esta página

readOnlyHint vale true en las herramientas que nunca cambian datos.
destructiveHint vale true cuando una escritura puede sobrescribir o cambiar datos que ya existen. Ninguna herramienta borra registros.
idempotentHint vale true cuando repetir la misma llamada (con el mismo requestId, si lo lleva) no escribe dos veces.

Lectura

Ver el espacio y los permisos

leitvik_context

Lectura

Devuelve el nombre del espacio, el plan, la zona horaria y los permisos de la conexión. Úsala lo primero para confirmar que el asistente está en el espacio correcto.

Permisos: Cualquier permiso
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿A qué espacio de Leitvik estás conectado y qué puedes hacer en él?

Listar o buscar empresas

leitvik_companies_list

Lectura

Lista empresas por páginas; permite buscar por nombre o dominio.

Permisos: companies:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Busca la empresa con el dominio bruma.example.

Ver una empresa

leitvik_company_get

Lectura

Lee una empresa por su id. No incluye correos privados capturados ni credenciales de proveedores.

Permisos: companies:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Enséñame la ficha de Nubelar Labs.

Ver el pipeline

leitvik_leads_list

Lectura

Lee los leads con su estado y su siguiente paso; permite filtrar por estado y buscar por empresa o contacto.

Permisos: leads:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Qué leads tengo ahora mismo en propuesta?

Ver los contactos de una empresa

leitvik_contacts_list

Lectura

Lee los contactos de una empresa. Son datos personales.

Permisos: contacts:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿A quién conocemos en Bruma?

Ver las conversaciones registradas

leitvik_touches_list

Lectura

Lee las conversaciones registradas con una empresa. Un registro es historial, no prueba de que un mensaje llegara.

Permisos: touches:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Cuándo hablamos por última vez con Bruma y de qué?

Ver las señales de una empresa

leitvik_signals_list

Lectura

Lee las señales de compra con su fuente y la cita.

Permisos: signals:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Hay señales recientes de Nubelar Labs?

Ver los expedientes

leitvik_dossiers_list

Lectura

Lee los expedientes de investigación guardados de una empresa.

Permisos: dossiers:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Resúmeme el expediente que tenemos de Bruma.

Ver la agenda de hoy

leitvik_today

Lectura

Devuelve lo que vence hoy, de lo más urgente a lo menos: respuestas pendientes, siguientes pasos vencidos o para hoy, tareas abiertas, pasos de esta semana, rebotes y señales caducadas.

Permisos: leads:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Qué tengo que hacer hoy en Leitvik?

Ver tareas

leitvik_tasks_list

Lectura

Lista tareas por fecha de vencimiento, con filtros de estado, fecha, responsable y empresa. Cada tarea trae la versión que hace falta para cambiarla.

Permisos: tasks:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Qué tareas tengo vencidas?

Ver oportunidades

leitvik_opportunities_list

Lectura

Lista oportunidades, primero las últimas actualizadas, con filtro por empresa o fase. Los importes son exactos.

Permisos: opportunities:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

¿Qué oportunidades están en propuesta y por cuánto?

Resumen de la relación

leitvik_relationship_brief

Lectura

Resume una empresa a partir de lo guardado: siguiente paso, notas, última conversación y señales. Necesita lectura de empresas, leads, conversaciones y señales.

Permisos: companies:readleads:readtouches:readsignals:read
Anotaciones: readOnlyHint: truedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Prepárame la llamada con Bruma: ¿cómo está la relación?

Escritura: registros del CRM

Guardar una empresa y su lead

leitvik_company_upsert

Escritura

Crea o actualiza una empresa por su dominio, junto con su lead. Los campos que envíes pueden sustituir a los que ya había. No investiga ni contacta a nadie.

Permisos: companies:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Añade Taller Alba, taller-alba.example, como empresa de España.

Guardar un contacto

leitvik_contact_upsert

Escritura

Crea o actualiza un contacto de una empresa; si ya hay uno con el mismo correo, lo actualiza. No contacta con la persona.

Permisos: contacts:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Añade a Ana Rivas, CEO, ana@taller-alba.example, a Taller Alba.

Actualizar un lead

leitvik_lead_update

Escritura

Cambia solo los campos del lead que envíes: estado, siguiente paso y fecha, notas. Para dejar un lead en espera hace falta un motivo.

Permisos: leads:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Pasa Bruma a contactado, con el siguiente paso «Enviar la propuesta» para el viernes.

Registrar una conversación

leitvik_touch_record

Escritura

Registra una conversación que ya ha tenido lugar, con su fecha real. Nunca envía nada.

Permisos: touches:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Apunta que esta mañana le escribí a Ana, de Bruma, sobre los precios.

Guardar una señal

leitvik_signal_record

Escritura

Guarda una señal de compra con la URL de la fuente, la cita literal y las fechas.

Permisos: signals:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Guarda esta oferta de empleo como señal de Nubelar Labs.

Sustituir un expediente

leitvik_dossier_write

Escritura

Guarda el texto del expediente de una empresa y sustituye el anterior.

Permisos: dossiers:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Reescribe el expediente de Bruma con lo que hemos sacado de la llamada de hoy.

Escritura: tareas y oportunidades

Crear una tarea

leitvik_task_create

Escritura

Crea una tarea abierta para una empresa, con responsable, fecha y detalle si quieres. No envía nada a nadie.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Crea una tarea para Bruma: «Enviar la propuesta revisada», para el viernes.

Completar una tarea

leitvik_task_complete

Escritura

Marca como completada una tarea abierta, en su versión actual.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Marca como hecha la tarea de la propuesta de Bruma.

Aplazar una tarea

leitvik_task_snooze

Escritura

Retrasa la fecha de una tarea abierta, con un motivo que queda en el registro de auditoría.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Pasa la tarea de Bruma al martes que viene: nos han pedido más tiempo.

Descartar una tarea

leitvik_task_dismiss

Escritura

Cierra una tarea abierta sin completarla, con un motivo. Se puede reabrir.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Descarta el seguimiento de Nubelar Labs: se han ido con otro proveedor.

Reabrir una tarea

leitvik_task_reopen

Escritura

Vuelve a abrir una tarea completada o descartada.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Reabre la tarea de seguimiento de Nubelar Labs.

Editar una tarea

leitvik_task_edit

Escritura

Cambia solo el título, el detalle, el responsable o la fecha que envíes.

Permisos: tasks:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: false

Ejemplo de petición

Cambia el título de la tarea de Bruma a «Llamar a Ana por el presupuesto».

Crear una oportunidad

leitvik_opportunity_create

Escritura

Crea una oportunidad para una empresa con importe exacto y moneda. Empieza en la fase abierta si no indicas otra.

Permisos: opportunities:write
Anotaciones: readOnlyHint: falsedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Abre una oportunidad de 12.000 EUR para Bruma llamada «Iguala T1».

Actualizar una oportunidad

leitvik_opportunity_update

Escritura

Cambia fase, importe, nombre, responsable, fecha de cierre o notas en la versión actual. Los cambios de fase quedan en el historial.

Permisos: opportunities:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Pasa la iguala de Bruma a propuesta.

Escritura: capturas con revisión

Preparar una captura

leitvik_capture_preview

Escritura

Convierte las notas que pegas en una propuesta: la conversación y el nuevo siguiente paso. No cambia nada del CRM hasta que la apruebes.

Permisos: captures:write
Anotaciones: readOnlyHint: falsedestructiveHint: falseidempotentHint: true

Ejemplo de petición

Te paso las notas de la llamada con Bruma. Regístralas y deja como siguiente paso «Llamar el martes».

Aplicar una captura revisada

leitvik_capture_apply

Escritura

Aplica exactamente la propuesta que has revisado. Si el siguiente paso ha cambiado entretanto, no escribe nada.

Permisos: captures:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Sí, aplícala.

Deshacer el siguiente paso

leitvik_capture_undo

Escritura

Recupera el siguiente paso que sustituyó una propuesta aplicada. La conversación se queda en el historial.

Permisos: captures:write
Anotaciones: readOnlyHint: falsedestructiveHint: trueidempotentHint: true

Ejemplo de petición

Deshaz el siguiente paso que acabas de poner en Bruma.

Errores

Una llamada fallida devuelve isError con { "error": { "code", "message", "retryable" } }. El mensaje explica cómo seguir y nunca incluye detalles internos del servidor.

Código	Qué significa	Reintentar
`validation`	Los datos no encajan con el esquema de la herramienta.	No
`not_found`	Ese registro no está en este espacio, o la empresa se fusionó con otra.	No
`conflict`	El registro ha cambiado, el cambio de estado no está permitido o el `requestId` ya se usó con otro contenido.	No
`forbidden`	Este espacio o esta credencial no pueden hacerlo.	No
`unauthorized`	Falta la credencial, ha caducado, está revocada o no tiene el permiso.	No
`rate_limited`	Se ha alcanzado el límite por minuto; espera `retryAfterSeconds`.	Sí
`too_large`	La petición o la respuesta son demasiado grandes.	No
`timeout`	No hubo respuesta a tiempo; puede que la escritura ya se haya aplicado.	Sí
`unavailable`	No se ha podido contactar con Leitvik.	Sí
`result_too_large`	El resultado no se ha entregado; pide una página más pequeña.	No
`request_failed`	No se ha podido completar la operación.	No