Os Meta Flows (WhatsApp Flows) são formulários nativos da plataforma WhatsApp que permitem criar experiências interativas dentro do próprio app — sem abrir links externos. São ideais para coleta de dados, agendamentos e pesquisas.
Como funciona
Um Meta Flow é definido por um JSON estruturado (versão 7.3) que descreve telas e componentes. A CloudWhats fornece um editor visual para criar e gerenciar esses flows.
- O flow é enviado ao contato como parte de uma mensagem interativa
- O contato preenche o formulário dentro do WhatsApp
- As respostas são enviadas de volta e armazenadas no sistema
Componentes disponíveis
| Categoria | Componentes |
|---|---|
| Texto | TextHeading, TextSubheading, TextBody, TextCaption |
| Entrada | TextInput (6 tipos), TextArea, DatePicker, RadioButtonsGroup, CheckboxGroup, Dropdown, OptIn |
| Mídia | Image, PhotoPicker, DocumentPicker |
| Navegação | Footer (botão primário), NavigationList, EmbeddedLink |
| Lógica | If, Switch |
Ações
- navigate — navega para a próxima tela do flow
- complete — finaliza o flow e retorna os dados coletados
- data_exchange — envia dados para um webhook e recebe resposta
- open_url — abre uma URL no navegador
- update_data — atualiza dados de uma tela dinamicamente
Variáveis
Os Meta Flows usam uma sintaxe própria para referenciar dados:
${form.fieldName}— campo do formulário da tela atual${screen.SCREEN_ID.form.fieldName}— campo de outra tela${data.dataSourceName}— dados vindos do endpoint
${...}) é diferente das variáveis de automação ({{...}}). Não misture as duas.Tipos de endpoint
Nenhum
Flow estático, sem chamadas externas. Os dados são retornados apenas ao final.
Meta Provided
Endpoint gerenciado pela Meta. Dados processados automaticamente.
Custom
Seu próprio endpoint para data_exchange. A CloudWhats pode servir como proxy via Flow Endpoints.
Integração com templates
Meta Flows podem ser enviados vinculados a templates das categorias Marketing Flow ou Utility Flow. Isso permite iniciar o flow fora da janela de 24 horas.
Respostas do flow
As respostas de cada contato são armazenadas como FlowResponse, com os dados por tela. Você pode usar o gatilho FLOW_RESPONSEnas automações para processar as respostas automaticamente — por exemplo, atualizar o contato ou criar uma tarefa.