Ir para o conteúdo
Todos os artigos
Integrações

Formulários de site, WordPress e SDK de captura

Capture leads de qualquer formulário do seu site (WordPress, Wix, HTML puro) direto no CRM: cole um formulário HTML pronto ou o SDK JS de captura. Cada envio vira um Lead automaticamente.

A integração "Formulários de site / WordPress" captura leads de qualquer formulário do seu site e cria um Lead no CRM a cada envio. É construída por nós, sem nenhuma conta externa: você só gera um endereço de captura (um token público) e aponta um formulário para ele. Os campos são mapeados de forma flexível (nome/e-mail/telefone/empresa/mensagem), e a origem do lead fica como "website" (ou o valor que você definir no campo "source").

Aceita o envio como um formulário HTML normal (application/x-www-form-urlencoded) ou como JSON, então funciona tanto com um <form> que você cola quanto com chamadas de código. O endereço aceita POST de qualquer domínio (CORS liberado), pois a graça é justamente receber o envio do site do cliente. Nasce inerte: nada é capturado até você gerar o endereço e ativar.

Pré-requisitos

  • Nenhuma conta externa nem credencial: a captura é construída por nós.
  • Acesso para editar o seu site: colar um <form> ou um <script> (no WordPress, um bloco "HTML personalizado" ou o rodapé do tema; também funciona com Contact Form 7, Elementor, Wix ou HTML puro).
  • No Sellio, ser administrador para gerar o endereço de captura e ativar a integração em Configurações → Integrações.

Como ativar

  1. Abra Configurações → Integrações e vá ao cartão "Formulários de site / WordPress".
  2. Clique em "Gerar endereço de captura" para criar a URL do webhook (um token único e público de captura).
  3. Copie o formulário HTML pronto (ou o SDK) e cole no seu site, conforme abaixo.
  4. Clique em "Ativar". A partir daí os envios passam a criar Leads no CRM.

Opção A: Formulário HTML pronto

No cartão, copie o bloco <form> pronto (ele já aponta para o seu endereço de captura) e cole-o onde quiser exibir o formulário. No WordPress, use um bloco "HTML personalizado". Você pode ajustar os campos livremente: os nomes name, email, phone, company e message são reconhecidos automaticamente. Um campo oculto "redirect" opcional leva o visitante a uma página de obrigado após o envio.

Exemplo: <form action="https://app.seudominio.com/api/inbound/webform/SEU_TOKEN" method="POST"> … <input name="email" required> … </form>

Opção B: SDK JS de captura (desenvolvedores)

Para sites que já têm formulários próprios (ou apps), cole o <script> do SDK no seu site. Ele expõe dois métodos no navegador, sem nenhum dado sensível (só o token público de captura vai no script):

  • window.Sellio.capture({ name, email, phone, company, message, source }): envia um lead diretamente (útil em botões, popups ou fluxos de app).
  • Sellio.trackForm('#meu-form'): intercepta o envio de um formulário existente e manda os campos ao CRM, sem você mexer no HTML do formulário.
Exemplo: <script src="https://app.seudominio.com/api/sdk/SEU_TOKEN/sellio.js" async></script> → depois: Sellio.trackForm('.wpcf7-form')

WordPress: Contact Form 7, Elementor e bloco HTML

  • Bloco HTML: cole o formulário pronto (Opção A) num bloco "HTML personalizado" da página.
  • Contact Form 7: mantenha o seu formulário CF7 e adicione o SDK (Opção B) ao rodapé do tema; depois chame Sellio.trackForm(".wpcf7-form"). Os nomes de campo do CF7 (your-name, your-email) já são reconhecidos.
  • Elementor: mantenha o Elementor Form e adicione o SDK ao site; use Sellio.trackForm() com o seletor do seu formulário para enviar cada submissão ao CRM.

O que vira um Lead

Cada envio com algo identificável (e-mail, telefone ou nome) cria um Lead, com a origem definida pelo campo "source" (padrão "website"). Campos que você enviar e que não sejam os padrão são anexados à mensagem do lead, para nada se perder. A captura é idempotente por best-effort: se você enviar um "external_id", reenvios do mesmo id não duplicam; sem external_id, leads com o mesmo e-mail também não são duplicados.

Segurança

  • O token da URL é PÚBLICO e serve só para captura: ele identifica a sua conta, mas não expõe dados nem permite ler nada. Nunca coloque um segredo no formulário ou no SDK.
  • Se precisar invalidar o endereço atual, use "Gerar novo token": o formulário/SDK antigo para de funcionar.
  • Token inválido ou integração desativada retornam 404; envios vazios (sem nada identificável) são ignorados silenciosamente.
💡 Comece com o formulário HTML pronto para validar rapidamente, e migre para o SDK (trackForm) quando quiser manter o visual do seu formulário atual do WordPress.

Como testar

  1. Cole o formulário HTML pronto (Opção A) numa página de teste do seu site e ative a integração.
  2. Preencha e envie o formulário com um e-mail de teste.
  3. No CRM, abra a lista de Leads e confirme que surgiu um Lead com a origem "website" (ou o valor do campo "source").
  4. Reenvie com o mesmo e-mail (ou o mesmo external_id) e confirme que NÃO duplica.

Solução de problemas

  • Não cria Lead: confirme que a integração está "Ativada" e que o <form>/SDK aponta para o endereço de captura correto. Envios totalmente vazios (sem e-mail, telefone ou nome) são ignorados silenciosamente.
  • 404 na URL: o token do endereço mudou (você clicou em "Gerar novo token") ou a integração está desativada; copie o endereço atual e atualize o formulário/SDK.
  • SDK não intercepta o formulário: confira o seletor passado a Sellio.trackForm() (ex.: ".wpcf7-form"); no CF7/Elementor o SDK precisa carregar no site (rodapé do tema).
  • Campos não vêm: use os nomes reconhecidos (name, email, phone, company, message); nomes do CF7 (your-name, your-email) já são aceitos. Campos extras são anexados à mensagem do lead.
  • Não coloque segredos no formulário: o token da URL é PÚBLICO e serve só para captura, portanto não expõe nem lê dados.

Abrir este artigo dentro do sistema

Leu e quer ver funcionando?

A conta é grátis e o manual inteiro está disponível dentro do sistema, com um assistente que responde pelo próprio conteúdo.

Criar conta grátis
Formulários de site, WordPress e SDK de captura · Sellio