Cómo construir un Asistente Bancario y Financiero con Agentes de IA en ConvoFlow

El nuevo estándar de la banca conversacional

En la industria financiera, los clientes esperan cotizar un crédito, consultar los beneficios de una tarjeta o agendar una asesoría directamente desde WhatsApp o el chat web, sin menús numéricos interminables ("Presione 1 para...") y sin ser redirigidos a formularios externos que arruinan la conversión.

En esta guía paso a paso se muestra cómo construir ConvoFlow Bank, un flujo visual de nivel bancario creado en ConvoFlow, capaz de:

1. Enrutar inteligentemente al cliente según su preferencia (Asistente IA, Videollamada VIP o Cita en Sucursal).
2. Atender con un Agente Financiero Autónomo (deepseek-v4-pro) entrenado con el catálogo de productos del banco.
3. Calcular préstamos en vivo mediante un motor de amortización financiera programado en un nodo de código.
4. Registrar expedientes digitales en el CRM de forma 100% automatizada.

Vista general del canvas

Paso 1: Punto de entrada y enrutamiento inicial

Todo flujo inicia con un nodo trigger. Para usarlo desde el widget web se usa Start; si se quiere publicar en WhatsApp, se usa WhatsApp Trigger, que se conecta a los canales activos (WhatsApp Business Cloud API).

1. El nodo de pregunta

Para ofrecer una experiencia clara, se saluda al usuario y se le permite seleccionar su canal preferido de atención.

• Nombre de variable: opcion_continuar
• Pregunta: ¡Hola! 👋 Bienvenido a ConvoFlow Bank, tu banca digital inteligente. ¿Cómo prefieres continuar con tu consulta o solicitud de préstamo?
• Mapeo de opciones:
  • Continuar con el Asistente IA → valor: asistente_ai
  • Videollamada con Asesor VIP → valor: videollamada
  • Cita en sucursal → valor: cita_sucursal

Configuración del Switch y la Pregunta

2. El nodo de switch

El nodo switch evalúa la variable opcion_continuar y, según su valor, toma una de las siguientes rutas:

• Si es asistente_ai → Conecta al puerto de entrada del Agente Financiero IA.
• Si es videollamada → Conecta al Agente de Videollamada VIP.
• Si es cita_sucursal → Conecta al Agente de Citas en Sucursal.
• Salida Default: Si el usuario ingresa un texto no reconocido, se deriva a msg_invalid_option para solicitar amablemente una opción válida, sin romper la experiencia.

Paso 2: Configurando el Agente Financiero Autónomo

El corazón del autoservicio es el nodo Agente. Aquí se configura el modelo (ej. deepseek-v4-pro), el límite de pasos operativos (maxSteps: 20) y su System Prompt.

El System Prompt

El prompt se divide en tres bloques fundamentales:

1. Personalidad y tono: Empático, profesional, sin menús numerados rígidos.
2. Base de conocimiento embebida:
   • Cuenta Digital Cero: $0 de apertura y manejo, transferencias gratuitas 24/7, tarjeta de débito física y virtual.
   • Cuenta Rendimiento Pro: 8.5% TAE con liquidación diaria e intereses sobre saldo a la vista.
   • Tarjetas de crédito: Black (3% cashback en viajes + LoungeKey VIP) y Platinum (2% en supermercados y gasolina).
   • Préstamos Personales Express: Desde $1,000 a $25,000 USD, plazos de 6 a 60 meses, tasa desde 11.9% anual y desembolso en 15 minutos.
3. Reglas operativas:
   • Si el usuario pide cotizar o calcular un préstamo → Invoca de inmediato simular_credito.
   • Si el usuario quiere solicitar el producto → Pide nombre, teléfono, correo y documento de identidad, y llama a registrar_solicitud_cliente.

Puedes conectar tantas herramientas como necesites y usar los nodos disponibles para ampliar su funcionalidad. En este ejemplo solo se usan el nodo de código y el de colección, pero puedes usar cualquiera del catálogo.

Panel de configuración del Agente IA

Paso 3: Creando herramientas

En lugar de que la IA invente números (lo cual generaría alucinaciones inaceptables en finanzas), ConvoFlow te otorga herramientas deterministas.

Subflujo de la herramienta simular_credito:

El conector tools del nodo Agente se vincula a:

Herramientas en ConvoFlow

1. Start Tool Node (tool_simular_credito): Define los parámetros que el LLM debe extraer:

   • monto (number, requerido): Monto solicitado (ej. $10,000).
   • plazoMeses (number, requerido): Plazo en meses (ej. 24).
   • tipoCredito (string, requerido): 'personal', 'vehicular' o 'hipotecario'.

2. codeNode (code_simular_credito): Ejecuta la fórmula financiera de amortización francesa directamente en JavaScript:

