> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder de fluxos do WhatsApp

> Crie, importe, valide e visualize fluxos do WhatsApp por projeto no Console da Polymorfa.

Use **Fluxos** em um projeto para criar uma experiência do WhatsApp com várias telas. Os rascunhos de fluxo são recursos compartilhados do projeto, então projetos com a Cloud API e com dispositivos vinculados usam o mesmo editor e o mesmo identificador de fluxo.

A tabela **Fluxos** lista o nome, a quantidade de telas, a versão e a última
atualização de cada rascunho. Abra o cabeçalho de uma coluna para ordenar ou
filtrar por essa propriedade. Arraste a borda de um cabeçalho para
redimensionar a coluna. Clique com o botão direito em uma linha para abrir as
mesmas ações que aparecem em **Mais**.

## Criar um fluxo

1. Abra um projeto e selecione **Fluxos**.
2. Selecione **Criar fluxo**.
3. Renomeie o rascunho, adicione telas e adicione componentes a cada tela.
4. Selecione uma tela na estrutura lateral para editá-la ou ver os destinos dela.

O Console salva um rascunho novo assim que o editor abre. As edições seguintes são salvas depois de um curto intervalo. **Salvo** confirma que a revisão exibida chegou à Polymorfa. O status **Conflito** significa que outro editor salvou uma revisão mais nova; exporte o seu JSON antes de recarregar se precisar manter as alterações locais.

Os rascunhos aceitam documentos de fluxo incompletos. O indicador de estrutura aponta IDs de tela duplicados, destinos de rota ausentes, nomes de campo duplicados, telas finais que navegam e falhas de limite de recursos antes do upload.

## Usar a prévia do destinatário

A prévia renderiza a tela do fluxo selecionada dentro de uma conversa do WhatsApp. Você pode preencher campos, selecionar opções, seguir a navegação local entre telas e testar as ações de conclusão. As interações da prévia ficam no seu navegador e não enviam mensagens, não abrem links incorporados nem salvam os dados enviados no formulário.

> [!WARNING]
>
> A **Prévia local** é uma ajuda para a criação. A Meta valida o esquema
> completo do fluxo e oferece a própria prévia hospedada, com prazo de
> validade, depois que um fluxo é enviado para um número compatível da Cloud
> API. Use essa prévia hospedada como a verificação final de renderização
> antes da publicação.

A prévia local renderiza títulos, texto do corpo, legendas, campos de texto, áreas de texto, listas suspensas, grupos de botões de opção e de caixas de seleção, seletores de data, opt-ins, links incorporados, formulários e ações de rodapé. Um componente mais novo ou sem suporte aparece como um cartão de diagnóstico e permanece inalterado no JSON salvo.

## Editar ou mover o JSON do fluxo

Selecione **JSON** para editar o documento completo. Um JSON inválido permanece no editor e não é aplicado à prévia visual. A Polymorfa preserva campos e objetos de componente desconhecidos em vez de remover dados que não entende.

Use **Importar** para substituir o documento em edição por um arquivo `.json`. Use **Exportar** antes de uma edição grande, ao resolver um conflito de revisão ou ao mover um rascunho entre sistemas.

Os rascunhos de fluxo têm estes limites de criação:

| Limite | Valor |
| - | -: |
| Documento JSON | 2 MB |
| Telas | 50 |
| Componentes | 1.000 |
| Profundidade de aninhamento do JSON | 32 |

A versão do fluxo continua sendo uma string editável. A Polymorfa não reescreve um documento importado para uma suposta versão mais recente da Meta.

## Projetos com a Cloud API e com dispositivos vinculados

Criação, armazenamento de rascunhos, importação, exportação, validação e prévia local funcionam da mesma forma nos dois tipos de conexão.

Um número da Cloud API pode vincular o rascunho do projeto a um recurso de fluxo da Meta para a prévia hospedada e as operações de ciclo de vida. Conexões com dispositivos vinculados podem enviar um fluxo já publicado pela Messaging API, mas o protocolo de dispositivos vinculados não oferece upload nem publicação de recursos de fluxo da Meta. O Console identifica as ações de ciclo de vida indisponíveis em vez de tratar um rascunho local como publicado.

Para enviar um fluxo publicado, consulte [Send a message](/api-reference/messaging/messages/send-message?playground=open).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.