> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/flows.md).

# Flows

Crie, visualize, teste e publique fluxos interativos executados dentro do WhatsApp.

O menu **Flows** permite criar e consultar jornadas interativas executadas dentro do WhatsApp. Elas podem ser usadas para cadastros, agendamentos, geração de leads, pesquisas, suporte e outros processos estruturados.

> **Importante:** alguns botões podem não aparecer para todos os usuários. A criação e a publicação dependem das permissões concedidas ao perfil.

### Como acessar

1. Entre no workspace desejado.
2. Acesse o Business Manager.
3. No menu lateral, clique em **Flows**.

### Entendendo a listagem

Cada Flow pode mostrar:

* nome;
* ID do Flow;
* status;
* categorias;
* miniatura ou prévia;
* data da última atualização;
* quantidade de erros de validação.

Use os controles do cabeçalho para:

* filtrar por status;
* pesquisar pelo nome;
* alternar entre cartões e lista;
* criar um novo Flow, se o perfil possuir permissão;
* alterar a página e a quantidade de resultados.

### Status do Flow

| Status        | Significado                                               |
| ------------- | --------------------------------------------------------- |
| **Rascunho**  | Ainda pode ser revisado e testado antes da publicação.    |
| **Publicado** | Está publicado na Meta e disponível para uso.             |
| **Obsoleto**  | Foi descontinuado e não deve ser usado em novas jornadas. |
| **Limitado**  | Existe uma limitação temporária informada pelo provedor.  |

> **Atenção:** um Flow publicado não pode ser editado na Meta. Mantenha **Publicar após criar** desativado enquanto estiver montando e testando o fluxo.

### Visualizar uma prévia

1. Localize o Flow.
2. Clique no cartão, na linha ou em **Ver Prévia**.
3. Navegue pelas telas disponíveis na simulação.
4. Use **Redefinir** para reiniciar o teste, quando a prévia for fornecida pela Meta.
5. Feche a prévia ao terminar.

A renderização pode variar conforme o dispositivo e a versão do WhatsApp. A prévia é uma referência visual e não substitui um teste completo no aplicativo.

### Criar um Flow

1. Clique em **Criar Flow**.
2. Na seção de informações básicas, informe o nome.
3. Selecione a WABA que será proprietária do Flow.
4. Escolha uma ou mais categorias.
5. Informe a **Endpoint URI** somente quando o Flow utilizar troca dinâmica de dados.
6. Deixe **Publicar após criar** desativado durante os testes.
7. Configure as telas e seus campos.
8. Revise a prévia e os erros de validação.
9. Clique em **Salvar Flow**.

#### Nome do Flow

Use um nome curto, descritivo e estável, por exemplo `captacao_leads_flow`. Evite nomes genéricos como `teste` em recursos que serão publicados.

#### Categorias disponíveis

A plataforma pode apresentar categorias como:

* Cadastro;
* Login;
* Agendamento;
* Geração de leads;
* Fale conosco;
* Suporte ao cliente;
* Pesquisa;
* Outro.

Escolha a categoria que melhor representa o objetivo principal do Flow.

#### Criar e organizar telas

Cada tela precisa de:

* um ID único, por exemplo `WELCOME`;
* um título visível ao usuário;
* os campos necessários para a etapa;
* um botão de rodapé que finalize ou avance o fluxo.

Use **Adicionar tela** quando a jornada precisar de mais de uma etapa. Ao configurar navegação, sempre selecione uma tela de destino válida.

#### Componentes disponíveis

O construtor pode oferecer título, subtítulo, texto, legenda, campo de texto, texto longo, lista suspensa, seleção única, caixas de seleção, data, opt-in e botão.

Para campos de entrada, configure nome técnico, rótulo, placeholder, tipo de dado e obrigatoriedade. Os nomes técnicos não devem se repetir na mesma tela.

#### Ação do botão

O botão pode:

* finalizar o Flow;
* navegar para a próxima tela;
* chamar um endpoint de troca de dados.

Se a ação navegar, selecione a próxima tela. Se utilizar troca de dados, valide a Endpoint URI e o payload esperado pelo sistema integrado.

### Erros de validação mais comuns

Antes de salvar, verifique se:

* uma WABA foi selecionada;
* o nome do Flow foi informado;
* existe pelo menos uma categoria;
* os IDs das telas são únicos;
* todas as telas possuem título;
* cada tela possui um botão de rodapé;
* componentes de texto não estão vazios;
* nomes de campos não estão duplicados;
* campos e opções possuem rótulos.

### Boas práticas

* Crie primeiro como rascunho.
* Teste todos os caminhos possíveis.
* Valide campos obrigatórios e mensagens de erro.
* Confirme o endpoint e o payload antes de usar troca de dados.
* Publique somente depois da homologação completa.