Formulários simples

Use esta página quando você quer colocar um formulário da Clickmax no ar com o menor esforço possível.

Antes de começar

Você precisa:

criar uma página externa na Clickmax
adicionar essa página ao seu funil
instalar o loader do Browser SDK no <head> da página

Depois disso, o jeito mais simples de capturar leads é marcar um formulário existente com data-cx-ingest-form.

Exemplo mínimo

<form
  data-cx-ingest-form
  data-cx-success-message="Enviado com sucesso!">
  <input data-cx-field="name" placeholder="Seu nome" />
  <input data-cx-field="email" placeholder="Seu e-mail" />
  <input data-cx-field="telephone" placeholder="Seu telefone" />
  <button type="submit">Enviar</button>
</form>

O que esse exemplo já faz

coleta name, email e telephone
envia os dados para a Clickmax
inclui UTM da página quando existirem
mostra mensagem de sucesso
permite que a Clickmax acompanhe esse envio no funil

Campos recomendados

Para um formulário simples, use estes campos:

name
email
telephone
website como honeypot

Exemplo:

<form
  data-cx-ingest-form
  data-cx-success-message="Enviado com sucesso!">
  <input data-cx-field="name" placeholder="Seu nome" />
  <input data-cx-field="email" placeholder="Seu e-mail" />
  <input data-cx-field="telephone" placeholder="Seu telefone" />
  <input type="text" data-cx-field="website" hidden />
  <button type="submit">Enviar</button>
</form>

Campos customizados

Além dos campos padrão (name, email, telephone), você pode enviar campos customizados do CRM direto do formulário: basta marcar o input com data-cx-field usando a chave do campo — o id, o nome interno (fieldName) ou o rótulo (displayName) do campo, resolvidos nessa ordem.

<form
  data-cx-ingest-form
  data-cx-success-message="Enviado com sucesso!">
  <input data-cx-field="name" placeholder="Seu nome" />
  <input data-cx-field="email" placeholder="Seu e-mail" />
  <input data-cx-field="telephone" placeholder="Seu telefone" />

  <!-- campos customizados: a chave é o id, o fieldName ou o rótulo do campo -->
  <input data-cx-field="empresa" placeholder="Empresa" />
  <select data-cx-field="faixa_salarial">
    <option value="">Selecione…</option>
    <option value="ate-3000">Até R$ 3.000</option>
    <option value="acima-3000">Acima de R$ 3.000</option>
  </select>

  <button type="submit">Enviar</button>
</form>

Qualquer data-cx-field que não seja um campo padrão do lead é enviado como campo customizado — o SDK agrupa esses valores automaticamente.

Regras:

O campo customizado precisa já existir no CRM. Chaves que não correspondem a nenhum campo são ignoradas silenciosamente — este endpoint não cria campos.
A correspondência é case-insensitive para fieldName e displayName.

O mesmo comportamento vale via JavaScript com cxs('lead', { customFields }). Veja Criar lead via JavaScript.

Quando usar esta abordagem

Use form[data-cx-ingest-form] quando:

você já tem o HTML do formulário
você quer continuar controlando o layout
você quer a integração mais simples possível

Sem um formulário HTML

Se o envio é controlado pelo seu próprio JavaScript (por exemplo, uma aplicação React ou um funil de múltiplos passos), você pode criar o lead diretamente com cxs('lead', ...). Veja Criar lead via JavaScript.

#Formulários simples

#Antes de começar

#Exemplo mínimo

#O que esse exemplo já faz

#Campos recomendados

#Campos customizados

#Quando usar esta abordagem

#Sem um formulário HTML