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

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):
Si tu URL ya lleva otros query params, se añade con &: https://tu-dominio.com?foo=1&executionId=<valor>.
El usuario hace clic en el botón y completa la acción en la interfaz web (pago, formulario, etc.).
Cuando el usuario termina, tu página web debe enviar los datos del callback y el executionId a tu servidor, y tu servidor debe llamar al endpoint de callback para desbloquear el flujo.Endpoint (método POST, llamado desde tu servidor):
Encabezados del request (JSON, solo del lado del servidor):
Usa una API key con el permiso Ejecutar workflows de Brain Studio. Configúrala en Configuración → API Keys.
La API key del workflow debe permanecer en tu servidor. Nunca la incluyas en el código del navegador (JavaScript, HTML ni variables públicas).
Cuerpo del request (JSON):

​
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):
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

​
Cerrar el WebView

​
WhatsApp

Un truco para regresar al chat después de una acción es redirigir a un enlace de WhatsApp con el número de teléfono de tu canal. Reemplaza NUMERO_DE_TU_CANAL por ese número, con el código de país y sin el signo +:

​
Facebook e Instagram

Puedes llevar al usuario a la pantalla de cierre de Jelou. Muestra el Mensaje final, que configuras en el tab Avanzado del nodo WebView, y, si es posible, lo devuelve al chat. Cuando tu servidor confirme que el callback respondió con éxito (HTTP 2xx), redirige al usuario con el executionId:
Primero el callback y después la redirección. Si rediriges sin enviar el callback, el flujo queda esperando hasta que venza el tiempo de expiración y sale por la salida de expiración. Si rediriges antes de que el callback responda, corres ese mismo riesgo si el callback no llega a completarse.
Para que el usuario vuelva al chat se necesitan dos cosas. La primera es que el canal tenga definido el nombre de usuario de la cuenta en Meta; en Jelou lo puedes revisar en el campo Nombre de usuario, en la sección Perfil del canal. La segunda es que el dispositivo del usuario permita esa interacción, lo que pasa sobre todo en Android. Si falta alguna de las dos, el usuario igual ve el mensaje final, que le indica con claridad cuál es su siguiente paso para que la experiencia no se corte.