WebView

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 servidor envia o callback

Quando o usuário terminar, sua página web deve enviar os dados do callback e o executionId ao seu servidor, e o seu servidor deve chamar o endpoint de callback para desbloquear o fluxo.Endpoint (método POST, chamado a partir do seu servidor):

https://workflows.jelou.ai/v1/webview/callback

Cabeçalhos da requisição (JSON, somente no servidor):

{
  "Content-Type": "application/json",
  "x-api-key": "SUA_API_KEY"
}

Use uma API key com a permissão Executar workflows do Brain Studio. Configure-a em Configurações → API Keys.

A API key do workflow deve permanecer no seu servidor. Nunca a inclua no código do navegador (JavaScript, HTML ou variáveis públicas).

Corpo da requisição (JSON):

{
  "executionId": "exec_abc123xyz",
  "success": true,
  "data": {
    "paymentId": "pay_789",
    "status": "completed",
    "amount": 99.99
  }
}

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.

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:

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.

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Caixa de entrada

Marketplace

Canais

Configuração

Faturamento

Como funciona

Enquanto aguarda

Três saídas possíveis

Configuração

Fechar o WebView

​Como funciona

​Enquanto aguarda

​Três saídas possíveis

​Configuração

​Fechar o WebView

Como funciona

Enquanto aguarda

Três saídas possíveis

Configuração

Fechar o WebView