Integrar el motor a tu arquitectura: API, webhooks y decisiones asincrónicas

Ejecución sincrónica: una llamada, una decisión

El caso base es REST puro: el sistema se autentica con credenciales propias, obtiene un token temporal y ejecuta la política con sus parámetros de entrada. La respuesta trae el resultado de la decisión, con niveles de detalle configurables según lo que el consumidor necesite; el esquema exacto de autenticación y endpoints vive en la documentación técnica.

Un dato de diseño que evita sorpresas: la latencia de una decisión suele estar dominada por las fuentes externas que la política consulta, más que por el motor. Una política bien orquestada — waterfall, consultas concurrentes, reconsulta — es también una API más rápida.

Webhooks: notificación cuando la decisión terminó

Para flujos donde nadie está esperando la respuesta en línea, el motor notifica por webhook cuando una transacción termina. La suscripción se configura con dos datos: la URL de destino y una clave de firma, que permite verificar la autenticidad de cada notificación antes de procesarla.

El contenido es configurable: se define qué variables de la ejecución viajan en la notificación, y el registro de entregas del webhook queda disponible para depurar integraciones.

Sync, async o batch: elegir por caso de uso

Los tres patrones pueden convivir en la misma instalación, con la misma política detrás:

• Sincrónico para originación en vivo: hay un usuario esperando la respuesta en pantalla.
• Asincrónico con webhook para procesos de fondo: onboarding por etapas, colas de trabajo, verificaciones que llegan después.
• Batch para masivos: campañas y re-scoring de cartera, con resultados exportados en archivo.
• En todos los casos: timeouts del cliente por encima del peor caso de la política, reintentos idempotentes y el ID de transacción como correlación.

Integración con gobierno incluido

Las mismas piezas de gobierno del resto del motor aplican a la integración: un usuario y una API key por sistema integrador — identidad, permisos y revocación por integración —, tokens de vida corta y permisos de ejecución separados de los de edición.

Y para el circuito de datos, el export de ejecuciones alimenta el data warehouse o la herramienta de BI: las decisiones del motor entran al mismo plano de análisis que el resto del negocio, con el ID de transacción como llave para reconstruir cualquier caso puntual.