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