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

# Criar formulários do WhatsApp

> Crie seus próprios formulários do WhatsApp, publique-os, entenda o status, edite sem riscos e adicione um a um modelo com um botão Abrir um formulário.

Vá em **Canais**, depois **WhatsApp**, e clique em **Gerenciar formulários** no cartão **Formulários do WhatsApp**. A lista mostra cada formulário com o **Status**, o **Tipo**, quem está em **Usado por** e quando foi atualizado. Os administradores criam, editam, publicam e excluem formulários.

## Criar um formulário

**1. Comece**

Clique em **Novo formulário** e escolha um ponto de partida: **Em branco**, **Agendamento** (nome, email e depois um horário de reunião), **Lead** (nome, email, telefone e orçamento), **Consentimento** (um texto e uma caixa de seleção) ou **A partir de um agente** (uma cópia das perguntas de um agente qualificador ou de agendamento).

**2. Configurações**

Dê um **Nome** e escolha a **Conta do WhatsApp** a que ele pertence e o **Idioma do formulário** (o dos textos próprios do WhatsApp no formulário). Defina o **Botão da mensagem** que abre o formulário (até 30 caracteres) e os textos do **Botão próximo** e do **Botão enviar**.

**3. Telas e blocos**

Um formulário tem até 10 telas. Adicione blocos a cada uma:

* **Conteúdo**: **Título**, **Texto**, **Imagem** (JPEG ou PNG de até 10 MB, ajustada para o WhatsApp; até 3 por tela e 15 por formulário) e **Consentimento** (uma caixa de seleção com um link opcional "Leia mais" para os seus termos).
* **Perguntas**: **Resposta curta**, **Resposta longa**, **Número**, **Email**, **Telefone**, **Data**, **Escolha única** (até 200 opções), **Múltipla escolha** (até 20), **Sim / não**, **Envio de foto** e **Envio de documento** ([como funcionam](https://help.ciarem.ai/pt/channels/whatsapp-forms-uploads.md)).
* **Dinâmico**: **Reunião**, um seletor de dia e horário que agenda no seu calendário. Precisa de um calendário de agendamentos, e um formulário leva só uma.

O **Texto** aceita **negrito**, *itálico*, ~~tachado~~ e listas com marcadores ou numeradas. Um **Título**, um **Texto** e o **Texto da pergunta** podem incluir dados do contato: digite `{{` ou use o botão de variáveis, como nos modelos. Cada cliente vê os próprios dados. Se o contato não tiver um dado, ele é omitido, então escreva a frase para que ela funcione sem ele.

**4. Configure cada pergunta**

Escreva um **Rótulo** curto (até 20 caracteres, 30 em opções, 40 em datas) e, se precisar de mais palavras, o **Texto da pergunta** mostrado acima. Escolha **Salvar a resposta em** uma propriedade do contato: a pergunta passa a usar o tipo e as opções da propriedade. Cada propriedade é usada uma vez por formulário. Uma propriedade de arquivo só recebe a resposta de uma pergunta de fotos ou documentos. Marque como **Obrigatória** se precisar, e deixe ligado **Preencher com o que o contato já tem** para que o cliente só confirme o que você já sabe.

**5. Publique**

**Salvar rascunho** guarda seu trabalho sem enviar à Meta. **Publicar** envia à Meta, que confere em segundos (não há revisão humana). Quando está **Publicado**, **Visualizar no WhatsApp** abre a pré-visualização da Meta.

A pré-visualização do celular, à direita, mostra cada tela enquanto você monta.

## Status

| Status | O que significa |
| - | - |
| **Rascunho** | Salvo, não publicado. Não é enviado a ninguém. |
| **Publicado** | Ativo. Os agentes, sua equipe e os modelos podem enviá-lo. |
| **Com falha** | A Meta o rejeitou. Abra para ver o motivo da Meta, corrija e publique de novo. |
| **Limitado** ou **Bloqueado** | A Meta viu que um formulário com reunião estava falhando ou demorando demais para carregar. A Ciarem não o envia até a Meta marcá-lo como **Publicado** de novo, o que acontece sozinho quando o problema passa. |
| **Descontinuado** | Retirado na Meta. Não pode ser enviado. |

Um ponto vermelho significa **A Meta informou um problema com este formulário**.

**Usado por** mostra os agentes e modelos que usam o formulário. **Não usado** quer dizer que nada o envia ainda: adicione-o a um agente ([como](https://help.ciarem.ai/pt/ai-agent/whatsapp-forms-for-agents.md)) ou a um modelo. Os formulários marcados **Do agente** pertencem a um agente qualificador ou de agendamento: abrem só para leitura e são alterados no agente. Um formulário marcado **De pesquisas** é a sua [pesquisa de satisfação](https://help.ciarem.ai/pt/using-ciarem/satisfaction-surveys.md): também é só para leitura e é alterado em **Configurações**, depois **Pesquisas**.

## Editar um formulário publicado

Na Meta, um formulário publicado não pode mudar. Quando você edita um na Ciarem, ele volta a **Rascunho** até você publicar de novo, e publicar cria uma versão nova. As mensagens já enviadas continuam abrindo a versão com que saíram.

Enquanto a sua edição é um rascunho, os agentes e a Caixa de entrada não enviam o formulário; os modelos continuam enviando a última versão publicada. Por isso, publique logo depois de editar.

Não dá para excluir um formulário enquanto um agente ou um modelo o usa: remova dele primeiro.

## Adicionar a um modelo

No [editor de modelos](https://help.ciarem.ai/pt/channels/message-templates.md), adicione o botão **Abrir um formulário** e escolha um formulário publicado da mesma conta do WhatsApp. Um modelo leva um só formulário, e modelos de autenticação não podem levar nenhum. Cada destinatário recebe a própria cópia, também em [transmissões](https://help.ciarem.ai/pt/channels/broadcasts.md), e é assim que se envia um formulário com a janela de 24 horas fechada.

Quando você publica uma versão nova de um formulário, os modelos que o usam e estão aprovados, rejeitados ou pausados voltam para revisão da Meta e não podem ser enviados até serem aprovados de novo. A Ciarem pede confirmação antes. Os modelos que já estão em revisão mantêm a versão anterior.


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