Saltar al contenido principal
El nodo WebView abre una interfaz web para que el usuario complete una acción (por ejemplo, un pago o un formulario). Si activas la opción de bloquear el flujo, este permanece pausado hasta que recibe una respuesta del callback o se cumple el tiempo de expiración.

Cómo funciona

1

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.
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.
La URL que recibe el usuario tiene este formato (el executionId se añade automáticamente):
https://tu-dominio.com?executionId=<valor>
Si tu URL ya lleva otros query params, se añade con &: https://tu-dominio.com?foo=1&executionId=<valor>.
2

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.).
3

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):
https://workflows.jelou.ai/v1/webview/callback
Cuerpo del request (JSON):
{
  "executionId": "exec_abc123xyz",
  "success": true,
  "data": {
    "paymentId": "pay_789",
    "status": "completed",
    "amount": 99.99
  }
}
CampoTipoObligatorioDescripción
executionIdstringValor que viene en la URL del WebView cuando se abre (query param). Identifica el flujo pausado.
successbooleantrue = ruta de éxito del WebView (SuccessCallback), false = ruta de error del WebView (ErrorCallback).
dataobjectNoObjeto 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.
El flujo solo se bloquea si activas la opción de “Bloquear flujo hasta respuesta”, ubicado en el tab avanzado del nodo.

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):
ResultadoCondiciónRama
Éxitosuccess: true en el callbackFlujo continúa por la salida de éxito
Errorsuccess: false en el callbackFlujo continúa por la salida de error
ExpiradoNo hubo respuesta antes de expirationTimeFlujo 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

CampoDescripción
URLDirección web que se abre al hacer clic. La configuras tú en el nodo.
Variable de entradaDatos que se pasan a la URL como query params.
Tiempo de expiraciónSegundos máximos de espera antes de tomar la salida Expired. Solo aplica si el bloqueo está activado.
Mensaje pendienteMensaje que recibe el usuario si escribe en el chat mientras el flujo espera.
Variable de respuestaVariable donde se guardan los datos enviados en data del callback.

Cerrar el WebView

Si quieres cerrar el WebView luego de una acción, un truco: redirige a un enlace de WhatsApp para regresar al chat:
window.location.href = "https://wa.me/13239183195";