let input = ctx.getVariable("credit_sim_input");
if (typeof input === 'string') {
  try { input = JSON.parse(input); } catch(e) {}
}

const monto = Number(input?.monto || 10000);
const plazo = Number(input?.plazoMeses || 24);
const tipo = String(input?.tipoCredito || 'personal').toLowerCase();

let tasaAnual = 0.119; // 11.9% Personal
let nombreTipo = "Préstamo Personal Express";
let seguroMensualTasa = 0.0005;

if (tipo.includes('vehi') || tipo.includes('auto')) {
  tasaAnual = 0.089;
  nombreTipo = "Crédito Automotriz ConvoFlow";
} else if (tipo.includes('hipo') || tipo.includes('vivienda')) {
  tasaAnual = 0.065;
  nombreTipo = "Crédito Hipotecario ConvoFlow";
}

// Cálculo de cuota mensual (Fórmula de amortización)
const tasaMensual = tasaAnual / 12;
const cuotaCapitalInteres = monto * (tasaMensual * Math.pow(1 + tasaMensual, plazo)) / (Math.pow(1 + tasaMensual, plazo) - 1);
const seguroMensual = monto * seguroMensualTasa;
const cuotaTotalMensual = Math.round((cuotaCapitalInteres + seguroMensual) * 100) / 100;
const totalPagar = Math.round((cuotaTotalMensual * plazo) * 100) / 100;
const totalIntereses = Math.round((totalPagar - monto) * 100) / 100;

return JSON.stringify({
  status: "success",
  tipoCredito: nombreTipo,
  montoSolicitado: monto,
  plazoMeses: plazo,
  tasaInteresAnual: `${(tasaAnual * 100).toFixed(1)}%`,
  cuotaMensualEstimada: cuotaTotalMensual,
  totalInteresesEstimados: totalIntereses,
  montoTotalFinal: totalPagar,
  beneficios: [
    "Sin penalización por abonos anticipados",
    "Desembolso digital en 15 minutos en tu Cuenta ConvoFlow"
  ]
});

3. Return Tool Result (tool_res_simular_credito): Devuelve el resultado formateado al contexto del agente para que responda al usuario con un mensaje claro, persuasivo y exacto.

Subflujo de la herramienta de código

Paso 4: Guardado de solicitudes en el CRM sin código

Cuando el cliente decide formalizar su solicitud de crédito o apertura de cuenta, el agente invoca la herramienta registrar_solicitud_cliente.

En lugar de requerir llamadas complejas a APIs externas con autenticaciones manuales, ConvoFlow incluye el nodo collectionWriteNode:

Subflujo de la herramienta de CRM

Mapeo de campos en el CRM:

• Colección de destino: col-convoflow-bank-leads-2026
• Mapeo declarativo:
  • full_name ➔ {bank_application_data.nombreCompleto}
  • phone ➔ {bank_application_data.telefono}
  • email ➔ {bank_application_data.email}
  • document_id ➔ {bank_application_data.documentoIdentidad}
  • product_interest ➔ {bank_application_data.productoInteres}
  • monthly_income ➔ {bank_application_data.ingresoMensualAprox}
  • channel ➔ "Asistente Virtual IA ConvoFlow"
  • status ➔ "PRE_APROBADO_EN_REVISION"

El nodo genera un ID de expediente (ej. #CFB-89421) y el agente finaliza la conversación enviando una confirmación profesional mediante el puerto completed hacia msg_confirm_completion.

Nodo Collection Write y CRM

Paso 5: Rutas híbridas — Videollamada VIP y citas presenciales

El verdadero poder de ConvoFlow radica en no forzar a todos los clientes al mismo embudo. En el mismo lienzo conviven dos agentes adicionales:

1. Rama Videollamada VIP (agent_videollamada)

• Diseñado para clientes de banca patrimonial o corporativa.
• Recaba fecha y hora preferida, además del tema de consulta.
• Invoca la herramienta agendar_videollamada_vip, que escribe en la colección col-convoflow-bank-videocalls-2026 y devuelve la URL de conexión segura (https://meet.convoflowbank.com/vip-session).

2. Rama Cita en Sucursal (agent_cita_sucursal)

• Ofrece las sucursales disponibles (Torre ConvoFlow Central, Zona 10, Plaza Real).
• Registra la cita en col-convoflow-bank-appointments-2026 y genera un pase de acceso prioritario con estacionamiento reservado (#VIP-4029).

Paso 6: Manejo de estados y resiliencia del flujo

Para garantizar estabilidad a nivel empresarial, cada Agente en ConvoFlow expone handles de salida para todos los posibles estados de ejecución:

Conclusión

Con ConvoFlow, cualquier equipo de producto o ingeniería puede orquestar flujos conversacionales potentes, seguros y conectados a sus bases de datos en cuestión de horas.