Crie Flows de WhatsApp para capturar informações estruturadas dos seus clientes
Quando você precisa pedir dados a um cliente —seu nome, seu e-mail, qual serviço ele procura—, fazer isso com mensagens de texto soltas funciona, mas é lento e abre espaço para erros de digitação ou respostas incompletas. Os Flows do WhatsApp resolvem isso: são formulários nativos que abrem dentro do mesmo chat, com campos, botões e telas que guiam o cliente passo a passo. Você pode pedir para PandAI montá-los para você ou criá-los manualmente.
Requisitos de compatibilidade
Os WhatsApp Flows não funcionam com qualquer conexão. Eles exigem um número conectado por meio da plataforma oficial do WhatsApp Business da Meta.
WhatsApp API oficial
Sim
WhatsApp Dual ou híbrido
Pode ser, se o número estiver respaldado pela conexão oficial da Meta e aparecer na Vambe como um número WhatsApp habilitado
WhatsApp QR / WhatsApp Web
Não
Instagram, Messenger, Web Chat ou TikTok
Não usam WhatsApp Flows
Criar o Flow não significa que ele será enviado automaticamente aos clientes. Depois de publicado, ele deve ser aberto por meio de uma mensagem interativa do assistente, um template de WhatsApp ou uma automação —mais abaixo, em Como conectar um WhatsApp Flow a um assistente.
Criação com PandAI: deixe que ele monte para você
Se você preferir não construir o Flow bloco por bloco, o PandAI oferece dois caminhos, disponíveis ao dar contexto sobre Assistentes:
Criar um WhatsApp Flow — você descreve quais informações precisa capturar e o PandAI monta o Flow completo automaticamente, aplicando o mesmo processo que você faria manualmente, mas sem que você precise mexer em cada tela por conta própria. Assim como na criação manual, esse Flow fica como uma peça solta: se você quiser dentro de um assistente, é preciso associá-lo manualmente em Mensagens Interativas.
Condensar uma rota em um WhatsApp Flow — o PandAI lê os cenários e rotas do seu assistente e recomenda quais rotas conversacionais vale transformar em um Flow, para reduzir a quantidade de mensagens que o assistente precisa enviar para coletar a mesma informação. Ao contrário da opção anterior, aqui você não precisa associar nada por conta própria: o PandAI conecta o Flow resultante diretamente à função de Mensagens Interativas do assistente.
Criação manual: passo a passo
Se você preferir montar o Flow você mesmo —ou quiser entender o que há por trás do que o PandAI gera—, a partir de Canais → WhatsApp Flows clique em + Criar para abrir o construtor, dividido em um painel de configuração à esquerda e uma visualização ao vivo dentro de um celular à direita. Ali você define três coisas antes de mexer no conteúdo do formulário:
Nome do fluxo — o nome interno com o qual você identificará este Flow (por exemplo, «Pesquisa de satisfação»).
Categorias — são adicionadas com Adicionar categoria.
Números de WhatsApp — são adicionadas com Adicionar número; defina em qual(is) número(s) este Flow ficará disponível.
Com isso pronto, monte o conteúdo do formulário em Telas. Cada tela ("Tela 1", "Tela 2"...) tem:
Título — o que o cliente vê como cabeçalho da tela.
ID da tela — um identificador interno em maiúsculas (por exemplo,
START,CONFIRM) que é usado para rotear entre telas.Tela final — um interruptor que marca essa tela como o encerramento do Flow. Ao ativá-lo, aparece um segundo interruptor, Tela de sucesso, para marcá-la especificamente como a confirmação final.
Dentro de Construção, cada tela é montada adicionando blocos com o botão Adicionar:
Cabeçalho de texto
Texto
Corpo de texto
Texto
Entrada de texto
Interruptor Obrigatório, Etiqueta (o que o cliente vê), Tipo de entrada (Texto, Email, telefone, número etc.), Texto de ajuda opcional. O nome do campo é gerado automaticamente a partir da etiqueta (por exemplo, "Full name" → full_name) — é o identificador com o qual o dado chega à Vambe
Lista suspensa
Interruptor Obrigatório, Etiqueta, pares Valor (não visível para o usuário) / Opção (visível para o usuário), que vão sendo somados com Adicionar item
Rodapé
Tipo de rodapé (por exemplo, Simples), Etiqueta do botão, e Tela de destino — para qual tela o cliente vai ao tocar nesse botão
Ao terminar uma tela, Adicionar tela (no rodapé do editor) adiciona a próxima. O botão Criar, no canto superior direito, publica o Flow.
Limites de estrutura
Telas por Flow
Máximo 8
Campos de entrada por tela
Máximo 5
Botões por tela
1 (o rodapé)
Opções em um campo de seleção
Entre 2 e 20
Para uploads de arquivos (foto ou documento), a Meta impõe também: máximo um campo de foto ou documento por tela, até 30 arquivos nos campos de upload, ≈ 25 MB por arquivo e um limite total de ≈ 100 MB por Flow.
Tipos de campo disponíveis: texto, texto longo, e-mail, telefone, número, seleção única, lista suspensa, seleção múltipla, data, aceitação de termos, fotos e documentos.
Boas práticas
Um Flow por objetivo. É melhor ter um Flow de agendamento, outro de orçamento e outro de devolução, do que um gigante para tudo.
Peça só o necessário. Cada campo adicional aumenta a chance de abandono; não pergunte algo que o assistente possa obter depois ou que já tenha disponível.
Separe por etapas. Por exemplo: tela 1 dados de contato, tela 2 necessidade ou serviço, tela 3 data ou detalhe adicional, tela 4 confirmação. Com seis ou mais campos, agrupe-os em telas de três a cinco.
Inclua uma tela final de confirmação, para que o cliente possa revisar o que está enviando antes de terminar.
Use nomes claros nas etiquetas ("Qual serviço você precisa?", não "Campo 1" ou "Dado adicional").
Mantenha as opções curtas — fáceis de selecionar em um celular. Se houver muitas alternativas, agrupe-as ou separe-as em outra tela.
Defina o que acontecerá depois: criar ou atualizar um ticket, mover de etapa, avisar um executivo, enviar um orçamento, ativar um workflow, agendar uma reunião.
Tenha sempre uma alternativa conversacional. Nem todos os clientes vão concluir o formulário; o assistente deve conseguir continuar manualmente se a pessoa disser «prefiro falar com alguém», não entender uma pergunta ou não conseguir abrir o Flow.
Publicação
Um Flow publicado não pode voltar ao estado de rascunho. Revise bem nomes, campos e navegação entre telas antes de criar o Flow definitivo, e teste-o com casos reais antes de usá-lo amplamente.
Se você for enviar o Flow por meio de um template de WhatsApp, esse template também deve cumprir as regras e aprovações da Meta.
Como conectar um WhatsApp Flow a um assistente
Um Flow criado e publicado não é enviado sozinho: é preciso indicar ao assistente quando ele deve ser aberto. Se você o gerou com a opção Condensar uma rota do PandAI, essa conexão já foi feita; se você o criou manualmente ou com Criar um WhatsApp Flow, siga estes passos.
1. Verifique se o assistente é V3
Os WhatsApp Flows só funcionam com assistentes V3. Assistentes V2 não têm a função de mensagens interativas.
2. Publique o Flow em um número de WhatsApp
O Flow deve estar disponível no mesmo número a partir do qual o assistente responde:
Vá para a seção de Flows.
Abra o Flow que você quer usar.
Revise ou complete suas telas e campos.
Publique-o no número de WhatsApp correspondente.
Salve as alterações.
Um Flow publicado somente em um canal web, Instagram ou outro canal não poderá ser enviado como WhatsApp Flow.
3. Abra o assistente V3
Vá para Assistentes.
Abra o assistente V3.
Entre na configuração ou nas automações dele.
Procure Enviar mensagem interativa.
4. Ative as mensagens interativas
Ative a função Enviar mensagem interativa. Essa função permite que o assistente envie botões, listas ou WhatsApp Flows.
5. Adicione o Flow ao assistente
Dentro da configuração de mensagens interativas:
Selecione Adicionar Flow.
Escolha o Flow correspondente.
Escreva uma descrição clara de quando ele deve ser usado —por exemplo, «Quando o cliente quer selecionar uma sessão de cinema e escolher um assento», e não apenas uma lista dos campos do formulário.
6. Salve a configuração
Se já havia outros Flows configurados, certifique-se de mantê-los: a lista de Flows substitui a configuração anterior inteira, não se acumula sozinha.
7. Indique ao assistente que use a função na rota correspondente
Conectar o Flow ao assistente não faz com que ele seja enviado automaticamente. A rota ou cenário em que esses dados são coletados deve indicar ao assistente que use a função de mensagens interativas, com uma referência de função em um formato semelhante a:
Não escreva manualmente o nome do Flow dentro da rota. O Flow que será usado é determinado pela descrição configurada nas mensagens interativas, e não pelo que você escrever na rota.
A rota também deve indicar o que fazer depois que o cliente completar o formulário, porque as respostas retornam como dados estruturados.
8. Verifique a conexão do assistente
Confirme que:
O assistente seja V3.
O assistente esteja atribuído a uma etapa ativa.
A etapa pertença a um funil conectado ao número de WhatsApp.
O Flow esteja publicado nesse mesmo número.
A rota inclua a referência de Enviar mensagem interativa.
A descrição do Flow explique claramente quando ele deve ser usado.
Erros comuns
O Flow existe, mas não é enviado: provavelmente não está publicado no número de WhatsApp.
O assistente não encontra o Flow: ele não foi adicionado à lista de mensagens interativas.
O Flow está conectado, mas o assistente continua perguntando campo por campo: falta a referência de função dentro da rota.
O Flow não funciona no Instagram ou no Web Chat: os WhatsApp Flows funcionam apenas para WhatsApp.
O assistente é V2: essa função está disponível apenas em assistentes V3.
Casos avançados
Alguns cenários —lógica condicional complexa entre telas, ou conectar o Flow a um sistema externo para buscar dados dinâmicos— podem exigir configuração adicional além deste editor. Se o seu caso precisar disso, converse com sua equipe de implementação da Vambe.
Em resumo
Um Flow é montado com telas, e cada tela com blocos —cabeçalho, corpo, campos de entrada e um rodapé que decide para onde o cliente vai. Você pode montá-lo sozinho no editor, pedir para o PandAI deixar pronto, ou pedir para o PandAI converter diretamente uma rota conversacional existente em um Flow e conectá-lo sozinho. Seja qual for o caminho, depois de publicado no número correto falta uma última etapa —a não ser que você use «Condensar uma rota»—: conectá-lo ao seu assistente V3 seguindo este guia para que ele saiba quando enviá-lo.
Atualizado
Isto foi útil?