> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Flows

> Insere formulários interativos diretamente dentro da conversa do WhatsApp

O nodo **WhatsApp Flows** permite inserir formulários interativos e visuais diretamente dentro de uma conversa do WhatsApp. Ao contrário de nodos de pergunta individuais, os WhatsApp Flows são telas completas com campos de texto, menus suspensos, botões e outros elementos visuais que o usuário preenche em uma única visualização.

## Quando usar

Use este nodo quando precisar coletar múltiplas informações do usuário de forma organizada em uma única tela, em vez de fazer várias perguntas individuais. É especialmente útil para:

* Formulários de cadastro
* Pesquisas de satisfação
* Coleta de dados de envio
* Qualquer cenário onde você precise de múltiplos campos de uma vez

## Requisitos

<Warning>
  Este nodo só aparece se sua conta Meta Business estiver verificada. Os Flows devem ser criados previamente no Flow Builder no WhatsApp Manager.
</Warning>

* Conta Meta Business aprovada e verificada
* Flows criados no WhatsApp Manager
* Nem todos os dispositivos ou versões do WhatsApp suportam este recurso — teste antes de lançar em produção

## Configuração

* **Seleção de flow**: Escolha um Flow publicado ou em rascunho da sua conta WhatsApp Business
* **Texto do botão**: O texto no botão que o usuário toca para abrir o formulário
* **Ação do fluxo**: Define como o Flow se comporta ao abrir:
  * **Navegar (Navigate)**: o Flow abre em uma tela estática predefinida (comportamento padrão).
  * **Troca de dados (Data exchange)**: ao abrir, o WhatsApp consulta o endpoint do negócio, que resolve dinamicamente a tela inicial e seus dados.
* **Dados dinâmicos** (opcional): Passe dados do fluxo para o formulário usando variáveis (por exemplo, `{{$memory.userId}}`)

<Warning>
  Para usar **Troca de dados (Data exchange)** você deve primeiro:

  * Ter inserido a **public key** e a **private key** de criptografia do Flow.
  * Ter o Flow publicado na Meta com seu endpoint configurado (`data_api_version`).

  Se você selecionar **Troca de dados (Data exchange)** em um Flow que não atende a esses requisitos, a Meta rejeitará o envio.
</Warning>

No painel de configuração, você pode acessar diretamente seu gerenciador de WhatsApp Flows para criar ou editar formulários.

[Ver documentação da Meta sobre componentes de Flow](https://developers.facebook.com/docs/whatsapp/flows/reference/components/)