Como funciona
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.A URL que o usuário recebe tem este formato (o Se sua URL já tiver outros query params, ele é adicionado com
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.executionId é adicionado automaticamente):&: https://seu-dominio.com?foo=1&executionId=<valor>.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.).
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):Corpo da requisição (JSON):
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
executionId | string | Sim | Valor que vem na URL do WebView quando ele é aberto (query param). Identifica o fluxo pausado. |
success | boolean | Sim | true = caminho de sucesso do WebView (SuccessCallback), false = caminho de erro do WebView (ErrorCallback). |
data | object | Não | Objeto 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.
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:| Resultado | Condição | Ramo |
|---|---|---|
| Sucesso | success: true no callback | O fluxo continua pela saída de sucesso |
| Erro | success: false no callback | O fluxo continua pela saída de erro |
| Expirado | Sem resposta antes do expirationTime | O 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
| Campo | Descrição |
|---|---|
| URL | Endereço web que abre ao clicar. Você configura isso no nodo. |
| Variável de entrada | Dados passados para a URL como query params. |
| Tempo de expiração | Segundos máximos para aguardar antes de tomar a saída Expirado. Aplica-se somente se o bloqueio estiver habilitado. |
| Mensagem pendente | Mensagem que o usuário recebe se escrever no chat enquanto o fluxo está aguardando. |
| Variável de resposta | Variável onde os dados enviados no campo data do callback são armazenados. |