---
title: WhatsApp Flows
description: Crie formulários nativos do WhatsApp no editor visual, publique, envie por template ou pelo chat e receba as respostas no contato e na campanha.
---

# 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).
</Dica>

## Criar e editar

<Passos>
  <Passo>Em **Conexões > Flows**, clique em **Criar Flow**.</Passo>
  <Passo>Informe o nome, a conexão WhatsApp oficial e a categoria (cadastro, agendamento, geração de leads, pesquisa, entre outras).</Passo>
  <Passo>Monte as telas e os componentes no editor.</Passo>
  <Passo>Salve. O rascunho é validado aqui e na Meta, e os erros aparecem na lista, na coluna **Erros**.</Passo>
</Passos>

### 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](#enviar-um-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.

<Passos>
  <Passo>Em **Conexões > Flows**, clique em **Sincronizar da Meta**.</Passo>
  <Passo>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.</Passo>
  <Passo>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.</Passo>
  <Passo>Rodar a sincronização novamente **não duplica** os Flows: ele atualiza os que já foram importados com os dados mais recentes da Meta.</Passo>
</Passos>

- 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

<Passos>
  <Passo>Com o rascunho sem erros, clique em **Publicar** na lista.</Passo>
  <Passo>A Meta valida o Flow. Se houver erro, a publicação é recusada e o diálogo mostra o que corrigir.</Passo>
  <Passo>Publicado, o Flow fica pronto para uso e a **campanha** dele é criada automaticamente.</Passo>
</Passos>

- Um Flow publicado é **imutável**: não dá para editar nem excluir. Para mudar, crie uma [nova versão](#versoes).
- 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](/guia/flow-builder/gatilhos/whatsapp-flow-concluido).
- 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:

1. O **lead** entra na campanha do Flow (a mesma para todas as versões).
2. Cada resposta vira um **campo personalizado** do contato com o nome `form-{campo}`.
3. O gatilho [WhatsApp Flow Concluído](/guia/flow-builder/gatilhos/whatsapp-flow-concluido) 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**.

<Cuidado>
As respostas contêm dados pessoais e, muitas vezes, documentos sensíveis. Controle quem tem acesso à campanha e aos documentos do contato.
</Cuidado>

## 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](/guia/flow-builder/gatilhos/whatsapp-flow-concluido) — continuar o atendimento quando o contato responde
- [Conectar WhatsApp](/guia/conectar/whatsapp) — a conexão oficial necessária
- [Contas de Anúncios (Meta)](/guia/conectar/contas-de-anuncios) — custo por lead das campanhas