Nuboo

Devuelve el detalle completo de un prospecto o lead asignado al asesor: datos de contacto, etapa del pipeline, temperatura, puntos de score y las últimas actividades/notas del timeline. Prospecto y lead son sinónimos en Nuboo. Requiere el ID del prospecto/lead (obtenible con list_my_prospects).

get_prospect_detail

Ficha completa de un desarrollo: ubicación, inventario, amenidades, etapas, precios y financiamientos. Necesita el nombre del proyecto.

get_project_detail

Devuelve el detalle completo de una venta: estado de venta, estado del contrato, liberación, precio, enganche, mensualidades, superficie del lote, asesor, cliente y notas. Se identifica por código de lote con búsqueda fuzzy (ej. «65» encuentra «NUB-01-065»); si el código existe en varios proyectos indica project_name para desambiguar. Solo lectura, no modifica datos. Para buscar ventas por período, asesor, cliente o contrato usa search_sales.

get_sale_detail

Devuelve el equipo completo de un usuario con el resumen de sus ventas. Recorre el árbol jerárquico hacia abajo (padre → hijos → nietos…) sin importar el perfil. Cada miembro incluye: depth (0=raíz, 1=hijos directos, 2=nietos…), parent_user_id, perfil y conteo de ventas por estado (pendiente, aprobada, liberada). No incluye ventas anuladas. Por defecto consulta al usuario autenticado como raíz. Úsala para responder preguntas sobre el rendimiento del equipo o la estructura jerárquica.

get_team_sales_summary

Genera una cotización para un lote disponible: resumen financiero y PDF descargable. Queda guardada en el historial del asesor. Solo funciona con unidades disponibles. IMPORTANTE — de cara al usuario, habla siempre en términos de negocio (mensualidades, enganche, promoción), nunca menciones nombres de campos, parámetros, tools ni detalles técnicos internos (ej. no digas "deferred_downpayment_months" ni narres que estás buscando o recargando un esquema). Si una llamada falla, tradúcelo a una pregunta natural para el usuario, no repitas el mensaje de error tal cual. ANTES de llamar este tool, llama `get_quote_context` con el proyecto y el código de lote: trae en una sola respuesta el detalle de la unidad (precio, enganche mínimo, superficie, estado), los plazos de financiamiento de la etapa y las promociones activas del proyecto. Si la unidad no está disponible, detente ahí. Si hay promociones vigentes, preséntaselas al usuario con nombre, descripción, reglas y beneficios, y pregunta si desea aplicar alguna. Si la promoción elegida trae `requires_deferred_downpayment_months: true`, es de enganche diferido: DEBES preguntar cuántas mensualidades quiere diferir el enganche (entre 1 y `max_deferred_downpayment_months`) y enviarlo en `deferred_downpayment_months`. Nunca asumas un valor por defecto ni cotices esa promoción sin este dato: si no lo indicas, el enganche se cobra de inmediato y la promoción no tiene ningún efecto. MINI-WIZARD — con el contexto ya obtenido, pregunta de a uno lo que falte, en este orden: a. Nombre del cliente (si no lo dio) b. Plazo en mensualidades — muestra las opciones de financiamiento y espera elección c. Enganche % — sugiere el mínimo, deja que cambie d. Precio de venta — solo si quiere negociar; si no, usa precio de lista e. Promoción — usa el nombre exacto de la promoción elegida (omite el campo si el usuario no quiere ninguna) Con toda la información confirmada, llama este tool para generar la cotización. No pidas toda la información de golpe. Un dato por mensaje. PROMOCIÓN entre varias cotizaciones seguidas del mismo cliente/lote — cada llamada a este tool es independiente y NO recuerda la promoción usada antes: si el usuario pide una nueva cotización sin repetir la promoción, sale SIN promoción (precio de lista, sin avisar). Antes de generar, si la conversación ya traía una promoción aplicada y este nuevo pedido no la menciona, confírmalo con el usuario en vez de asumir ("¿esta cotización lleva la misma promoción de antes o va sin promoción?"). `promotion_id` — cuando `list_active_promotions` o `get_quote_context` ya te devolvió el `id` de la promoción elegida en este mismo chat, reenvíalo aquí junto con `promotion_name` para evitar repetir la búsqueda por texto (más rápido y sin riesgo de ambigüedad si hay nombres parecidos). Es un detalle interno: nunca lo menciones, muestres ni preguntes al usuario, quien solo conoce el nombre de la promoción.

create_quote

Inventario de lotes o unidades disponibles en un proyecto: código, etapa, m², precio y estado. Sirve para comparar tamaños, precios o listar opciones cotizables.

list_available_lots

