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

# Formulários de captação

> Fluxos públicos de perguntas e contato que criam lead e conversa no WhatsApp: editor, destinos, envio único por telefone e uso em link ou iframe.

Os **formulários de captação** são experiências públicas em que uma pessoa responde perguntas em sequência, informa nome e telefone e, ao concluir, vira **lead** no Spark com **conversa aberta** nos canais que você escolheu (WhatsApp ou WhatsApp Lite). Tudo acontece fora do painel: o visitante usa uma página hospedada pelo Spark (`sparkforms.com.br`) ou o mesmo conteúdo dentro de um **iframe** no seu site.

## Para que servem

* Captar interesse em landing pages, anúncios ou materiais sem depender só de “clique no WhatsApp”.
* **Qualificar** antes de falar com o time: perguntas de escolha guiam o fluxo e registram respostas estruturadas.
* **Abrir o atendimento já no inbox**, com histórico do que a pessoa respondeu — o time continua no mesmo CRM e chats que já usa.

## O que o formulário é capaz de fazer

### Editor de fluxo (canvas)

Cada formulário é um **grafo de blocos** conectados por setas:

| Bloco               | Função                                                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Início**          | Ponto de entrada do fluxo. Deve existir **exatamente um**.                                                                                                                            |
| **Pergunta**        | Pergunta com **escolha única** ou **múltipla escolha**, com texto e opções configuráveis. Cada pergunta tem um **identificador interno** (`questionKey`) para não misturar respostas. |
| **Nome e telefone** | Coleta nome e telefone (obrigatório no modelo atual). Deve existir **exatamente um** por formulário.                                                                                  |
| **Fim**             | Encerra o fluxo após o envio. Pode haver **um ou mais** nós de fim.                                                                                                                   |

O sistema valida a estrutura antes de salvar: caminho do início até a captura de contato, da captura até um fim, opções ligadas corretamente em perguntas de escolha única (cada opção com um próximo passo), entre outras regras.

### Ramificações por resposta

* **Escolha única:** cada opção pode levar a um **próximo bloco diferente** (por exemplo, “Empresa” → fluxo B2B, “Pessoa física” → fluxo B2C).
* **Múltipla escolha:** as saídas podem usar combinações de opções com critério **“qualquer”** ou **“todas”**, para fluxos que dependem de mais de um interesse marcado.

### Destinos (canais)

Você escolhe **um ou mais pontos de entrada** da organização — apenas **WhatsApp** ou **WhatsApp Lite** configurados nas integrações. Ao concluir o formulário, o Spark cria (ou reutiliza) **lead e chat em cada destino marcado**, para o mesmo contato. Assim, uma captação pode abrir conversa em mais de um número ou canal, se fizer sentido para a operação.

### Envio e deduplicação

Cada combinação **formulário + telefone** admite **uma submissão**. Se a mesma pessoa tentar enviar de novo, a API responde com conflito — evita duplicar leads por reenvio acidental ou abuso simples.

### Ativar e desativar

Formulários **inativos** não aceitam novas respostas públicas. Use para pausar campanhas sem apagar o fluxo.

### Registro das respostas

As respostas das perguntas e os dados de contato ficam em um **snapshot** da submissão (texto da pergunta, valores escolhidos, nome e telefone normalizado), além do resultado com os **IDs de lead e chat** por canal — útil para auditoria e integrações.

### Uso fora do painel

* **Link direto** com identificador público do formulário (16 caracteres) e **chave de API** da organização na query string — a mesma ideia das integrações em [Configurações → Desenvolvedores](https://crmspark.com.br/dash/settings/developers).
* **Iframe** no seu site, apontando para a mesma URL pública. Opcionalmente você configura uma **lista de origens permitidas** (domínios HTTPS) para restringir onde o iframe pode ser embutido quando a proteção estiver ativa no ambiente público.

## Relação com o restante do Spark

Formulários **não substituem** campos personalizados do CRM: eles são uma porta de entrada. Depois que o chat existe, o time usa inbox, etiquetas, funil e campos da conversa como em qualquer outro lead.

## Próximo passo

Passo a passo com exemplo de landing e, no final, iframe: [Criar um formulário (exemplo de uso)](/guia/formulario-exemplo-landing).