Cotizaciones por API y MCP

Las acciones del Cotizador están en la API REST y en el servidor MCP. Un agente de IA o tu integración puede leer cotizaciones, armar un borrador para una unidad y prepararlo para enviar; el envío al cliente siempre pasa por una confirmación de la misma persona que lo pidió.

Las acciones

Las rutas REST van bajo https://api.watsi.ai/v1/actions/. Escribir necesita una clave o sesión de un miembro: una cotización pertenece a su asesor, así que sólo su asesor la edita y la envía. Los alcances de escritura no aparecen en la pantalla de claves; pídelos a watsi, o márcalos en la pantalla de consentimiento si te conectas por OAuth.

Arma un borrador

1. get_quoting_setup te dice qué esquemas de venta hay, con su descuento máximo y su precio mínimo por m², y qué falta configurar.
2. list_quotable_properties te da las unidades disponibles.
3. create_quote_draft con la unidad, y opcionalmente el contacto, el esquema y un descuento. watsi arma la línea, el calendario de pagos y los totales: tú pides por intención, nunca mandas cifras.

Si el descuento pasa el tope del esquema o el precio queda bajo su mínimo, la llamada responde 422 con cada regla rota en details.violations (COTIZADOR_DISCOUNT_OVER_CAP, COTIZADOR_PRICE_BELOW_FLOOR…) y no guarda nada.

Envía en dos pasos

Enviar llega al cliente, así que una persona lo confirma:

1. 1

   Prepara el envío

   send_quote con quoteId, el canal (whatsapp, email o link) y, si quieres, un mensaje. Responde la vista previa —folio, contacto, total, calendario de pagos, mensaje— y un confirmToken válido por 10 minutos. No cambia nada.

   {
     "preview": {
       "quoteId": "5b0c…",
       "folio": "COT-0012",
       "status": "draft",
       "channel": "whatsapp",
       "contactName": "Ana López",
       "currency": "MXN",
       "total": 2450000,
       "schedule": [{ "date": "2026-11-15", "concept": "Enganche", "amount": 245000 }],
       "message": "Hola Ana, aquí está tu cotización."
     },
     "confirmToken": "eyJ2Ijox…",
     "expiresAt": "2026-10-31T18:40:00.000Z"
   }

2. 2

   Muéstralo y pide confirmación

   Enséñale la vista previa a la persona. Un agente de IA nunca debe confirmar por su cuenta.

3. 3

   Confirma

   confirm_quote_send con el mismo quoteId y el confirmToken. Es el mismo envío que el botón Enviar del editor: revisa las reglas del esquema, congela la copia que recibe el cliente y, si la entrega falla, deja la cotización como estaba.

El token sólo sirve para lo que la persona vio:

El canal y el mensaje viajan dentro del token, así que la confirmación no los puede cambiar. Un token ya usado deja de servir, porque el envío cambia la cotización.

Relacionado

• Cotizador
• Servidor MCP
• Autenticación y alcances