--- title: "Modelos WhatsApp Flows em JSON com pré-visualização" description: "Modelos WhatsApp Flows grátis em JSON e em seis idiomas: formulários, agendamentos, pesquisas e opt-in. Veja as telas, valide seu JSON e copie." canonical: "https://omnichannels.ai/pt/tools/whatsapp-flows-templates/" language: "pt" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Modelos WhatsApp Flows em JSON com pré-visualização Canonical: https://omnichannels.ai/pt/tools/whatsapp-flows-templates/ Language: pt Publisher: OmniChannels.ai by BroadNet Technologies Um WhatsApp Flow é um conjunto de telas dentro do chat definido em Flow JSON. O Flow válido mais simples tem uma versão, como 7.3, e um array screens. Cada tela tem um id formado por letras e sublinhados, um layout SingleColumnLayout com componentes e um botão Footer. As telas avançam com ações navigate, e a última é marcada como terminal e executa complete, que envia as respostas para o seu webhook. ## Como usar um modelo de WhatsApp Flow 1. **Escolha um modelo:** Selecione um caso de uso, como captação de leads, reserva de mesa ou chamado de suporte, e alterne entre os idiomas disponíveis. 2. **Veja as telas:** Toque no botão da pré-visualização para percorrer cada tela exatamente na ordem em que o cliente vai vê-la. 3. **Copie ou baixe o JSON:** Cole o Flow JSON no editor de Flows do WhatsApp Manager ou envie pela API de Flows e depois publique. 4. **Valide suas alterações:** Cole o JSON alterado no validador para encontrar rotas quebradas, campos ausentes e rótulos acima dos limites da Meta. ## O que tem num arquivo Flow JSON O Flow JSON tem duas propriedades obrigatórias: version e screens. Cada tela tem um id, um title opcional exibido na barra superior e um layout do tipo SingleColumnLayout cujos children são componentes: textos, campos, listas de opções, seletores de data, opt-ins e um único botão Footer. A navegação fica nas ações. Um Footer com navigate abre a próxima tela; na última, marcada como terminal, um Footer com complete fecha o Flow e envia o payload para a empresa junto com o flow token. A partir do Flow JSON 4.0, qualquer tela pode ler campos de uma tela anterior com ${screen.SCREEN_ID.form.field}; por isso os modelos deixam os payloads de navigate vazios e reúnem todas as respostas no payload final de complete. - version: a versão do Flow JSON, “7.3” em todos os modelos. - screens: a lista ordenada de telas; a primeira sem rota de entrada é a tela inicial. - routing_model e data_api_version: só para Flows que chamam o seu endpoint de dados. - terminal e success: marcam a última tela e se terminar nela conta como sucesso. ## Flows com ou sem endpoint de dados Os doze modelos funcionam sem endpoint. Não precisam de servidor: as opções estão no JSON, a Meta gera o modelo de roteamento e você recebe as respostas no webhook quando o cliente conclui o Flow. A Meta recomenda Flows sem endpoint sempre que não forem necessários dados em tempo real, porque abrem mais rápido e são mais rápidos de criar. Adicione um endpoint quando a tela depender de dados ao vivo: horários disponíveis, preços que mudam, estoque ou uma verificação na conta do cliente. Aí as telas usam data_exchange, o Flow precisa de data_api_version e de um routing_model, e o seu endpoint precisa descriptografar cada requisição e responder dentro do tempo limite da Meta. Essa é a parte que desenvolvemos e hospedamos para os clientes. ## Limites de caracteres e regras dos componentes A maioria dos Flows recusados falha em regras pequenas. Os rótulos são curtos: 20 caracteres para campo de texto, área de texto ou lista suspensa, 30 para grupos de opções e caixas de seleção, 40 para o seletor de data e 35 para o botão do Footer. Títulos de opção aceitam 30 caracteres e descrições 300. Um título de tela aceita 80 caracteres e o texto de corpo 4.096. Por tela, você pode usar até 50 componentes, um Footer, dois links incorporados, três imagens e cinco opt-ins. Os ids de tela só aceitam letras e sublinhados, e SUCCESS é reservado. Rótulos em árabe contam caracteres, não bytes. O validador verifica tudo isso e aponta a tela que precisa de correção. ## Flows em árabe, da direita para a esquerda, para clientes do Golfo Cada modelo tem uma versão nativa em árabe com as mesmas telas e os mesmos nomes de campo, então o código do seu webhook atende os dois idiomas sem mudanças. O WhatsApp exibe os Flows em árabe da direita para a esquerda no celular do cliente, e a pré-visualização faz o mesmo. A biblioteca traz casos de uso relevantes no Golfo: cadastro em ofertas do Ramadã e do Eid com envio após o iftar, reserva de mesa em restaurante, pedidos de visita a imóveis e um checklist de documentos KYC que pede ao cliente para não enviar fotos de documentos pelo chat. ## Como enviar um Flow aos clientes Depois de publicar o Flow, envie-o como mensagem interativa do tipo flow com o Flow ID, um flow token gerado por você, um texto curto de botão e a primeira tela. A biblioteca entrega o payload da mensagem para cada modelo. Mensagens interativas só funcionam dentro da janela de atendimento de 24 horas; para falar primeiro com o cliente, vincule o Flow a um modelo de mensagem aprovado com botão de Flow. Quando o cliente conclui, o WhatsApp mostra um resumo das respostas e você recebe o payload de complete no webhook. Responda com uma mensagem de confirmação que diga os próximos passos e como alterar ou cancelar. ## WhatsApp Flows em JSON: perguntas frequentes ### Qual versão do Flow JSON devo usar? Use a 7.3, a versão que a Meta recomendava para publicar Flows novos quando conferimos o changelog. Versões antigas como a 5.0 estão congeladas: Flows nelas ainda podem ser enviados, mas não publicados. ### Preciso de servidor ou endpoint de dados para estes modelos? Não. Todos os modelos funcionam sem endpoint. As opções estão no JSON e as respostas chegam ao seu webhook quando o cliente toca no último botão. Só é preciso endpoint para dados ao vivo, como horários livres ou preços. ### Como uso um modelo no WhatsApp Manager? Crie um Flow no WhatsApp Manager, abra o editor de JSON, substitua o conteúdo pelo modelo, confira a pré-visualização e publique. Você também pode criar e publicar o Flow pela API de Flows. ### Posso editar os rótulos e as opções? Sim. Altere qualquer texto, adicione ou remova opções e campos e cole o JSON no validador. Ele avisa quando um rótulo passa do limite de caracteres ou quando uma rota aponta para uma tela que não existe mais. ### Por que meu Flow não é publicado? As causas mais comuns são um rótulo acima do limite, um id de tela com números ou hífens, uma tela terminal sem Footer, a ação complete numa tela que não é terminal e data_exchange sem data_api_version e routing_model. ### Os modelos em árabe ficam da direita para a esquerda? Sim. Eles são escritos em árabe e o WhatsApp os exibe da direita para a esquerda. Os nomes de campo e os ids de opção continuam em inglês, então o mesmo código de webhook funciona para os dois idiomas. ### Um Flow pode coletar documentos de identidade? Os Flows têm componentes para escolher fotos e documentos, mas envios sensíveis exigem muito cuidado. O modelo KYC apenas verifica quais documentos o cliente tem e agenda uma entrega segura, sem imagens de documentos no chat. ### Este validador é o mesmo da Meta? Não. Ele faz verificações estáticas básicas baseadas nos erros documentados pela Meta. O validador da Meta no WhatsApp Manager também confere expressões e modelos de dados, então publique só quando ele não apontar erros.