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

# Formulários

> Crie formulários de captura de leads integrados ao WhatsApp com assinatura digital, UTM tracking e múltiplos destinos.

Os Formulários do Brainchat permitem criar páginas de captura de leads que enviam os dados diretamente para o seu WhatsApp e salvam os contatos automaticamente. Cada formulário tem sua própria URL pública.

> [card] Campos personalizáveis
>
> Texto, e-mail, telefone, seleção, múltipla escolha, assinatura digital e mais.

> [card] Múltiplos destinos
>
> Envie dados para WhatsApp, webhook, e-mail de notificação ou redirecionamento.

> [card] Assinatura digital
>
> Adicione um campo de assinatura com validade jurídica para contratos e termos.

> [card] UTM tracking
>
> Rastreie a origem de cada lead com parâmetros UTM automáticos.

***

## Criar um Formulário

![Galeria de modelos de formulário com Em branco, Contato simples e Orçamento B2B](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/captacao/formularios-modelos.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=bb95ceab84f00c6a4283dfae5f8778ae)

Começar por um modelo

**1. Acessar Formulários**

Vá em **Captação → Formulários** no menu lateral. A tela tem as abas **Lista**, **Capturas** e **Métricas**.

**2. Criar novo formulário**

Clique em **Criar Formulário** e escolha **Em branco** ou um modelo. Depois preencha, na aba **Informações**:

* **Nome** — identificação interna (ex: "Formulário de Contato")
* **Slug** — identificador único na URL (apenas letras, números e hífens)

A URL pública do formulário será: `https://brainchat.app/f/{slug}`

O editor tem as abas **Informações**, **Campos**, **Aparência**, **Assinatura** (quando há campo de assinatura), **Destino**, **Embed**, **UTM**, **Privacidade** e **Métricas**.

**3. Adicionar campos**

Arraste os tipos de campos para o formulário e configure cada um. Veja os [tipos de campos disponíveis](https://docs.brainchat.app/captacao/formularios/campos.md).

**4. Configurar destino**

Defina o que acontece quando o formulário é submetido. É possível combinar múltiplos destinos simultaneamente.

**5. Publicar**

Ative o formulário e compartilhe a URL pública ou incorpore em um site.

***

![Página pública do formulário Fale com a gente com os campos Nome, WhatsApp e Mensagem](https://mintcdn.com/stegia/wBHQtkFobgptFVvY/images/captacao/formulario-publico.png?fit=max\&auto=format\&n=wBHQtkFobgptFVvY\&q=85\&s=d9b0cc5f77706b4330705c295a403472)

O formulário publicado, como o visitante vê

## Destinos de Submissão

Ao configurar o formulário, defina **onde os dados vão** após o envio. Você pode combinar múltiplos destinos:

### WhatsApp Inbound

Quando o formulário é submetido, uma **mensagem automática de boas-vindas** é enviada ao número de telefone informado pelo lead. O contato aparece nas conversas do canal escolhido.

> [!NOTE]
>
> O campo **Telefone** no formulário precisa estar presente e preenchido para o destino de WhatsApp funcionar. Sem um telefone válido, o lead é salvo como contato mas não inicia conversa.

### Webhook

Envie os dados do formulário para um sistema externo (CRM, ERP, planilha Google, etc.) via requisição HTTP POST. Configure:

* **URL do webhook**
* O payload enviado inclui todos os campos do formulário + metadados (timestamp, UTM, IP, etc.)

### E-mail de Notificação

Receba um e-mail a cada nova submissão. Configure:

* **Para** — destinatário principal
* **CC** — com cópia para outro e-mail
* CC dinâmico — usar o valor de um campo do formulário como CC (ex: e-mail do vendedor responsável)

### Redirecionamento

Após o envio, redirecione o visitante para uma URL:

* **Mensagem de sucesso** (padrão) — exibe uma mensagem de confirmação na mesma página
* **Redirecionar para outra página** — envia para outra página (ex: thank you page, WhatsApp, site externo)

***

## Mensagem de Resposta Automática

Configure uma **mensagem de resposta automática** que é enviada ao número do lead via WhatsApp imediatamente após o envio do formulário. Personalize com variáveis:

```
Olá, {{nome}}! Recebemos seu contato e em breve entraremos em contato.
```

As variáveis disponíveis são os **nomes dos campos** configurados no formulário.

***

## UTM Tracking

Os Formulários capturam automaticamente os parâmetros UTM da URL de acesso ao formulário. Se o visitante chegou via:

```
https://brainchat.app/f/meu-formulario?utm_source=instagram&utm_medium=bio&utm_campaign=lancamento
```

Os valores `utm_source`, `utm_medium` e `utm_campaign` são salvos no contato criado.

No painel, filtre contatos por origem usando as tags UTM para entender quais canais geram mais leads.

***

## Aparência

Cada formulário tem configurações visuais independentes:

* **Logo** — imagem da sua marca
* **Cor primária** — cor dos botões e destaques
* **Cor de fundo** — cor da página do formulário
* **Cor do texto** — cor do texto geral
* Botão de envio — texto personalizado (padrão: "Enviar")
* **Mensagem de sucesso** — texto exibido após o envio

***

## Gerenciar Formulários

![Lista de formulários com o formulário Fale com a ACME ativo e as ações de cada um](https://mintcdn.com/stegia/wBHQtkFobgptFVvY/images/captacao/formularios-lista.png?fit=max\&auto=format\&n=wBHQtkFobgptFVvY\&q=85\&s=45414ab0af2aa71224ab3b17cc62ebd1)

Lista de formulários

Na lista de formulários (**Captação → Formulários**), cada formulário tem **Ver capturas**, **Editar**, **Copiar link**, **Visualizar**, **Gerar Link UTM**, **Gerar QR Code**, **Duplicar**, **Métricas** e **Abrir tabela completa** (cada formulário grava numa tabela, uma linha por envio):

| Ação | Descrição |
| - | - |
| **Ativar/Desativar** | Formulários desativados exibem uma página de erro ao visitante |
| **Copiar link** | Copia o link público do formulário |
| **Ver capturas** | Acessa o histórico de respostas recebidas |
| **Duplicar** | Cria uma cópia com todas as configurações |
| **Editar** | Abre o editor visual completo |
| **Excluir** | Remove permanentemente |

> [!WARNING]
>
> Excluir um formulário não remove os contatos ou submissões já registrados. Os dados históricos permanecem na seção **Capturas**.


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