Tema
WhatsApp Flows
Um WhatsApp Flow é um formulário que abre dentro do próprio WhatsApp, sem o contato sair da conversa. O Atende Direito tem um editor visual para criar esses formulários, publicá-los, enviá-los e transformar cada resposta em dados do contato e em um lead de campanha.
Fica em Conexões > Flows, ao lado de Templates.
Requisito
O Flow só funciona em conexão WhatsApp oficial (Cloud API). Conexões não oficiais não suportam Flows: o sistema recusa a criação e o envio.
Dica
Para conectar um número oficial, veja [Conectar WhatsApp](/guia/conectar/whatsapp).
Criar e editar
- Em **Conexões > Flows**, clique em **Criar Flow**.
- Informe o nome, a conexão WhatsApp oficial e a categoria (cadastro, agendamento, geração de leads, pesquisa, entre outras).
- Monte as telas e os componentes no editor.
- Salve. O rascunho é validado aqui e na Meta, e os erros aparecem na lista, na coluna **Erros**.
Telas
Um Flow é um conjunto de telas. Cada tela tem título, componentes e um botão de rodapé que avança para outra tela ou conclui o formulário.
- A tela final (terminal) tem o botão que envia as respostas. Todo Flow precisa de ao menos uma.
- Um Flow pode ter várias telas finais, e o rodapé de uma tela pode seguir caminhos diferentes conforme a resposta (por exemplo, "Empresa" vai para uma tela e "Empregado" para outra).
- Todas as telas precisam ser alcançáveis a partir da inicial, e o fluxo de telas não pode voltar para uma tela anterior.
- Limites: até 20 telas, 50 componentes por tela e 10 rotas de saída por tela.
Componentes disponíveis
| Grupo | Componentes |
|---|---|
| Texto | Título, Subtítulo, Parágrafo, Legenda, Texto rico (markdown) |
| Mídia | Imagem, Carrossel |
| Entrada | Campo de texto (texto, número, e-mail, telefone, senha, código numérico), Texto longo |
| Seleção | Lista suspensa, Escolha única, Múltipla escolha, Chips, Aceite |
| Data | Data, Calendário (data única ou período) |
| Arquivos | Fotos, Documentos |
| Lógica | Se / senão, Casos |
| Navegação | Link, Lista de navegação, Botão do rodapé |
Limites principais, mostrados em contadores no próprio editor:
| Regra | Limite |
|---|---|
| Rótulo de campo de texto | 20 caracteres |
| Título de opção | 30 caracteres |
| Opções de escolha única e múltipla | até 20 |
| Opções de lista suspensa | até 200 |
| Botão do rodapé | 35 caracteres |
| Imagens por tela | até 3 |
| Links por tela | até 2 |
| Aceites por tela | até 5 |
A paleta desabilita o componente que a regra da tela proíbe e explica o motivo ao passar o mouse. Duas regras valem destacar:
- Fotos e Documentos só ficam na tela final, e apenas um seletor por tela (não dá para misturar foto e documento).
- Lista de navegação precisa ficar sozinha na tela, sem outros componentes nem botão de rodapé, e não pode estar na tela final.
Condições
Use Se / senão e Casos para mostrar blocos conforme uma resposta. A condição é montada por seleção (campo, operador e valor, combináveis com E/OU), sem texto livre. Os mesmos recursos definem as rotas do rodapé: cada rota tem uma condição e uma tela de destino, e há sempre uma rota padrão.
Texto rico (RichText)
O componente Texto rico (markdown) precisa ficar sozinho na tela, apenas com o botão do rodapé. A paleta desabilita automaticamente o componente se detectar outros elementos na mesma tela, e o salvamento recusa o envio se essa regra for quebrada. Essa é uma exigência da Meta.
Preview e modo Interagir
O editor mostra um celular com a tela selecionada, em tema claro ou escuro. No modo Interagir você preenche os campos, navega pelas telas e vê as condições funcionando como no WhatsApp. É uma simulação do editor; para ver o formulário real, use Enviar teste.
Nome do campo e dados sensíveis
Cada campo de entrada tem um nome (minúsculas, números e _) usado nas condições e nas respostas. Campos de senha e código numérico nunca são gravados no contato.
Sincronizar flows da Meta
Você pode trazer para o Atende Direito os Flows que já existem em sua conta WhatsApp Business (rascunhos, publicados ou descontinuados) e trabalhar com eles aqui.
- Em **Conexões > Flows**, clique em **Sincronizar da Meta**.
- A lista mostra todas as suas **conexões WhatsApp oficiais** (números). Cada uma tem seu próprio botão **Sincronizar**. Clique no botão do número desejado. Sincronize uma de cada vez.
- O sistema traz todos os Flows daquele número, com o JSON que está na Meta. Ao fim mostra um **resumo**: quantos foram importados, quantos atualizados, e se houve falhas com o motivo.
- Rodar a sincronização novamente **não duplica** os Flows: ele atualiza os que já foram importados com os dados mais recentes da Meta.
- Flows criados nesta plataforma (editor local) têm seu status atualizado quando sincronizados (exemplo: um rascunho que foi publicado na Meta entra como publicado).
- Flows trazidos da Meta aparecem com o selo "Importado da Meta".
Flows importados
Um Flow importado é uma representação local do Flow que está na conta WhatsApp Business. Ele abre em modo somente leitura: não é possível editar seus componentes ou criar nova versão pelo editor local. Para fazer alterações, edite o Flow no Gerenciador de Flows da Meta e sincronize novamente.
Flows importados publicados ganham uma campanha automaticamente, assim que a sincronização termina, e começam a receber leads das respostas.
Você pode fazer com Flows importados:
- Publicá-los (se estavam como rascunho)
- Depreciá-los (bloquear abertura e envio)
- Excluí-los (remove do Atende Direito, não da Meta)
- Visualizar Preview na Meta (abre o gerenciador)
- Enviá-los no chat (dentro da janela de 24h) ou por template
- Receber respostas que viram leads e campos do contato
Importante: Respostas recebidas após a importação são gravadas como leads da campanha e como campos form-* do contato. Respostas anteriores à sincronização (histórico) não são recuperadas — a Meta não guarda esse histórico para buscar retroativamente.
Publicar
- Com o rascunho sem erros, clique em **Publicar** na lista.
- A Meta valida o Flow. Se houver erro, a publicação é recusada e o diálogo mostra o que corrigir.
- Publicado, o Flow fica pronto para uso e a **campanha** dele é criada automaticamente.
- Um Flow publicado é imutável: não dá para editar nem excluir. Para mudar, crie uma nova versão.
- A campanha nasce no momento da publicação, com 0 leads, e já aparece em Campanhas e no filtro do gatilho WhatsApp Flow Concluído.
- Só rascunhos podem ser excluídos.
Versões
Em um Flow publicado, use Nova versão. O sistema clona o Flow em um novo rascunho (v2, v3...), que você edita e publica.
- Cada Flow tem no máximo um rascunho por vez.
- Todas as versões pertencem à mesma campanha: os leads de qualquer versão somam nela.
- Detalhes e histórico mostra todas as versões, o preview navegável e o estado de cada uma.
Depreciar
Depreciar impede que a versão seja aberta ou enviada. É bloqueado quando algum template aprovado usa o Flow; o diálogo lista os templates. Enquanto esses templates existirem, a versão continua publicada.
Campanhas
Na página Campanhas, você encontra dois atalhos no topo:
- Criar WhatsApp Flow: abre o editor visual para criar um novo Flow.
- WhatsApp Flows: abre a lista completa de Flows (criar, editar, sincronizar, publicar, enviar).
Esses botões aparecem conforme suas permissões.
Enviar
Template com botão de Flow (fora da janela de 24h)
Para falar com um contato fora da janela de 24h, o WhatsApp exige um template. Crie um template de WhatsApp com um botão do tipo Flow e escolha o Flow publicado da mesma conexão. Veja a criação de templates em Conexões > Templates. Só Flows publicados da mesma conexão são aceitos.
Enviar formulário no chat (dentro da janela de 24h)
Em uma conversa de conexão oficial, use Enviar formulário no campo de mensagem, escolha o Flow, escreva o texto e, se quiser, cabeçalho, rodapé e o texto do botão (até 30 caracteres, sem emoji). Fora da janela de 24h, o envio é recusado e o sistema pede um template. Só versões publicadas podem ser enviadas, e o Flow precisa ser da mesma conexão da conversa.
Enviar um teste
Em um rascunho, use Enviar teste para abrir o formulário real no seu WhatsApp, em modo de rascunho, sem publicar. O contato de teste precisa estar com a janela de 24h aberta.
O que acontece com as respostas
Quando o contato conclui o formulário:
- O lead entra na campanha do Flow (a mesma para todas as versões).
- Cada resposta vira um campo personalizado do contato com o nome
form-{campo}. - O gatilho WhatsApp Flow Concluído dispara na primeira resposta do contato naquela campanha.
Como cada tipo de resposta é gravada:
| Componente | Campo personalizado |
|---|---|
| Campo de texto, Texto longo | Texto (o tipo Número vira campo numérico) |
| Lista suspensa, Escolha única | Texto com o título da opção, não o id |
| Múltipla escolha, Chips | Texto com os títulos separados por vírgula |
| Data | Data |
| Calendário (data única) | Data |
| Calendário (período) | Dois campos de data: form-{campo}-inicio e form-{campo}-fim |
| Aceite | Sim/Não |
| Fotos, Documentos | Texto com os nomes dos arquivos |
Fotos e documentos enviados no formulário são baixados em segundo plano e salvos nos documentos do contato.
Atenção
As respostas contêm dados pessoais e, muitas vezes, documentos sensíveis. Controle quem tem acesso à campanha e aos documentos do contato.
Permissões
O acesso é controlado pelo recurso whatsapp-flow:
| Permissão | Libera |
|---|---|
whatsapp-flow list | Ver a lista de Flows |
whatsapp-flow read | Abrir detalhes, histórico e preview |
whatsapp-flow create | Criar Flows e novas versões |
whatsapp-flow edit | Editar rascunhos |
whatsapp-flow delete | Excluir rascunhos |
whatsapp-flow publish | Publicar e depreciar |
whatsapp-flow send | Enviar teste e enviar formulário no chat |
Saiba mais
- Gatilho por WhatsApp Flow Concluído — continuar o atendimento quando o contato responde
- Conectar WhatsApp — a conexão oficial necessária
- Contas de Anúncios (Meta) — custo por lead das campanhas