> ## 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.

# Formulários

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.

<CardGroup cols={2}>
  <Card title="Campos personalizáveis" icon="list">
    Texto, e-mail, telefone, seleção, múltipla escolha, assinatura digital e mais.
  </Card>

  <Card title="Múltiplos destinos" icon="share-nodes">
    Envie dados para WhatsApp, webhook, e-mail de notificação ou redirecionamento.
  </Card>

  <Card title="Assinatura digital" icon="pen-to-square">
    Adicione um campo de assinatura com validade jurídica para contratos e termos.
  </Card>

  <Card title="UTM tracking" icon="chart-line">
    Rastreie a origem de cada lead com parâmetros UTM automáticos.
  </Card>
</CardGroup>

***

## Criar um Formulário

<Steps>
  <Step title="Acessar Formulários">
    Vá em **Apps → Formulários** no menu lateral. Você verá a lista de formulários existentes.
  </Step>

  <Step title="Criar novo formulário">
    Clique em **Novo Formulário**. Preencha:

    * **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}`
  </Step>

  <Step title="Adicionar campos">
    Arraste os tipos de campos para o formulário e configure cada um. Veja os [tipos de campos disponíveis](/apps/formularios-campos).
  </Step>

  <Step title="Configurar destino">
    Defina o que acontece quando o formulário é submetido. É possível combinar múltiplos destinos simultaneamente.
  </Step>

  <Step title="Publicar">
    Ative o formulário e compartilhe a URL pública ou incorpore em um site.
  </Step>
</Steps>

***

## 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 da instância vinculada.

<Info>
  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.
</Info>

### 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 URL** — 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

Na lista de formulários (**Apps → Formulários**):

| Ação                 | Descrição                                                      |
| -------------------- | -------------------------------------------------------------- |
| **Ativar/Desativar** | Formulários desativados exibem uma página de erro ao visitante |
| **Copiar URL**       | Copia o link público do formulário                             |
| **Ver submissões**   | 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**.
</Warning>