Pular para o conteúdo principal
O nodo WebView abre uma interface web para que o usuário conclua uma ação (por exemplo, um pagamento ou um formulário). Se você habilitar a opção de bloqueio de fluxo, o fluxo permanece pausado até receber uma resposta de callback ou o tempo de expiração ser atingido.

Como funciona

1

Configurar a URL

No nodo, insira a URL da sua interface web no campo correspondente. O fluxo envia esse link ao usuário como um botão ou link no chat.
O executionId é sempre adicionado como parâmetro na URL quando o WebView é aberto. Sua página deve lê-lo da URL e enviá-lo no callback.
A URL que o usuário recebe tem este formato (o executionId é adicionado automaticamente):
https://seu-dominio.com?executionId=<valor>
Se sua URL já tiver outros query params, ele é adicionado com &: https://seu-dominio.com?foo=1&executionId=<valor>.
2

O usuário abre o WebView

O usuário clica no botão e conclui a ação na interface web (pagamento, formulário, etc.).
3

Seu WebView envia o callback

Quando o usuário terminar, sua página web deve chamar o endpoint de callback para desbloquear o fluxo.Endpoint (método POST):
https://workflows.jelou.ai/v1/webview/callback
Corpo da requisição (JSON):
{
  "executionId": "exec_abc123xyz",
  "success": true,
  "data": {
    "paymentId": "pay_789",
    "status": "completed",
    "amount": 99.99
  }
}
CampoTipoObrigatórioDescrição
executionIdstringSimValor que vem na URL do WebView quando ele é aberto (query param). Identifica o fluxo pausado.
successbooleanSimtrue = caminho de sucesso do WebView (SuccessCallback), false = caminho de erro do WebView (ErrorCallback).
dataobjectNãoObjeto com informações coletadas no WebView para continuar o fluxo (ex.: opções selecionadas). Salvo na variável de resposta configurada no nodo.

Enquanto aguarda

Quando a opção de bloqueio de fluxo está habilitada, se o usuário escrever algo no chat enquanto o WebView está aberto:
  • Eles recebem a mensagem configurada em Mensagem de espera.
  • O fluxo não avança até que o WebView responda ou o tempo de expiração seja atingido.
O fluxo só é bloqueado se você habilitar a opção “Bloquear fluxo até resposta”, localizada na aba avançada do nodo.

Três saídas possíveis

Quando o bloqueio de fluxo está habilitado, cada resultado de callback se conecta a um ramo diferente por meio de sua própria aresta:
ResultadoCondiçãoRamo
Sucessosuccess: true no callbackO fluxo continua pela saída de sucesso
Errosuccess: false no callbackO fluxo continua pela saída de erro
ExpiradoSem resposta antes do expirationTimeO fluxo continua pela saída de expiração
Conecte todas as três arestas do nodo WebView aos nodos correspondentes: uma para sucesso, uma para erro e uma para quando o tempo expirar.

Configuração

CampoDescrição
URLEndereço web que abre ao clicar. Você configura isso no nodo.
Variável de entradaDados passados para a URL como query params.
Tempo de expiraçãoSegundos máximos para aguardar antes de tomar a saída Expirado. Aplica-se somente se o bloqueio estiver habilitado.
Mensagem pendenteMensagem que o usuário recebe se escrever no chat enquanto o fluxo está aguardando.
Variável de respostaVariável onde os dados enviados no campo data do callback são armazenados.

Fechar o WebView

Se você quiser fechar o WebView após uma ação, um truque: redirecione para um link do WhatsApp para retornar ao chat:
window.location.href = "https://wa.me/13239183195";