brieffyv0.1.0

Formulários do site

O que o snippet captura de um formulário enviado e como ajustar isso.

Atualizado em 13 de outubro de 2026

Com o snippet instalado, todo formulário enviado na página vira um lead já preenchido: nome, e-mail, telefone, mensagem e o resto dos campos que a pessoa digitou. O canal do lead é Formulário.

Como o snippet entende cada campo

Para cada campo do formulário, o snippet olha o tipo, o nome e o rótulo:

ViraQuando o campo…
E-mailé do tipo e-mail, ou o nome/rótulo tem "email" ou "e-mail"
Telefoneé do tipo telefone, ou o nome/rótulo tem "telefone", "phone", "celular", "whats" ou "fone"
Mensagemo nome/rótulo tem "mensagem", "message", "comentário" ou "observação"
Nomeo nome/rótulo tem a palavra "nome" ou "name", mas não "empresa" nem "usuário"
Outras informaçõesqualquer outro campo (inclusive um segundo telefone ou uma área de texto sem esses nomes), com o rótulo como título (até 50 campos)

Tudo o que chega aparece no detalhe do lead: o contato em Contato e o restante em Outras informações.

O que nunca é lido

Senhas, arquivos, campos ocultos e qualquer campo que pareça cartão de crédito, código de segurança ou CPF ficam de fora.

Ajustar pelo HTML

Se um campo não for reconhecido sozinho, diga o que ele é com data-ko-field. Para não capturar um formulário (uma busca do site, a newsletter), use data-ko-ignore nele:

<form>
  <input name="contato_principal" data-ko-field="email">
  <input name="fone_dono" data-ko-field="phone">
  <button>Enviar</button>
</form>

<form data-ko-ignore>
  <input name="q" placeholder="Buscar no site">
</form>

Os valores aceitos em data-ko-field são name, email, phone e message. Com outro valor (como nome ou telefone), o campo vai para Outras informações, mesmo que o snippet o reconhecesse sozinho.

A mesma pessoa de novo

Se alguém mandar o formulário de novo, o brieffy junta tudo no mesmo lead quando o e-mail ou o telefone batem com um lead dos últimos 90 dias. Quem já clicou no WhatsApp vindo do mesmo anúncio também cai no mesmo lead, pelo gclid do anúncio. O envio novo só preenche o que está vazio no lead: um nome, telefone, mensagem ou campo que o lead já tem não muda. Cada envio aparece no Histórico do lead.