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

# Como criar um formulário do WhatsApp

> Monte um formulário com telas e campos que o cliente preenche sem sair da conversa, publique no WhatsApp e acompanhe as respostas

![Estúdio de Flows com as telas do formulário Agendamento de visita e a prévia ao lado](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/capa.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=7c93918bbbd7c52323a6415864a16e93)

O formulário do WhatsApp abre por cima da conversa, com telas, campos e botões, e o cliente responde sem sair do aplicativo. Serve para agendar uma visita, fazer uma pesquisa de satisfação ou cadastrar um revendedor sem ficar trocando dezenas de mensagens. A Meta chama esse recurso de WhatsApp Flows, e na WizeBot ele fica na aba **Flows**.

Antes de começar, você precisa ter um [número de WhatsApp conectado](https://help.wizebot.com.br/tutoriais/configuracao/conectar-whatsapp.md) e ser dono ou administrador da conta, porque a tela fica em **Configurações**.

## Criar o formulário

**1. Abra a aba Flows**

No menu lateral, clique em **Configurações**. Em **Canais**, clique em **WhatsApp** e abra a aba **Flows**. A lista mostra os formulários da conta, com o **Estado** de cada um.

Clique em **Novo**.

![Tela WhatsApp com a aba Flows e o botão Novo numerados](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/01-aba-flows.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=f5e4eae0d48442202a089b6c7556caea)

**2. Dê nome, conta e categoria**

Na tela **Novo Flow**, preencha:

1. **Nome**: só você vê esse nome, mas ele precisa ser único na conta de negócios. Use algo que diga o objetivo, como "Agendamento de visita".
2. **Conta**: o número que vai enviar o formulário. Ele fica ligado a essa conta e não pode ser movido depois.
3. **Categoria**: o WhatsApp usa a categoria para revisar o formulário. Escolha a que mais combina, por exemplo **Agendamento**, **Pesquisa** ou **Captação de leads**.

Clique em **Criar e abrir o estúdio**.

![Tela Novo Flow com Nome, Conta, Categoria e o botão Criar e abrir o estúdio numerados](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/02-novo-flow.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=26103356c45f364eb8c716c62093498d)

**3. Conheça o estúdio**

O estúdio tem três colunas:

1. **Telas**: as etapas do formulário, na ordem em que o cliente passa por elas. Clique em **Nova tela** para acrescentar uma. Arraste para mudar a ordem.
2. **Conteúdo da tela**: o **Título da tela** e tudo o que aparece nela, de cima para baixo. Clique num item para abrir os campos dele.
3. **Prévia**: uma simulação do formulário no celular, que muda enquanto você edita. Você pode preencher e tocar nos botões para testar o caminho.

![Estúdio com as colunas Telas, Conteúdo da tela e Prévia numeradas](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/03-estudio.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=ba8af8bd8eede281cfae98a3f8de4e82)

**4. Adicione textos e campos**

Com uma tela selecionada, clique em **Adicionar conteúdo**. O menu separa os itens por tipo:

* **Texto**: **Título**, **Subtítulo**, **Parágrafo**, **Legenda** e **Texto formatado**, para explicar o que a pessoa vai preencher.
* **Mídia**: **Imagem**.
* **Entrada**: **Campo de texto**, **Área de texto**, **Seletor de data** e **Calendário**, para respostas que a pessoa digita ou escolhe.
* **Escolha**: **Escolha única**, **Múltipla escolha**, **Lista suspensa** e **Aceite**.
* **Ação** e **Caminho**: o **Botão de ação** que leva à próxima tela, links e condições que mudam o caminho conforme a resposta.

Num agendamento, por exemplo, a primeira tela pode pedir nome e e-mail, a segunda a data e o período, e a última pedir a confirmação.

![Menu Adicionar conteúdo aberto com os grupos Texto, Mídia e Entrada](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/04-adicionar-conteudo.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=f82d261e27ec6a8a1d1b20ff44930fb1)

**5. Escolha onde cada resposta fica salva**

Clique num campo para abrir os ajustes dele: **Rótulo**, **Resposta obrigatória**, **Texto de ajuda** e outros, conforme o tipo.

No fim, em **Salvar resposta em**, escolha o campo personalizado do contato que vai receber essa resposta. Assim o nome, a data da visita ou a cidade ficam gravados no cadastro do cliente, prontos para usar em fluxos, campanhas e no CRM. Se deixar em **Não salvar**, a resposta aparece no relatório e na conversa, mas não vai para o contato.

![Campo Nome completo aberto com o seletor Salvar resposta em destacado](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/05-salvar-resposta.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=1ca45314d72745db81bd237567f4d56f)

> [!TIP]
>
> Crie os campos personalizados antes, em **Configurações** > **Campos**, para eles aparecerem na lista. Essa escolha continua editável mesmo depois que o formulário é publicado.

**6. Feche o caminho com uma tela final**

Toda tela precisa de um **Botão de ação**. Nas telas do meio, ele leva para a próxima tela. Na última, ligue a chave **Tela final** e deixe o botão em **Concluir o Flow**, que é o toque que envia as respostas.

![Tela Confirmação com a chave Tela final ligada e o botão Confirmar destacados](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/06-tela-final.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=fb0584df345e2c00809aaa3e008a5f11)

## Enviar ao WhatsApp e publicar

O formulário passa por três etapas antes de chegar ao cliente: você salva, ele é enviado ao WhatsApp para validação e, quando estiver pronto, você publica.

**1. Salve e sincronize**

No alto do estúdio:

1. **Salvar** grava o rascunho. Se não houver nenhum problema, a WizeBot também envia o formulário ao WhatsApp em segundo plano.
2. **Sincronizar** envia ao WhatsApp e espera a resposta dele. Se tudo der certo, aparece o aviso **Sincronizado** e a prévia passa a refletir essa versão.
3. **Publicar** só fica disponível depois de uma sincronização sem erros.

Os problemas aparecem numa barra abaixo do editor, com a indicação do campo errado. O WhatsApp recusaria um formulário com erro, então a WizeBot não envia enquanto houver algum.

![Barra do estúdio com os botões Salvar, Sincronizar e Publicar numerados](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/07-salvar-sincronizar-publicar.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=65efe2a10c7567ebc5b82ed59da322cc)

**2. Confira no celular**

Clique em **Ver na Meta**, na coluna **Prévia**, para abrir o formulário como o WhatsApp vai mostrar. A prévia do estúdio é uma aproximação. O link da Meta vale por 30 dias e depois a WizeBot gera outro.

**3. Publique**

Clique em **Publicar** e confirme na janela **Publicar Flow**. A partir daí o formulário pode ser enviado aos clientes e aparece com o estado **Publicado** na lista.

![Janela Publicar Flow com o aviso de que o formulário não poderá mais ser editado e o botão Publicar destacado](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/08-confirmar-publicacao.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=842a082538def51ed476c24fe5853551)

> [!WARNING]
>
> Depois de publicado, o formulário não pode mais ser editado nem excluído. Essa é uma regra do WhatsApp. Para mudar algo, abra o menu **...** do formulário na lista e use **Criar cópia para editar**. A cópia nasce como rascunho, e você publica a nova versão quando terminar.

## Enviar o formulário para os clientes

O envio acontece por um fluxo de conversa, com o bloco **Formulário do WhatsApp**. Nele você escolhe o formulário publicado, a **Tela inicial**, a **Mensagem** que acompanha o botão e o **Texto do botão** que abre o formulário. Em **Esperar resposta por**, defina um prazo para o fluxo seguir por outro caminho com quem não respondeu.

Veja como configurar cada opção em [Blocos avançados](https://help.wizebot.com.br/tutoriais/fluxos/blocos-avancados.md).

> [!NOTE]
>
> O bloco envia o formulário dentro da janela de 24 horas, ou seja, numa conversa em que o cliente mandou mensagem há menos de 24 horas. Para testar antes de publicar, use o **Modo de envio** **Rascunho (teste)**, que só abre para os números de teste da conta.

## Onde ver as respostas

Quando o cliente toca no botão final, a resposta aparece em três lugares:

* **Na conversa**: no **Chat**, como a mensagem **Formulário respondido**, com cada pergunta e resposta.
* **No contato**: nos campos escolhidos em **Salvar resposta em**.
* **No relatório**: na lista de **Flows**, abra o menu **...** do formulário e clique em **Relatório**.

![Menu de ações do formulário Pesquisa de satisfação com a opção Relatório destacada](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/09-menu-relatorio.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=aa489ebc24c12529c4eb19180751613c)

O relatório mostra quantos formulários foram **Enviados**, quantos foram **Respondidos**, a **Taxa de resposta** e os **Pendentes**, além de uma linha por contato com as respostas. Filtre pelo período ou busque por um contato, e use **Exportar CSV** para levar os dados para uma planilha.

![Relatório da Pesquisa de satisfação com os totais e as respostas de cada contato](https://mintcdn.com/wizebot-d8529edc/_a9Kw-tVkdyKVMV2/images/whatsapp-flows/10-relatorio.png?fit=max\&auto=format\&n=_a9Kw-tVkdyKVMV2\&q=85\&s=586db4bb45b1e3fea66ef825cd5aebbc)

Dentro do mesmo fluxo, os blocos seguintes também podem usar as respostas pelo nome do campo, como `{{formulario.nome}}`.

## Problemas comuns

> [accordion] Não foi possível criar o Flow: o nome já existe
>
> O nome precisa ser único na conta de negócios, inclusive entre formulários criados fora da WizeBot. Escolha outro nome.

> [accordion] O botão Publicar está apagado
>
> O formulário ainda não foi sincronizado sem erros. Corrija os problemas da barra abaixo do editor e clique em **Sincronizar**. Quando aparecer o aviso **Sincronizado**, o botão fica disponível.

> [accordion] Apareceu O WhatsApp recusou o Flow
>
> O WhatsApp encontrou erros de validação. Eles aparecem na barra abaixo do editor, com o lugar de cada um. Corrija e sincronize de novo.

> [accordion] O formulário aparece com Envio bloqueado ou Só na janela de 24h
>
> Na lista de **Flows**, a coluna **Envio** mostra o que o WhatsApp permite. **Envio bloqueado** quer dizer que o formulário não sai em nenhuma conversa até o motivo ser resolvido. **Só na janela de 24h** quer dizer que ele funciona nas conversas abertas pelo cliente. Abra o menu **...** e clique em **Verificar envio** para ver o motivo e o que fazer.

> [accordion] O estado mudou para Limitado
>
> O WhatsApp limitou o formulário a 10 envios por hora. O envio continua funcionando dentro desse limite.

> [accordion] O formulário aparece com Aguardando número
>
> O formulário veio copiado de outra empresa e ainda não está ligado a um número. Abra o formulário e, na faixa abaixo do cabeçalho do estúdio, escolha o número em **Escolha o número**. Só depois disso ele vai para o WhatsApp como rascunho. O número escolhido não pode ser trocado depois. Se o formulário também aparecer como **Sem conteúdo**, monte as telas no estúdio antes de escolher o número.

> [accordion] Não consigo editar um formulário publicado
>
> Formulário publicado não muda mais. Use **Criar cópia para editar**, ajuste a cópia, publique e troque o formulário no bloco do fluxo. Se não quiser mais enviar o antigo, use **Descontinuar**.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


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