Para qué sirve#
Un formulario público es una página (o un bloque que pones en tu sitio web) donde una persona deja sus datos, los corrige, elige sus preferencias de correo o confirma su suscripción. Cada campo se conecta con un dato real de Connecto: el contacto, un campo personalizado, un metadato, una lista de distribución o el consentimiento.
Quién puede usarlo y cómo llegar#
Solo administradores y supervisores. Ruta: Difusiones y formularios → Formularios (/formularios). Los demás roles ven «Solo un administrador o supervisor puede gestionar formularios.» y el ítem ni siquiera aparece en su menú.
La biblioteca de formularios#
Arriba hay dos pestañas, Activos y Archivados (con su contador), un buscador Buscar por nombre..., el botón Nuevo formulario y un icono de escudo para la protección contra robots (ver Incrustar un formulario).
| Columna | Qué muestra |
|---|---|
| Formulario | Nombre y su dirección corta (/f/…) |
| Tipo | Captura, Actualizar datos, Preferencias o Confirmación |
| Estado | Publicado o Borrador |
| Envíos y Vistas | Respuestas recibidas y veces que se abrió |
| Conversión | Envíos ÷ vistas (en %) |
| Por revisar | Envíos que esperan confirmación o revisión |
| Actualizado y Por | Última modificación y quién |
La tabla se pagina de a 20, 50 o 100. Al pulsar una fila se abre el editor. El menú de tres puntos de cada fila ofrece:
| Opción | Qué hace |
|---|---|
| Editar | Abre el editor |
| Ver envíos | Abre las respuestas (Envíos de formularios) |
| Enlace y código | Muestra el enlace y el código para incrustar |
| Publicar / Despublicar | Cambia el estado (al publicar se valida el formulario) |
| Duplicar | Crea «Nombre (copia)» en borrador |
| Archivar / Restaurar | Archivar lo despublica; los archivados no responden |
| Eliminar | Borra el formulario y sus envíos (los contactos no se tocan; el enlace deja de funcionar). Pide confirmación |
Tipos de formulario#
Al pulsar Nuevo formulario eliges el tipo (cada uno nace con campos de ejemplo):
| Tipo | Para qué | Campos de ejemplo |
|---|---|---|
| Captura de contactos | Pedidos de información y registros: crea o completa un contacto | Nombre (obligatorio), Correo (obligatorio), Teléfono. Título «Déjanos tus datos» |
| Actualizar datos | Que cada contacto corrija sus datos desde un enlace personal, sin iniciar sesión | Nombre, Teléfono y hasta 3 campos opcionales del contacto, todos en modo «Reemplazarlo». Botón «Guardar cambios» |
| Preferencias de correo | La persona elige a qué listas pertenecer, o se da de baja | Correo, las listas de distribución como casillas y «Quiero recibir correos». Botón «Guardar preferencias» |
| Confirmar suscripción | Un botón para confirmar que quiere recibir correos | Correo; autoriza el canal de correo. Botón «Sí, quiero recibir correos» |
El editor#
Barra superior: nombre del formulario (obligatorio, hasta 150 caracteres, único: si ya existe «Ya existe un formulario con ese nombre.»), insignia Borrador/Publicado, Abrir (cuando está publicado), Publicar/Despublicar y Guardar (también con Ctrl+S). Si sales con cambios sin guardar aparece «Hay cambios sin guardar» con Seguir editando, Salir sin guardar y Guardar y salir.
Tres secciones a la izquierda: Campos, Configuración y Publicar (ver Incrustar un formulario).
Sección Campos#
Tiene tres columnas: tipos de campo (izquierda), vista del formulario (centro) y propiedades (derecha). Para agregar un campo, arrástralo o haz clic. Para mover, arrastra o usa las flechas de la barra del campo seleccionado (subir, bajar, duplicar, eliminar). Máximo 60 campos.
Tipos de campo: Texto, Correo, Teléfono, Texto largo, Número, Fecha, Lista, Opción única, Varias opciones, Casilla, Título, Texto (informativo) y Oculto.
Atajos «Datos del contacto»: Nombre, Apellidos (si está activo en los ajustes de contactos), Correo electrónico, Teléfono, los campos opcionales activos del contacto y los campos personalizados. «Preferencias y consentimiento»: todas las listas de distribución (casillas), una casilla por lista, Consentimiento: canal (Correo electrónico, WhatsApp, Messenger, Instagram o Telegram) y una casilla por metadato.
Propiedades de cada campo:
| Propiedad | Qué hace |
|---|---|
| Etiqueta (o Texto en título y párrafo) | Lo que ve la persona |
| Texto de ayuda | Nota bajo el campo |
| Texto de ejemplo (placeholder) | En texto, correo, teléfono, texto largo y número |
| Valor que se guarda | Solo en campos Oculto (por ejemplo «landing-octubre»); sirve para saber de dónde vino |
| Obligatorio / Debe marcarse para enviar | Campo requerido |
| Opciones | En Lista, Opción única y Varias opciones: valor que se guarda y texto que ve la persona (hasta 100 opciones). En casillas conectadas a listas o metadatos eliges de la lista del sistema |
| Guardar en | Destino de la respuesta (ver tabla siguiente) |
| Si el contacto ya tiene un dato | Solo completar si está vacío o Reemplazarlo (solo con enlace personal) |
| No preguntar si ya lo tenemos | Con enlace personal, oculta el campo si ya hay dato (perfilado progresivo) |
| Mostrar solo si… | Hace el campo condicional respecto a otro: es igual a, no es igual a, está marcado, está vacío, tiene valor |
Destinos posibles:
| Destino | Qué hace |
|---|---|
| Dato del contacto | Nombre, Correo o Teléfono |
| Campo opcional del contacto | Apellidos, fecha de nacimiento, edad, nacionalidad, tipo y número de documento, dirección (solo los activos en la empresa) |
| Campo personalizado | Un campo personalizado del contacto |
| Metadato | Asigna ese metadato al contacto |
| Lista de distribución | Agrega al contacto a una lista de distribución ACTIVA |
| Consentimiento | Autoriza (o, en preferencias, da de baja) un canal |
| Solo guardar en el envío | La respuesta solo queda registrada en el envío |
Los campos de tipo Casilla pueden ir a metadato, lista, consentimiento o campo personalizado de tipo interruptor; «Varias opciones» a metadato o lista. Si eliges el destino, el campo toma el tipo adecuado (por ejemplo, la nacionalidad se vuelve una lista de países).
Sección Configuración#
Todas las opciones aplican a todos los envíos del formulario.
| Bloque | Opción | Qué hace | Por defecto |
|---|---|---|---|
| Encabezado y botón | Título, Descripción | Lo que se ve al abrir | Según el tipo |
| Texto del botón | Hasta 60 caracteres | «Enviar» | |
| Al terminar, ir a esta dirección (opcional) | Debe empezar por http:// o https:// | Vacío | |
| Mensaje de agradecimiento | Hasta 1000 caracteres | «¡Gracias! Recibimos tus datos.» | |
| Qué pasa con los contactos | Tipo de contacto para los nuevos | Tipo con el que se crea el contacto | «El primero de la lista» |
| Asignar estos metadatos a quien envíe | Metadatos que se asignan siempre | Ninguno | |
| Agregar a estas listas de distribución | Listas a las que se agrega siempre | Ninguna | |
| Prefijo telefónico por defecto | Para teléfonos escritos sin código de país | 57 | |
| Oportunidades (solo si el módulo está activo) | Crear una oportunidad al enviar | Crea una oportunidad en un embudo, o mueve la que ya tiene abierta | Apagado |
| Embudo, Etapa inicial, Título, Producto, Valor, y «Si ya tiene una oportunidad abierta en este embudo» (dejarla o moverla a una etapa) | Embudo predeterminado, primera etapa | ||
| Consentimiento y confirmación | Al enviar, autorizar estos canales | Solo en formularios de confirmación | Correo electrónico |
| Pedir confirmación por correo (doble confirmación) | Listas y consentimientos se aplican solo cuando la persona confirma desde su correo | Activado | |
| Texto legal debajo del formulario (opcional) | Hasta 500 caracteres; queda guardado con la fecha, IP y texto | Vacío | |
| Asunto y Mensaje del correo de confirmación | Asunto hasta 200, mensaje hasta 1000 caracteres | «Confirma tu suscripción» / «Para terminar, confirma que quieres recibir nuestros correos.» | |
| Perfilado progresivo | Activar perfilado progresivo | Con enlace personal, oculta los campos marcados «No preguntar si ya lo tenemos» cuando ya hay dato | Apagado |
| Diseño | Color del botón y acentos, Color de fondo, Bordes redondeados (0 a 30 px), Ancho máximo (320 a 900 px) | #10B981, #FFFFFF, 8 px, 560 px | |
| Seguridad e incrustación | Pedir verificación Cloudflare Turnstile | Solo funciona si hay claves guardadas | Activado (pero sin claves no se muestra) |
| Sitios donde se puede incrustar (opcional) | Dominios separados por espacio; vacío = cualquier sitio | Vacío | |
| Avisos | Usuarios (administradores y supervisores) | Reciben una notificación con cada envío | Ninguno |
Paso a paso#
- En Formularios, pulsa Nuevo formulario y elige el tipo.
- Escribe el nombre arriba a la izquierda.
- En Campos, ajusta o agrega campos y conecta cada uno con su destino.
- En Configuración, revisa el mensaje final, las listas o metadatos que se asignan y la doble confirmación.
- Pulsa Guardar.
- Pulsa Publicar. El formulario queda disponible en su enlace (ver Incrustar un formulario).
Reglas y comportamientos#
- Para publicar el formulario no puede tener problemas. Si los tiene, el sistema responde «No se puede publicar todavía: …» con la lista:
- «Agrega al menos un campo.» (salvo en Confirmar suscripción).
- «Hay un campo sin etiqueta.»
- «“Campo” necesita opciones.» (en listas y opciones sin destino de lista o metadato).
- «Para la doble confirmación necesitas un campo de correo electrónico (destino: Correo del contacto).»
- «Elige a qué canales se da el consentimiento en la pestaña Configuración.» (en Confirmar suscripción).
- Si guardas un formulario publicado con errores, queda automáticamente en Borrador y se avisa.
- Cada formulario tiene una dirección única
/f/<nombre>_<código>que no cambia al renombrarlo. - El formulario de tipo Actualizar datos solo tiene sentido con enlace personal: ahí los datos del contacto llegan cargados.
<!-- Fuente: tenant-app/public/formularios/index.php, tenant-app/public/formularios/editor.php, tenant-app/public/formularios/editor.js, tenant-app/public/api/formularios.php, shared/src/Core/Formularios.php, db/migrations/0108_formularios.sql -->