Cómo funciona Flowker
Empiezas por explorar qué integraciones hay disponibles, las conectas a tu entorno, defines un workflow que modela tu proceso de negocio y luego lo ejecutas. Cada ejecución deja un registro rastreable y disponible para inspección a través de la API.
1
Explora el catálogo
Recorre el catálogo para descubrir los proveedores, ejecutores y disparadores disponibles en tu despliegue de Flowker.
2
Conecta tus proveedores
Crea una configuración de proveedor para cada servicio externo que llamen tus workflows: motores de fraude, procesadores de pago, proveedores de KYC y servicios de notificación. Identifica la conexión que un nodo de workflow usa para ese servicio.
3
Define tus workflows
Modela tu proceso de negocio como un workflow: define los pasos (nodos), el orden en que corren (aristas) y las condiciones que controlan la ramificación.
4
Ejecuta y monitorea
Dispara workflows a través de la API, un webhook o un disparador de programación. Lee el estado de cada ejecución y recupera los resultados cuando termina.
Qué puedes automatizar
Flowker está diseñado para procesos financieros de varios pasos que requieren confiabilidad, trazabilidad e integración con servicios externos.
Orquestación de pagos
El desafío: un pago implica múltiples pasos: validación, enrutamiento al proveedor correcto, confirmación y notificación. Cuando se maneja manualmente o a través de integraciones dispersas, los fallos pasan desapercibidos y la conciliación se vuelve dolorosa. Cómo lo resuelve Flowker: define un workflow que coordina todo el ciclo de vida del pago:- Disparador: llega una nueva solicitud de pago vía API o webhook.
- Validar: verifica que los datos del pago estén completos y que la cuenta tenga saldo suficiente.
- Enrutar: selecciona el proveedor de pago apropiado según el monto, la moneda o el riel (Pix, TED, SWIFT).
- Confirmar: llama al proveedor y espera la confirmación.
- Notificar: envía un evento de confirmación al cliente y actualiza el ledger.
POST y PATCH corren una vez, a menos que actives los reintentos en el nodo. Flowker no deduplica el efecto secundario en el proveedor durante los reintentos: el Idempotency-Key de la ejecución deduplica ejecuciones de Flowker, no las solicitudes salientes al proveedor.
Activa los reintentos en un nodo POST o PATCH solo cuando la operación del proveedor sea idempotente. También puedes activarlos cuando el proveedor documenta una clave de negocio estable y la aplica de forma atómica. Envía esa clave en un header como clave de idempotencia en cada intento. De lo contrario, mantén los reintentos deshabilitados para el nodo. Flowker registra cada nodo ejecutor, condicional y de acción ejecutado para conciliación y revisión.
Validación antifraude
El desafío: las verificaciones de fraude deben ocurrir antes del procesamiento de la transacción. Implican servicios externos, lógica de puntuación y umbrales distintos según el tipo de transacción. Codificar esta lógica de forma rígida crea pesadillas de mantenimiento. Cómo lo resuelve Flowker: define un workflow previo a la transacción que corre las verificaciones de fraude antes de que algo llegue al ledger:- Disparador: llega una nueva transacción.
- Enriquecer: recopila el historial del cliente, los datos del dispositivo y la geolocalización desde los sistemas internos.
- Puntuar: llama a uno o más proveedores de detección de fraude y recopila las puntuaciones de riesgo.
- Decidir: aplica reglas: si la puntuación está por encima del umbral, bloquea. Si está en el límite, márcala para revisión. Si está libre, aprueba.
- Actuar: continúa con la transacción o notifica al equipo de cumplimiento.
Onboarding de clientes
El desafío: el onboarding de un nuevo cliente requiere verificación de identidad, validación de documentos, verificaciones de AML/KYC y creación de cuenta. Estos pasos implican múltiples proveedores externos y requisitos regulatorios que varían según la jurisdicción. Cómo lo resuelve Flowker: define un workflow de onboarding que automatiza todo el proceso:- Disparador: llega un nuevo registro de cliente.
- Verificar la identidad: llama a un proveedor de KYC para validar los documentos y la identidad del cliente.
- Verificar el cumplimiento: corre el screening de AML contra listas de sanciones y bases de datos PEP.
- Evaluar el riesgo: aplica reglas de riesgo internas según el perfil del cliente, la jurisdicción y el historial de transacciones.
- Crear la cuenta: si todas las verificaciones pasan, crea la cuenta del cliente en el sistema.
- Notificar: envía un correo de bienvenida o notifica al gerente de relación si se necesita revisión manual.
Workflows de aprobación manual
El desafío: algunas operaciones (transferencias de alto valor, cambios de límite de crédito, cierres de cuenta) requieren aprobación humana. Pero construir flujos de aprobación con notificaciones por correo, timeouts y rutas de escalamiento es complejo y propenso a errores. Cómo lo resuelve Flowker: define un workflow que llama a un servicio de aprobación externo a través de un nodo ejecutor:- Disparador: llega una solicitud de transferencia de alto valor.
- Evaluar: verifica el monto, el perfil de riesgo del cliente y las políticas internas.
- Solicitar la aprobación: llama a un servicio de aprobación externo (gerente, oficial de cumplimiento) a través de un nodo ejecutor.
- Decidir: un nodo condicional evalúa la respuesta de aprobación.
- Actuar: si se aprueba, continúa con la transferencia. Si se rechaza, cancela y notifica al solicitante.
Capacidades principales
- Validación previa al ledger: coloca cada verificación antes del nodo de contabilización en tu grafo y usa nodos condicionales con aristas
sourceHandlecoincidentes para enrutar a la contabilización solo los resultados aprobados. - Registros de ejecución por paso: los resultados de ejecución registran el estado, la duración, la salida y el error de cada nodo ejecutor, condicional o de acción ejecutado. Los nodos disparadores inician el recorrido del grafo y no crean registros de paso de ejecución.
- Integraciones de proveedores: conecta con motores de fraude, proveedores de KYC, procesadores de pago y cualquier servicio basado en HTTP.
- Ramificación condicional: un nodo condicional selecciona la arista saliente cuyo
sourceHandlecoincide con su resultado, para que puedas enrutar la ejecución según los resultados de paso, los montos, las puntuaciones de riesgo o cualquier campo de datos. - Ejecución idempotente: reutilizar un
Idempotency-Keydevuelve la ejecución existente de Flowker en lugar de crear otra. La ejecución directa requiere una clave no vacía. El header del webhook es opcional. - Monitoreo de ejecuciones: lee el estado de la ejecución a través de la API mientras un workflow corre. Recupera los resultados de la ejecución, incluidos los resultados de paso, después de que llega a un estado terminal.
Cuando la autenticación de Access Manager está habilitada (
PLUGIN_AUTH_ENABLED=true), las solicitudes a la API de Flowker deben llevar un token Bearer, y cada ruta aplica un permiso por recurso y por acción. Las credenciales específicas de cada proveedor (para servicios externos) se gestionan a través de configuraciones de proveedor. Consulta el Inicio rápido técnico para ver el flujo completo de arranque inicial.Qué sigue
Conceptos centrales
Entiende en detalle los workflows, los nodos, las aristas y el modelo de ejecución.
Inicio rápido técnico
Configura Flowker localmente y ejecuta tu primer workflow a través de la API.
¿Qué es Flowker?
Profundiza en la arquitectura, las funcionalidades y la filosofía de diseño de Flowker.
Referencia de API
Explora la API completa de workflows, ejecuciones y configuraciones.

