Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioDifusiones y formularios

Incrustar un formulario

Para qué sirve#

Una vez publicado, puedes compartir el formulario de tres formas: con un enlace propio, incrustado en tu página web con una línea de código, o por correo con un enlace personal para cada contacto.

Quién puede usarlo y cómo llegar#

Administradores y supervisores. Ruta: editor del formulario (/formularios/editor) → sección Publicar; o en la lista de formularios, menú de tres puntos → Enlace y código. Hay que guardar el formulario primero: sin guardar verás «Guarda el formulario primero».

La sección Publicar#

Estado#

Muestra si el formulario está publicado («cualquier persona con el enlace puede responderlo») o en borrador («el enlace todavía no funciona»). El botón Publicar ahora / Despublicar cambia el estado. Si el formulario tiene problemas, no se publica (ver Crear un formulario).

1. Enlace para compartir#

Una página propia con tu formulario, con la forma https://tu-dominio/f/<código>. Úsala en redes sociales, WhatsApp o un código QR. Cada bloque tiene un botón de copiar. La página no se indexa en buscadores.

Si el formulario no está publicado, archivado o no existe, la persona ve «Este formulario no está disponible. Puede que haya terminado o que el enlace sea incorrecto.»

2. Incrustarlo en tu página web#

Pega esta línea donde quieras que aparezca el formulario (cambia el dominio y el código por los tuyos; el editor te los entrega listos para copiar):

HTML
<script src="https://tu-dominio/f/embed.js" data-form="codigo-del-formulario" async></script>
  • El formulario aparece justo donde pongas el script y se ajusta solo al alto del contenido.
  • Opcional: data-ancho="480px" limita el ancho.
  • Si tu sitio no permite scripts, usa el iframe que muestra el editor:
HTML
<iframe src="https://tu-dominio/f/codigo-del-formulario?embed=1" style="width:100%;height:520px;border:0" title="Formulario"></iframe>
  • Si definiste Al terminar, ir a esta dirección, la página que incrusta el formulario es la que se redirige.
  • Sitios donde se puede incrustar: en Configuración del formulario puedes escribir los dominios permitidos (separados por espacios). Si lo dejas vacío, cualquier sitio puede incrustarlo. El enlace público siempre funciona.

3. Enviarlo por correo#

En el editor de Plantillas de correo agrega el bloque Formulario y elige este formulario. Cada persona recibe su propio enlace: el formulario llega con sus datos ya cargados y, con el perfilado progresivo, solo pregunta lo que aún no sabemos. No necesita iniciar sesión.

También puedes usar la variable {{formulario:codigo-del-formulario}} como destino de cualquier enlace o botón de una plantilla (en el editor: «Insertar variable»).

El enlace personal vale 90 días.

Protección contra robots#

Todos los formularios tienen siempre:

DefensaCómo funciona
Campo trampaUn campo oculto que solo llenan los robots; si se llena, el envío se descarta en silencio
Tiempo mínimoSi se envía en menos de 2 segundos: «Estás enviando muy rápido. Inténtalo de nuevo.»
Página con vigenciaSi la página lleva abierta más de 8 horas: «La página caducó. Recárgala e inténtalo de nuevo.»
Límite por dirección IPMás de 8 intentos en 10 minutos desde la misma IP en el mismo formulario: «Demasiados intentos. Espera unos minutos.»

Adicionalmente puedes activar Cloudflare Turnstile (gratis). En la lista de formularios, pulsa el icono de escudo («Protección contra robots (Cloudflare Turnstile)»):

  1. Entra a dash.cloudflare.com → Turnstile → Add widget.
  2. Pon cualquier nombre y, en Hostname, agrega el dominio de Connecto y los sitios donde incrustarás formularios.
  3. Elige el modo Managed y crea el widget.
  4. Copia la Site key (clave del sitio) y la Secret key (clave secreta) y pégalas en la ventana. La clave secreta se guarda cifrada; si ya hay una guardada, déjala vacía para conservarla.

Para desactivar el captcha, borra la Site key. Sin claves, los formularios se protegen igual con las cuatro defensas de arriba. Además, cada formulario tiene el interruptor Pedir verificación Cloudflare Turnstile en su Configuración (activado por defecto, pero solo se muestra si hay claves). Si falla la verificación: «No pudimos verificar que eres una persona. Inténtalo de nuevo.»

Lo que ve quien llena el formulario#

  1. Abre el enlace; ve el título, la descripción y los campos (con los condicionales apareciendo según lo que responda).
  2. Pulsa el botón (por defecto Enviar; cambia a «Enviando…» mientras se procesa).
  3. Si hay errores, cada campo muestra el suyo («Este campo es obligatorio.», «Escribe un correo válido.», «Escribe un teléfono válido (con el código de tu país si no es local).», «Escribe un número.», «Escribe una fecha válida.», «Elige una de las opciones.», «Elige al menos una opción.», «Debes marcar esta casilla para continuar.»).
  4. Si todo sale bien ve ¡Listo! y el mensaje de agradecimiento, o es redirigido a la dirección configurada.
  5. Con doble confirmación y listas o consentimientos pendientes, ve Revisa tu correo: «Te enviamos un correo a … para confirmar. Revisa también la carpeta de spam.»

Confirmación por correo#

El correo (con el asunto y mensaje que configuraste) trae un botón Confirmar y el aviso «Si no fuiste tú, ignora este correo: no se hará ningún cambio.» Se envía por la conexión de Campañas de correo. El enlace vale 7 días. Al abrirlo se muestra «Confirma tu solicitud» y el botón Sí, confirmar (un simple clic en el enlace no confirma nada, por si el programa de correo lo abre solo); luego «¡Listo! Confirmamos tu solicitud.» Si ya lo había confirmado: «Ya habías confirmado. ¡Gracias!» Si el enlace venció: «Este enlace ya no es válido».

Si el correo de confirmación no se puede enviar, la persona ve «No pudimos enviarte el correo de confirmación. Inténtalo de nuevo más tarde.» y el envío queda con estado Error.

Reglas del envío#

SituaciónQué pasa
La persona no existe (se busca por correo y, si no, por teléfono)Se crea un contacto nuevo con el tipo configurado. Sin nombre, se usa lo anterior a la @ del correo, el teléfono o «Contacto web»
Ya existe y el campo está vacíoSe completa
Ya existe, el dato es igualNo se cambia
Ya existe, el dato es distinto, envío por enlace públicoNo se reemplaza: queda como propuesta «por revisar» para el equipo
Ya existe, dato distinto, enlace personalSe reemplaza solo si el campo está en modo «Reemplazarlo»; si no, se omite
Quitar de una lista o dar de bajaSolo con enlace personal
Contacto bloqueado«No pudimos procesar tu solicitud.»
Con doble confirmación (envío anónimo con correo)Las listas y los consentimientos esperan la confirmación; los metadatos también, si el contacto ya existía

Con el enlace personal no hace falta doble confirmación.

Un formulario público puede ser llenado por cualquiera que tenga el enlace. Por eso el envío anónimo nunca sobrescribe datos que ya tenemos; esos cambios los decide una persona del equipo.

<!-- Fuente: tenant-app/public/formularios/editor.js, tenant-app/public/formularios/index.php, tenant-app/public/f/index.php, tenant-app/public/f/enviar.php, tenant-app/public/f/confirmar.php, tenant-app/public/f/embed.js, shared/src/Core/Formularios.php, tenant-app/public/api/formularios.php -->

¿Te fue útil esta página?
Última actualización: 14/11/2026