Enlace temporal (15 minutos) al mapa de disponibilidad de una etapa: muestra qué lotes están disponibles, reservados, vendidos o bloqueados. Necesita el nombre del proyecto y el nombre de la etapa.

get_availability_map

Recursos Masterlink visibles del asesor, agrupados por proyecto, con enlace de descarga o vista previa cuando aplique. Úsala para cualquier pedido de brochure, folleto, planos, masterplan, KMZ, PDF, ficha técnica, preguntas frecuentes o material comercial/publicitario de un proyecto.

list_masterlink_documents

Eventos y recordatorios propios del usuario en el calendario de Nuboo. Por defecto muestra los próximos 90 días desde hoy. Admite filtros: rango de fechas (date_from / date_to en YYYY-MM-DD), tipo de evento (webinar, visita, capacitacion, reunion, otro) y búsqueda por título (q). Útil para: ¿qué tengo hoy?, ¿qué hay esta semana?, ¿cuándo es mi reunión de ventas?

list_my_events

Lista los prospectos (también llamados leads) asignados al asesor autenticado. Prospecto y lead son sinónimos en Nuboo. Solo muestra prospectos ya asignados al usuario, no la bandeja de entrada sin asignar. Admite filtros: etapa del pipeline (pipeline), temperatura (temperature) y búsqueda por nombre/email/teléfono (q). Útil para: ¿cuáles son mis prospectos?, ¿cuáles son mis leads?, ¿quién está en etapa interesado?, ¿mis leads calientes?

list_my_prospects

Mueve un prospecto o lead asignado al asesor a una nueva etapa del pipeline de ventas. Prospecto y lead son sinónimos en Nuboo. Etapas disponibles: new (Nuevo), contact_attempt (Intento de contacto), contacted (Contactado), interested (Interesado), converted (Convertido), lost (Perdido). Solo aplica a prospectos/leads asignados al usuario. Registra el cambio en el timeline.

move_prospect_pipeline

Opciones de financiamiento de los proyectos del asesor: plazos disponibles (mensualidades) y enganche mínimo por etapa. Puede filtrar por proyecto y etapa.

list_financing_options

Opciones reales para cotizar proyectos de inversión (agro-lotes y similares): cantidad mínima, múltiplos, máximo por operación, disponibilidad, precio por unidad, enganche permitido, plazos y descuentos por volumen. Úsala antes de create_investment_quote para pedir al cliente solo datos válidos.

get_investment_options

Perfil del asesor: nombre, agencia, líder, cotizaciones del mes, historial mensual y ventas. Para un mes concreto indica año y mes en la consulta. Si el asesor pertenece a Grupo Pulser, incluye `advisor_site` con el estado de su minisite público: `published` + `url` si está publicado, o `published: false` + `reason` (asesor inactivo, sin slug configurado, o publicación desactivada) si no lo está. Si el usuario pregunta por su sitio y `published` es `false`, dile el motivo en términos claros en vez de solo decir que no tiene sitio.

get_user_profile

Promociones vigentes en los proyectos del asesor: nombre, descripción, reglas de aplicación, vigencia y beneficios (descuento, enganche, financiamiento, apartado, mensualidad fija, etc.). Llama este tool durante el flujo de cotización (create_quote o create_investment_quote) para mostrarle al usuario las promociones disponibles antes de generar la cotización. Puede filtrar por proyecto o nombre de promoción. Cada promoción trae un `id` interno (junto con `name`). Si el usuario elige una promoción de esta lista, puedes reenviar ese `id` en `create_quote` (`promotion_id`, además de `promotion_name`) para cotizaciones subsecuentes del mismo chat sin repetir la búsqueda por texto. Es un detalle de uso interno entre tools: nunca lo muestres ni lo menciones al usuario, que solo conoce el nombre de la promoción.

list_active_promotions

Proyectos activos del asesor y cuántas unidades disponibles tiene cada uno para cotizar.

list_my_projects

Resumen de ventas del usuario con totales por cantidad y monto. Permite agrupar por proyecto, asesor, agencia, mes o estado. Si no se indica período devuelve el mes actual. Respeta el scope del usuario: un asesor ve sus propias ventas, un director ve las de su equipo. Para ver el listado individual de ventas usa search_sales; para el detalle de una venta específica usa get_sale_detail.

get_sales_summary

Consultas usadas y restantes del mes, ritmo por minuto y reglas de cotización en Nuboo.

get_usage

Vincula una cotización existente a un prospecto o lead asignado al asesor. Prospecto y lead son sinónimos en Nuboo. La cotización queda registrada en el timeline del prospecto/lead para trazabilidad. Usar después de create_quote o create_investment_quote cuando el asesor quiere asociar la cotización a un prospecto o lead específico. Requiere el ID del prospecto/lead y el ID de la cotización.

link_quote_to_prospect