Alaz

Borra una tarea. No se puede deshacer: si solo hay que darla por cerrada, usa update_task con status cancelled o complete_task. Solo cuando el usuario lo pida.

Devuelve el detalle de un registro por el identificador que dio search (formato tipo:id).

Un contrato completo: partes, cláusulas y anexos (clave, encabezado y cuerpo en markdown), condiciones económicas y firmas. Úsala antes de editar una cláusula: da las claves y dice si aún se puede editar.

Ficha de un cliente: razón social, nombre comercial, RUC, correo, teléfono y dirección.

Detalle de una oportunidad: etapa, embudo, cliente o lead, responsable, notas, sus cotizaciones resumidas, sus tareas abiertas y las interacciones más recientes.

Detalle de un proyecto con su resumen financiero y su semáforo. Si tu usuario no tiene permiso financiero, vuelve financial en null con financialsOmitted en true: eso significa "no puedes verlo", nunca "vale cero". Los entregables se piden con list_deliverables y las solicitudes con list_project_requests.

Detalle de una solicitud con la conversación con el cliente y la bitácora (cambios de estado, avisos enviados y avisos que fallaron).

Detalle de una cotización con sus ítems (producto, cantidad, precio, impuesto, total).

Texto de la propuesta de una cotización, sección por sección (clave, encabezado y cuerpo en markdown), más su precio y condiciones. Úsala antes de editar una sección: da las claves.

«Mi día comercial»: las oportunidades abiertas que piden atención, en cuatro bloques — próximo paso vencido, para hoy, sin próximo paso y estancadas en su etapa. Por defecto las del usuario conectado; ver las de otro vendedor exige ver toda la cartera.

Lista las empresas de Alaz a las que pertenece el usuario conectado.

Lista contratos de la empresa, los más recientes primero: estado, título, cliente y quién ha firmado. Filtra por cotización de origen, cliente o estado.

Las personas de contacto de UN cliente, con su rol, cargo y lo que pueden hacer en el portal. Los ids contact:<uuid> que devuelve son los que pide create_project_request. Primero identifica al cliente con list_customers o search.

Lista los clientes de la empresa (la cartera). Filtra por texto con query. Para las personas de contacto de un cliente usa después list_customer_contacts: no vienen en esta lista.

Entregables (los hitos de un proyecto): los de un proyecto concreto, o todos los de la empresa si no pasas proyecto. Filtra por estado y por responsable. Ojo: en la vista de toda la empresa la API no trae la descripción, así que sale siempre en null — eso NO significa que el entregable no tenga; para leerla, pide los de su proyecto.

Lista las oportunidades del embudo comercial con su etapa, cliente o lead, responsable, importe y fecha de cierre. Filtra por estado (open, won, lost), responsable ("me" = las mías) y texto.

Lista los embudos de venta de la empresa con sus etapas en orden. Da los ids de embudo y de etapa que piden create_opportunity y move_opportunity_stage.

Personas asignadas a un proyecto, con su rol dentro del proyecto.

Solicitudes que los clientes han enviado sobre sus proyectos (errores, mejoras, cambios y preguntas), lo último movido primero. Con awaitingTeam en true salen solo las que esperan respuesta del equipo.

Lista los proyectos de la empresa con su estado, cliente, responsable y avance. Filtra por estado y por texto.

Lista cotizaciones: las de una oportunidad si se indica, o las 20 más recientes de la empresa. Estado, total, moneda y vigencia.

Lista tareas del CRM (llamadas, correos, reuniones, WhatsApp y pendientes internos), lo más urgente primero. Por defecto solo las abiertas. Filtra por responsable ("me" = mis tareas), oportunidad, lead, cliente, estado y vencimiento.

Lista las personas del equipo de la empresa (nombre, correo y rol). Da los ids user:<uuid> para asignar oportunidades y tareas.

Registra un contacto con el cliente de una oportunidad (llamada, WhatsApp, correo o reunión), su resultado y el próximo paso obligatorio, que queda como tarea. Puede avanzarla de etapa a la vez. Solo cuando el usuario cuente que el contacto ocurrió.

Mueve una oportunidad a otra etapa de su embudo, con un próximo paso opcional. Úsala solo cuando el usuario lo pida. La etapa sale de list_pipelines.

Pide a la IA de Alaz que reescriba una cláusula o un anexo de un contrato, con una indicación opcional (p. ej. «añade penalidad por retraso del 1% semanal»). Un anexo previsto por la plantilla que aún no exista se crea. El texto anterior se pierde. Solo mientras nadie lo haya firmado. Tarda unos segundos.

Pide a la IA de Alaz que reescriba una sección de la propuesta de una cotización, con una indicación opcional (p. ej. «más corto», «menciona la integración con SAP»). El texto anterior se pierde. Tarda unos segundos.

Quita a una persona de un proyecto. No borra a la persona ni sus tareas. Solo cuando el usuario lo pida.

Reabre una oportunidad ganada o perdida, con un próximo paso opcional. Las tareas que se cancelaron al cerrarla no vuelven. Solo cuando el usuario lo pida.

Reabre una tarea completada o cancelada: vuelve a estar pendiente. Solo cuando el usuario lo pida.

Responde a una solicitud: el mensaje se publica en el hilo y SE LE ENVÍA AL CLIENTE por correo. Un correo enviado no se puede retirar, así que confirma con el usuario el texto exacto antes de llamarla. Puedes cerrar la solicitud en el mismo paso pasando status (descartarla explicando por qué es UNA sola operación).

Busca por texto en oportunidades, clientes, proyectos, leads (prospectos), facturas y tareas de la empresa. Devuelve identificadores que puedes pasar a fetch.

Reescribe a mano una cláusula o un anexo de un contrato (encabezado, cuerpo o ambos), o añade uno nuevo con create. El resto del contrato no cambia. Solo mientras nadie lo haya firmado.

Edita un entregable: estado, responsable, vencimiento, peso, nombre o descripción. Solo cuando el usuario lo pida.

Edita una oportunidad: reasignarla a otra persona del equipo, cambiar título, importe estimado, fecha de cierre esperada o notas. Para etapa usa move_opportunity_stage y para ganar/perder close_opportunity. Solo cuando el usuario lo pida.

Edita un proyecto: nombre, descripción, estado, prioridad, fechas, cliente o responsable de cuenta. Los importes no se editan por aquí. Solo cuando el usuario lo pida.

Cambia el rol de alguien dentro de un proyecto. La persona NO se cambia: para poner a otra, quita el miembro y añade uno nuevo.

Mueve una solicitud a received o in_review, o la vincula a un entregable, SIN escribirle al cliente. Planificarla, resolverla o descartarla (planned, resolved, declined) NO se hace aquí: esos tres estados le mandan un correo al cliente y van con reply_project_request, que publica la respuesta y cambia el estado en un solo paso (descartar exige esa respuesta). Solo cuando el usuario lo pida.

Edita una tarea: reasignarla, cambiar vencimiento, prioridad, título, descripción o estado (pending, in_progress, blocked, cancelled). Para completarla usa complete_task. Solo cuando el usuario lo pida.

Devuelve quién es el usuario conectado en Alaz, a qué empresa se consultará por defecto y la fecha de hoy (hora de Lima) para fechas de vencimiento.