Ir al contenido
Todos los artículos
Integraciones

Formularios de sitio, WordPress y SDK de captura

Captura leads de cualquier formulario de tu sitio (WordPress, Wix, HTML puro) directo en el CRM: pega un formulario HTML listo o el SDK JS de captura. Cada envío se convierte en un Lead automáticamente.

La integración "Formularios de sitio / WordPress" captura leads de cualquier formulario de tu sitio y crea un Lead en el CRM en cada envío. Está construida por nosotros, sin ninguna cuenta externa: solo generas una dirección de captura (un token público) y apuntas un formulario hacia ella. Los campos se mapean de forma flexible (nombre/correo/teléfono/empresa/mensaje), y el origen del lead queda como "website" (o el valor que definas en el campo "source").

Acepta el envío como un formulario HTML normal (application/x-www-form-urlencoded) o como JSON, así que funciona tanto con un <form> que pegas como con llamadas de código. La dirección acepta POST de cualquier dominio (CORS abierto), pues la gracia es justamente recibir el envío del sitio del cliente. Nace inerte: nada se captura hasta que generes la dirección y actives.

Requisitos previos

  • Ninguna cuenta externa ni credencial: la captura está construida por nosotros.
  • Acceso para editar tu sitio: pegar un <form> o un <script> (en WordPress, un bloque "HTML personalizado" o el pie del tema; también funciona con Contact Form 7, Elementor, Wix o HTML puro).
  • En Sellio, ser administrador para generar la dirección de captura y activar la integración en Configuración → Integraciones.

Cómo activarla

  1. Abre Configuración → Integraciones y ve a la tarjeta "Formularios de sitio / WordPress".
  2. Haz clic en "Generar dirección de captura" para crear la URL del webhook (un token único y público de captura).
  3. Copia el formulario HTML listo (o el SDK) y pégalo en tu sitio, según abajo.
  4. Haz clic en "Activar". A partir de ahí los envíos pasan a crear Leads en el CRM.

Opción A: formulario HTML listo

En la tarjeta, copia el bloque <form> listo (ya apunta a tu dirección de captura) y pégalo donde quieras mostrar el formulario. En WordPress, usa un bloque "HTML personalizado". Puedes ajustar los campos libremente: los nombres name, email, phone, company y message se reconocen automáticamente. Un campo oculto "redirect" opcional lleva al visitante a una página de agradecimiento tras el envío.

Ejemplo: <form action="https://app.tudominio.com/api/inbound/webform/TU_TOKEN" method="POST"> … <input name="email" required> … </form>

Opción B: SDK JS de captura (desarrolladores)

Para sitios que ya tienen formularios propios (o apps), pega el <script> del SDK en tu sitio. Expone dos métodos en el navegador, sin ningún dato sensible (solo el token público de captura va en el script):

  • window.Sellio.capture({ name, email, phone, company, message, source }): envía un lead directamente (útil en botones, popups o flujos de app).
  • Sellio.trackForm('#mi-form'): intercepta el envío de un formulario existente y manda los campos al CRM, sin que toques el HTML del formulario.
Ejemplo: <script src="https://app.tudominio.com/api/sdk/TU_TOKEN/sellio.js" async></script> → luego: Sellio.trackForm('.wpcf7-form')

WordPress: Contact Form 7, Elementor y bloque HTML

  • Bloque HTML: pega el formulario listo (Opción A) en un bloque "HTML personalizado" de la página.
  • Contact Form 7: mantén tu formulario CF7 y agrega el SDK (Opción B) al pie del tema; luego llama Sellio.trackForm(".wpcf7-form"). Los nombres de campo de CF7 (your-name, your-email) ya se reconocen.
  • Elementor: mantén el Elementor Form y agrega el SDK al sitio; usa Sellio.trackForm() con el selector de tu formulario para enviar cada envío al CRM.

Qué se convierte en un Lead

Cada envío con algo identificable (correo, teléfono o nombre) crea un Lead, con el origen definido por el campo "source" (predeterminado "website"). Los campos que envíes y que no sean los estándar se anexan al mensaje del lead, para que nada se pierda. La captura es idempotente en base a best-effort: si envías un "external_id", los reenvíos del mismo id no duplican; sin external_id, los leads con el mismo correo tampoco se duplican.

Seguridad

  • El token de la URL es PÚBLICO y sirve solo para captura: identifica tu cuenta, pero no expone datos ni permite leer nada. Nunca pongas un secreto en el formulario o en el SDK.
  • Si necesitas invalidar la dirección actual, usa "Generar nuevo token" y el formulario/SDK antiguo deja de funcionar.
  • Un token inválido o una integración desactivada devuelven 404; los envíos vacíos (sin nada identificable) se ignoran silenciosamente.
💡 Empieza con el formulario HTML listo para validar rápido, y migra al SDK (trackForm) cuando quieras mantener el aspecto de tu formulario actual de WordPress.

Cómo probarla

  1. Pega el formulario HTML listo (Opción A) en una página de prueba de tu sitio y activa la integración.
  2. Completa y envía el formulario con un correo de prueba.
  3. En el CRM, abre la lista de Leads y confirma que surgió un Lead con origen "website" (o el valor del campo "source").
  4. Reenvía con el mismo correo (o el mismo external_id) y confirma que NO duplica.

Solución de problemas

  • No crea Lead: confirma que la integración está "Activada" y que el <form>/SDK apunta a la dirección de captura correcta. Los envíos totalmente vacíos (sin correo, teléfono o nombre) se ignoran silenciosamente.
  • 404 en la URL: el token de la dirección cambió (hiciste clic en "Generar nuevo token") o la integración está desactivada; copia la dirección actual y actualiza el formulario/SDK.
  • El SDK no intercepta el formulario: verifica el selector pasado a Sellio.trackForm() (p. ej., ".wpcf7-form"); en CF7/Elementor el SDK necesita cargarse en el sitio (pie del tema).
  • Los campos no llegan: usa los nombres reconocidos (name, email, phone, company, message); los nombres de CF7 (your-name, your-email) ya se aceptan. Los campos extra se anexan al mensaje del lead.
  • No pongas secretos en el formulario: el token de la URL es PÚBLICO y sirve solo para captura, no expone ni lee datos.

Abrir este artículo dentro del sistema

¿Lo leíste y quieres verlo funcionando?

La cuenta es gratis y el manual entero está disponible dentro del sistema, con un asistente que responde con este mismo contenido.

Crear cuenta gratis
Formularios de sitio, WordPress y SDK de captura · Sellio