Formulários de captura

Cole um formulário no seu site para novos contatos entrarem na base com as mesmas regras do painel (lista de bloqueio, descadastro, etc.).

Como usar

1. Em Automação → Formulários, crie um formulário (nome, campos, tags).
2. Se quiser confirmação por e-mail antes de enviar marketing, ligue o double opt-in.
3. Abra Código para o site, copie o trecho e cole no HTML da sua página ou compartilhe a página hospedada (/f/… no domínio da API).
4. Teste o envio: o contato deve aparecer em Contatos (ou ficar Aguardando confirmação se o DOI estiver ligado).

Embed no site

• O snippet inclui um <div> com data-form-url e o script form.js, servido pelo painel (FRONTEND_URL/embed/form.js).
• O script busca a meta pública, desenha os campos e envia para a API — funciona em qualquer site sem build extra.
• Mensagens de sucesso, DOI pendente e erro aparecem em português (ou no idioma da conta, quando disponível na meta).

Página hospedada

• Em Código para o site, use Abrir página hospedada — link curto no formato /f/{chave}.
• Ideal quando você não controla o HTML do site ou quer um link direto para captura.
• Formulário pausado mostra aviso amigável; o embed no site externo também para de aceitar envios.

Confirmação por e-mail (double opt-in)

• Com DOI ligado, o visitante recebe um e-mail com um botão para confirmar (não consome cota do plano).
• Na edição do formulário, a prévia do e-mail mostra o HTML real que será enviado.
• O link vale cerca de 7 dias. Se expirar, a pessoa pode se inscrever de novo no formulário, ou você pode Reenviar confirmação em Contatos.
• Em Contatos, filtre por Aguardando confirmação para ver quem ainda não clicou.
• A mensagem de agradecimento e o redirecionamento do formulário valem depois da confirmação; na hora do envio o visitante vê o pedido para confirmar o e-mail.

Métricas

• Na lista de formulários: colunas Envios, Confirmados e Conversão (confirmados ÷ envios no funil DOI).
• Na tela Código para o site, card Desempenho com o detalhe do formulário.

Dicas

• E-mail é sempre obrigatório.
• Tags do formulário são somadas às que o contato já tiver.
• Limite da fase atual: até 20 formulários ativos por conta.

Mídia (GIF) — pendente LAC-086

Placeholder: capturas ainda não publicadas. Arquivos futuros em help/assets/media/.

Checklist do que gravar:

• [ ] Automação → Formulários — criar formulário com tags e DOI
• [ ] Aba Código para o site — snippet embed + botão Abrir página hospedada
• [ ] Card Desempenho (envios / confirmados / conversão)
• [ ] Envio de teste no site com mensagem de sucesso ou “confirme seu e-mail”

Ainda não inclui

Analytics avançado (funil por origem, A/B de campos) — vem depois.