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

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):
Se sua URL já tiver outros query params, ele é adicionado com &: https://seu-dominio.com?foo=1&executionId=<valor>.
O usuário clica no botão e conclui a ação na interface web (pagamento, formulário, etc.).
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):
Cabeçalhos da requisição (JSON, somente no servidor):
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):

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

Fechar o WebView

WhatsApp

Um truque para voltar ao chat depois de uma ação é redirecionar para um link do WhatsApp com o número de telefone do seu canal. Substitua NUMERO_DO_SEU_CANAL por esse número, com o código do país e sem o sinal +:

Facebook e Instagram

Você pode levar o usuário para a tela de encerramento da Jelou. Ela mostra a Mensagem final, que você configura na aba Avançado do nodo WebView, e, quando possível, leva o usuário de volta ao chat. Quando o seu servidor confirmar que o callback respondeu com sucesso (HTTP 2xx), redirecione o usuário com o executionId:
Primeiro o callback, depois o redirecionamento. Se você redirecionar sem enviar o callback, o fluxo fica aguardando até o tempo de expiração acabar e segue pela saída de expiração. Se redirecionar antes de o callback responder, você corre o mesmo risco caso o callback não seja concluído.
Para que o usuário volte ao chat, são necessárias duas coisas. A primeira é que o canal tenha definido o nome de usuário da conta na Meta; na Jelou você pode conferir isso no campo Nome de usuário, na seção Perfil do canal. A segunda é que o dispositivo do usuário permita essa interação, o que acontece principalmente no Android. Se faltar alguma das duas, o usuário ainda vê a mensagem final, que mostra com clareza qual é o próximo passo para que a experiência não seja interrompida.