Cómo funciona una araña en Clientify
A nivel técnico, una araña:
Localiza el
<form>en el DOM.Captura los campos mediante el atributo
name.Escucha el envío del formulario (submit o click).
Envía los datos a Clientify antes del envío normal.
Registra el contacto y deja que el formulario continúe su flujo.
Comprender este flujo te ayudará a diagnosticar más rápido cualquier error.
Requisitos técnicos obligatorios
Las arañas solo funcionan si el formulario cumple todos los siguientes puntos:
Campo de email obligatorio
El formulario debe tener un campo mapeado al email del CRM.
Sin email, la araña no puede crear contactos.
Formulario HTML correcto
El formulario debe estar dentro de:
<form> … </form>
Todo campo fuera del formulario será ignorado.
Botón con envío nativo
El botón debe usar:
type="submit"
Botones con type="button" o scripts que interceptan el envío impiden que la araña capture los datos.
Cada campo debe tener atributo name
La araña solo procesa inputs con name.
El script debe estar al final del <body>
Si se coloca en el <head>, el DOM aún no existe y la araña no detecta el formulario.
<script> … araña … </script> </body>
El formulario debe existir desde el primer render
Formularios cargados después por JavaScript (pop-ups, AJAX, wizards dinámicos) no funcionan.
No funciona en páginas SPA (React, Vue, Angular, etc.)
Al regenerarse el DOM, la araña pierde referencia al formulario.
No debe estar dentro de un iframe
Por seguridad del navegador, una araña no puede acceder al contenido dentro de un iframe.
No debe haber scripts que intercepten el envío
Cualquier preventDefault() o lógica personalizada que bloquee el submit impedirá la captura.
Evitar plugins de caché agresivos
Plugins como WP Rocket, LiteSpeed, Cloudflare u otros pueden bloquear o retrasar el script.
Cómo crear una araña correctamente
Entra a Formularios → Arañas.
Crea una nueva araña.
Ingresa la URL del formulario.
Clientify detectará los campos disponibles.
Mapea los campos (email obligatorio).
Copia el script.
Pégalo antes del
</body>en tu página.
Errores comunes y cómo solucionarlos
La araña no captura el envío
Causas más frecuentes:
Falta el campo email.
Formulario inválido.
Botón no envía con submit.
Campos sin
name.Script mal ubicado.
Plugins de caché.
Iframes o SPA.
Solución: verificar todos los requisitos anteriores.
Los cambios no se reflejan (cache)
Las arañas usan caché, por lo que los cambios tardan en aplicarse.
Solución recomendada:
Crear una araña nueva y reemplazar el script anterior.
Scripts personalizados bloquean el submit
Ejemplo:
event.preventDefault();
Solución:
Configurar la araña en modo click en botón,
oPermitir un envío nativo antes del JS del usuario.
Campos multiselección
Las arañas no soportan selects múltiples ni plugins como Select2.
Solución: unificar valores en un campo hidden.
Mapeos duplicados
En Clientify 2.0 no se permite mapear un mismo campo del CRM a más de un campo del formulario.
Formulario dinámico
Formularios cargados después del load no funcionan con arañas.
Solución: que el formulario exista desde el inicio o usar un formulario nativo.
Checklist rápido para soporte
✔ Formulario válido
✔ Email presente
✔ Botón con submit
✔ Script al final del body
✔ Sin iframes
✔ No SPA
✔ Campos con name
✔ Sin duplicados
✔ Sin scripts que bloqueen el envío
✔ Sin caché agresiva
Recomendación si el formulario no es compatible
Si el formulario no puede ajustarse a los requisitos técnicos, se recomienda usar:
Formularios nativos de Clientify
Compatibilidad total, sin dependencias externas y cero errores.