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

# Como criar e publicar um formulário

> Crie um formulário, adicione campos, veja a prévia, publique e divulgue o link público.

## Para que serve

O formulário capta dados de quem ainda não é seu contato (nome, WhatsApp, interesse). Cada resposta vira ou atualiza um contato. Você divulga um link público no endereço `/f/` do seu domínio.

## Quem pode

Dono, Admin e Supervisor criam e publicam. O Operador consegue abrir o editor e a prévia, mas o botão **Publicar** não aparece para ele. Só Dono e Admin excluem.

## Onde clicar

**Marketing › Formulários**. A lista mostra cada formulário com a situação (**Rascunho**, **Publicado** ou **Arquivado**), as respostas e a conversão. Use os filtros **Todos**, **Publicados**, **Rascunhos** e **Arquivados**.

## Passo a passo

**1. Crie o formulário**

Clique em **Novo formulário**. Escolha um modelo na **Biblioteca de modelos** (ou um em branco), dê um nome e clique em **Usar este modelo**.

**2. Adicione os campos**

Na aba **Construir**, clique num tipo da coluna **Campos**: texto, e-mail, telefone, escolha, data, estrelas, NPS, arquivo, consentimento e outros. Em cada campo, edite a **Pergunta** e marque **Obrigatório** se precisar.

**3. Ligue ao contato**

Em **Vincular ao contato (lead automático)**, escolha se o campo é nome, telefone ou e-mail. Assim a resposta cria o contato.

**4. Ajuste regras e aparência**

Em **Lógica**, crie **Nova regra** para pular, mostrar, ocultar ou exigir campos. Em **Tema**, escolha cores, fonte, logo e imagens.

**5. Veja a prévia**

Clique em **Visualizar**. A prévia abre em outra aba, em modo **Tradicional** ou **Conversacional**, e o envio fica desativado no rascunho.

**6. Publique**

Clique em **Publicar**. Aparece "Versão ... publicada!" com o botão **Copiar link**.

**7. Divulgue**

Na aba **Compartilhar**, copie o link público, baixe o QR Code em **Baixar PNG** ou copie a string para usar em mensagens e Flows.

## O que acontece depois

O link `/f/...` entrega sempre a versão publicada mais recente. Mudanças no rascunho só valem depois de publicar de novo. As respostas aparecem na aba **Resultados**, com opção **Exportar CSV**.

Em **Compartilhar**, também dá para definir o que acontece **Depois do envio** (texto de agradecimento, redirecionamento) e um **Webhook de resposta**, que recebe cada resposta. Para pausar sem despublicar, desligue **Aceitar novas respostas**. Para colocar o formulário em outro site, ligue **Permitir incorporar em sites** e liste os endereços permitidos.

> [!WARNING]
>
> Excluir um formulário apaga as respostas e faz o link público parar de funcionar.

## Erros comuns

* "Adicione ao menos um campo antes de publicar."
* "Informe o link de privacidade do campo Consentimento antes de publicar."
* "Não foi possível publicar." / "Não foi possível salvar o rascunho."
* "Formulário não encontrado": o link pode estar errado ou o formulário foi despublicado.
* "Este formulário não está aceitando novas respostas."
* O bloco de **Pagamento** precisa da Stripe conectada e do módulo Pagamentos. Sem eles o formulário publica sem cobrar.

## Próximo passo

* [Visão geral do Marketing](https://docs.stchat.app/subcontas/marketing.md)
* [Links curtos e Link na bio](https://docs.stchat.app/subcontas/links-e-link-na-bio.md)
* [Biblioteca de mídia](https://docs.stchat.app/subcontas/biblioteca-de-midia.md)


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