Inicia una nueva solicitud de préstamo en Banco D. Muestra un widget interactivo (una pequeña app dentro del chat) donde el usuario captura él mismo el día de pago, el plan de cuotas, el PIN y la cuenta de destino paso por paso.

REGLA IMPORTANTE: llama esta tool INMEDIATAMENTE cuando el usuario expresa interés en un préstamo. NO le preguntes al usuario por día de pago, cuotas, plan, cuenta destino, PIN, ni ningún otro dato antes de llamar la tool. El widget se encarga de capturarlos.

El ÚNICO dato que puedes inferir del contexto conversacional es el monto_sugerido (si el usuario mencionó una cifra concreta, ej. 'una laptop de 3500', 'un electrodoméstico de 1200'). Ese monto pre-llena el formulario para que el usuario no lo escriba. Si no hay cifra clara, no pases el parámetro.

Registra el monto (en soles) y el día del mes para el pago (1 a 28) de una solicitud de préstamo que ya se inició con iniciar_solicitud_prestamo. Con esos dos datos, el servidor calcula tres planes de pago (12, 24 y 36 cuotas, cada uno con su cuota mensual, intereses totales y TCEA) y el widget avanza al paso donde el usuario elige uno de esos planes.

Normalmente la llama el widget cuando el usuario envía el formulario del primer paso. Tú también puedes llamarla si el usuario te da los dos valores directamente en el chat (por ejemplo, 'quiero 3500 soles y que me cobren el día 15').

Te devuelve un mensaje con los tres planes ya calculados, para que puedas comentarlos si el usuario te pregunta antes de elegir.

Selecciona uno de los tres planes de pago disponibles (12, 24 o 36 cuotas) para una solicitud en la que ya se capturó monto y día. El widget avanza al paso de confirmación de términos.

Normalmente la llama el widget cuando el usuario hace clic en la tarjeta de un plan. Tú también puedes llamarla si el usuario te dice cuál elige en el chat (por ejemplo, 'prefiero el de 24 cuotas').

Te devuelve un mensaje con la cuota mensual, el pago total y los intereses del plan elegido.

Registra la aceptación de términos y condiciones del préstamo. Después de esta tool, el widget muestra al usuario un keypad donde ingresa su PIN para autorizar el desembolso.

Normalmente la llama el widget cuando el usuario acepta los términos con el botón de la interfaz. Tú también puedes llamarla si el usuario acepta explícitamente en el chat (por ejemplo, 'sí, acepto los términos y condiciones').

La autorización con el PIN la hace después el propio widget con una tool interna que tú no ves. El PIN del usuario no aparece en el chat ni en ninguna respuesta que tú recibas.

Tool interna del widget: recibe el PIN que el usuario tecleó en el keypad y devuelve el resultado de la autorización. NO debe ser invocada por el agente.

Tool interna del widget: recibe la cuenta destino del desembolso y la forma de pago (automatico/manual) elegidas por el usuario post-autorización. Genera el número de operación y confirma el desembolso. NO debe ser invocada por el agente.

Devuelve un resumen en texto del estado actual de la solicitud de préstamo del usuario: en qué paso va, qué datos se capturaron hasta el momento, si ya autorizó o no. No modifica nada ni afecta al widget.

Llámala cuando el usuario te pregunte por el estado de su solicitud (por ejemplo, 'en qué paso voy', 'qué me falta', 'cuánto era el monto que puse').

Tool interna del widget: devuelve el estado actual del préstamo en structuredContent. NO debe ser invocada por el agente.

Descarta la solicitud actual y devuelve al usuario al primer paso del flujo (captura de monto y día de pago). Se pierden todos los datos capturados hasta el momento. El widget se vuelve a mostrar en el primer paso con los campos vacíos.

Llámala cuando el usuario te pida empezar de nuevo (por ejemplo, 'reinicia', 'cancela y empieza de cero', 'quiero cambiar el monto desde el principio').