Formulários: receber dados do seu próprio site

Todo formulário tem um endpoint: um endereço que recebe os dados direto do seu site. Serve para quem já tem um formulário com o layout do próprio site e só quer que as respostas cheguem ao DeepLead, sem incorporar nada. O tratamento é o mesmo do formulário publicado: cria ou atualiza o contato, aplica lista, tags e negócio.

Esta parte é técnica. Normalmente quem faz é a pessoa que cuida do seu site.

# Onde fica

• No editor do formulário (módulo Marketing → Formulários → Editar), botão Endpoint, no topo.
• Na lista, no menu de três pontos de um formulário publicado: Copiar endpoint copia só o endereço.

# Antes de começar

• O formulário precisa estar publicado. Em rascunho, o diálogo avisa: “O endpoint só aceita envios com o formulário publicado.”
• Os campos que o seu site vai enviar precisam existir no formulário, cada um com destino no contato. Um deles tem de ser o Email.

# O que o diálogo mostra

O diálogo Endpoint do formulário tem quatro partes:

As duas últimas partes ficam recolhidas. Clique no título de cada uma para abrir.

# Enviar com HTML puro

1. Clique em Endpoint e fique na aba HTML.
2. Clique no ícone de copiar do código.
3. Cole no HTML da sua página e aplique o seu estilo.

O código é um <form> comum, que funciona sem JavaScript. Depois de enviar, o visitante vai para a URL de redirecionamento do formulário. Sem ela, vê uma página de confirmação padrão, com o título “Formulário enviado”, a sua Mensagem de sucesso e o link Voltar.

# Enviar com JavaScript

1. Na aba JavaScript, copie o código.
2. Adapte o seletor do formulário ao seu site.

A página não recarrega e a resposta vem em JSON: com a mensagem de sucesso do formulário quando deu certo, ou com o texto do erro quando não deu. Mostrar isso ao visitante fica por conta do seu site.

A aba cURL traz um comando para testar o endpoint pelo terminal.

# Nomes dos campos

Use os nomes listados em Nomes dos campos aceitos. Em geral:

• os campos do contato usam name, email, phone e company;
• um campo personalizado usa o próprio rótulo em minúsculas, sem acento e com sublinhado no lugar dos espaços (o rótulo “Cargo Atual” vira cargo_atual).

O endpoint ignora diferença de maiúsculas, acentos e separadores: Cargo Atual, cargo-atual e cargo_atual caem no mesmo campo. O envio pode ser em JSON ou no formato padrão de formulário HTML.

Campo enviado que não existe no formulário não vai para o contato.

# Capturar dados que o visitante não digita

Para gravar a origem do lead, como utm_source:

1. Crie um campo personalizado de contato para guardar o valor.
2. No formulário, adicione um campo com esse destino e marque Oculto.
3. No seu site, preencha o valor por script. No código da aba HTML, o campo oculto já vem como um campo escondido, com o comentário “oculto: preencha via script”.

Campo oculto não aparece no formulário publicado nem no código de incorporação, e nunca é obrigatório.

# Para onde o visitante vai depois de enviar

Vale para o envio em HTML puro:

As URLs precisam ser completas, começando com http:// ou https://.

# Proteção contra spam

O código da aba HTML já inclui um campo escondido chamado _honeypot. Pessoas não o veem; robôs costumam preencher tudo. Se ele chegar preenchido, o envio é descartado: o robô recebe a resposta de sucesso, mas nada é gravado. Mantenha o campo escondido e vazio.

# Campos de controle

# Regras e limites

• O endpoint só aceita envios de formulário publicado.
• O endereço usa o identificador da empresa e o slug do formulário. Se o slug mudar, o endereço muda: atualize o seu site.
• As validações são as mesmas do formulário publicado: campo obrigatório sem valor e e-mail inválido recusam o envio.
• A URL de redirecionamento não afeta o link público nem o formulário incorporado. Neles o visitante sempre vê a Mensagem de sucesso.

# Problemas comuns

# Veja também

• Formulários: criar e configurar
• Formulários: publicar, incorporar e receber respostas
• Campos personalizados
• Webhooks e chaves de API