Orkasa

Las visitas en un rango de fechas, con el cliente y la propiedad de cada una. Responde "¿qué visitas tengo esta semana?" o "¿a quién veo mañana?". Por defecto mira hacia adelante: para las visitas ya pasadas — las que faltan por debriefear — pásale un `desde` anterior a hoy. Por defecto devuelve solo las del agente que conectó la cuenta; usa `alcance: "todos"` para las de toda la inmobiliaria, si su rol se lo permite.

agenda

Agenda una visita para un cliente, sobre una propiedad concreta. La fecha es ISO 8601 con zona horaria; una expresión como "mañana a las 3" no es un valor válido. Sin `operation_id` la visita queda desligada del expediente y el Copiloto la ignora, por lo que sigue pidiendo agendarla. Una visita con un propietario para captar su inmueble es de tipo `seller_pitch`; el valor por defecto, `buyer_visit`, es la visita de un comprador o inquilino.

agendar_visita

Busca clientes (leads) y propiedades por nombre, teléfono, correo, dirección o barrio. Es el punto de entrada: úsalo cuando el agente menciona a alguien o algo por su nombre y necesitas el id para seguir. Devuelve coincidencias de ambos lados, no el expediente completo — para eso está ver_expediente.

buscar

Filtra la cartera de la inmobiliaria: zona, tipo, venta o alquiler, precio, habitaciones, estado. Es lo que responde "¿qué tengo en Costa del Este por debajo de 300 mil?" o "¿qué apartamentos de 3 recámaras tengo en alquiler?".

buscar_propiedades

Da de alta un cliente (lead) con su contacto y, cuando se indica qué busca, abre su operación de compra o alquiler. Corresponde a un contacto que el agente acaba de tener: "acabo de hablar con Marta Ríos, busca un 3 recámaras en San Francisco hasta 250 mil". Los leads de captación (vendedores/propietarios) no se crean por esta vía.

crear_lead

Mueve una operación a la siguiente etapa de su pipeline, o la cierra. El vocabulario de etapas cambia según el flujo — una compra termina en «won», una captación en «sold»/«rented»/«expired»/«cancelled» — y una clave de otro flujo se rechaza; ver_expediente devuelve `siguiente_etapa` y `cierres_posibles` de cada operación. Avanza un solo paso por llamada, y solo si la etapa actual cumple sus requisitos, con los mismos candados que el botón "Avanzar" del Pipeline. Cuando falta algo no escribe nada y devuelve la lista exacta de pasos pendientes. Esos pasos se marcan en la aplicación Orkasa, no por esta vía: varios disparan efectos reales, como aceptar una oferta o pausar la publicación del inmueble.

avanzar_etapa

La lista de próximos pasos que el Copiloto de Orkasa recomienda, en orden: primero lo que depende del agente, y dentro de eso lo más atrasado. Cada línea dice el gesto, el motivo, la etapa y qué documento falta. Úsala para "¿qué tengo hoy?", "¿qué está atrasado?" o "¿por dónde empiezo?".

mi_jornada

Deja constancia de una oferta sobre una operación: monto, moneda, condiciones. Registrarla no la acepta ni mueve la etapa; eso es una decisión posterior del agente.

registrar_oferta

El expediente de un cliente: sus datos, sus operaciones con la etapa en la que están, las propiedades en juego (la del inmueble captado, o las candidatas de un comprador), las visitas, las ofertas, los documentos y los últimos mensajes — más el próximo paso que el Copiloto recomienda y, en cada operación, la `siguiente_etapa` a la que se puede mover. Es la herramienta para responder "¿cómo va lo de X?" o "¿qué falta para cerrar?". Acepta `lead_id`, o bien `operacion_id`, del que resuelve su cliente.

ver_expediente