Cómo funciona
Configura la URL
En el nodo, ingresa la URL de tu interfaz web en el campo correspondiente. El flujo envía ese enlace al usuario como botón o enlace en el chat.La URL que recibe el usuario tiene este formato (el Si tu URL ya lleva otros query params, se añade con
Siempre se añade el
executionId como parámetro en la URL cuando se abre el WebView. Tu página debe leerlo de la URL y enviarlo en el callback.executionId se añade automáticamente):&: https://tu-dominio.com?foo=1&executionId=<valor>.El usuario abre el WebView
El usuario hace clic en el botón y completa la acción en la interfaz web (pago, formulario, etc.).
Tu WebView envía el callback
Cuando el usuario termina, tu página web debe llamar al endpoint de callback para desbloquear el flujo.Endpoint (método POST):Cuerpo del request (JSON):
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
executionId | string | Sí | Valor que viene en la URL del WebView cuando se abre (query param). Identifica el flujo pausado. |
success | boolean | Sí | true = ruta de éxito del WebView (SuccessCallback), false = ruta de error del WebView (ErrorCallback). |
data | object | No | Objeto con la información recogida en el WebView para continuar el flujo (ej. opciones seleccionadas). Se guarda en la variable de respuesta configurada en el nodo. |
Mientras espera
Cuando la opción de bloquear el flujo está activada, si el usuario escribe algo en el chat mientras el WebView está abierto:- Recibe el mensaje configurado en Mensaje de espera.
- El flujo no avanza hasta que el WebView responda o se cumpla el tiempo de expiración.
Tres salidas posibles
Cuando el bloqueo del flujo está activado, cada resultado del callback se conecta a una rama distinta a través de su propia arista (edge):| Resultado | Condición | Rama |
|---|---|---|
| Éxito | success: true en el callback | Flujo continúa por la salida de éxito |
| Error | success: false en el callback | Flujo continúa por la salida de error |
| Expirado | No hubo respuesta antes de expirationTime | Flujo continúa por la salida de expiración |
Conecta las tres aristas del nodo WebView a los nodos que correspondan: uno para éxito, uno para error y uno para cuando expire el tiempo.
Configuración
| Campo | Descripción |
|---|---|
| URL | Dirección web que se abre al hacer clic. La configuras tú en el nodo. |
| Variable de entrada | Datos que se pasan a la URL como query params. |
| Tiempo de expiración | Segundos máximos de espera antes de tomar la salida Expired. Solo aplica si el bloqueo está activado. |
| Mensaje pendiente | Mensaje que recibe el usuario si escribe en el chat mientras el flujo espera. |
| Variable de respuesta | Variable donde se guardan los datos enviados en data del callback. |