ID de visitante personalizado (formularios incrustados)

Cuando incrustas un NueForm dentro de tu propia app, normalmente ya sabes quién es el usuario — tiene una cuenta en tu sistema, tienes un ID de usuario interno, y te gustaría que el formulario restaure silenciosamente sus respuestas anteriores cada vez que lo abre. Sin tener que gestionar las cookies de NueForm, el almacenamiento del navegador, o que tus respondientes vean un mensaje «¿Continuar o empezar de nuevo?».

El parámetro de URL nf_visitor se encarga de esto. Combinado con las opciones Permitir reanudación + Reanudación automática del formulario, tus usuarios finales solo ven el formulario — nunca la interfaz de reanudación de NueForm.

Ejemplo rápido

https://nueform.io/f/tu-form-slug?nf_visitor=usuario-12345

Si existe una respuesta parcial para usuario-12345, el formulario la restaura silenciosamente. Si no, el formulario empieza limpio. El usuario nunca ve un modal, nunca elige «Continuar o empezar de nuevo», ni siquiera sabe que existe un mecanismo de reanudación.

Para «reiniciar» a un usuario (darle un comienzo limpio), elige un nuevo valor de nf_visitor:

https://nueform.io/f/tu-form-slug?nf_visitor=usuario-12345-intento-2

El seguimiento de identidad es tu responsabilidad — elige el esquema que se ajuste a tu app.

Lista de configuración

1. Abre tu formulario en el constructor de NueForm.
2. Expande la sección Permitir reanudación.
3. Activa Permitir a los encuestados reanudar donde lo dejaron.
4. Activa el nuevo subtoggle Reanudación automática.
5. Incrusta el formulario usando el patrón de URL anterior, suministrando tu propio valor nf_visitor.

Eso es todo.

Cómo funciona

• nf_visitor se lee en la página del respondiente en cada carga.
• Reemplaza el ID de visitante basado en cookies que NueForm normalmente usa para reanudación + deduplicación.
• No se escribe nada en localStorage cuando nf_visitor está presente — tu valor es la única fuente de verdad, y el navegador del respondiente se mantiene limpio.
• Los envíos, guardados parciales y consultas de reanudación se basan en tu valor.
• El parámetro se elimina de urlVariables antes de la sustitución de variables del formulario, por lo que nunca aparece en campos ocultos, payloads de webhook, ni detección de fuente de tráfico de analítica.

Reglas de validación

El valor debe:

• Tener entre 1 y 256 caracteres
• Coincidir con [A-Za-z0-9_\-:.@]+ — letras, dígitos, guion bajo, guion, dos puntos, punto y @

Los UUID, direcciones de correo electrónico y la mayoría de los IDs opacos de tu propia base de datos encajan naturalmente. Si el valor no coincide, NueForm lo ignora silenciosamente y vuelve al ID de visitante derivado de cookies. No se muestra ningún error al usuario, así que verifica el comportamiento con tu entorno de pruebas antes de pasarlo a producción.

Cuándo se ignora nf_visitor

nf_visitor se ignora completamente cuando el formulario tiene Requerir inicio de sesión del respondiente activado.

Estas dos funciones son mutuamente excluyentes — no puedes tener ambas. Si Requerir inicio de sesión del respondiente está activado, NueForm usa la identidad autenticada del respondiente (sesión de Auth0) y el parámetro de URL se trata como si nunca se hubiera proporcionado. Todo fluye naturalmente como una carga normal de formulario con sesión iniciada.

Si necesitas ambos comportamientos en el mismo formulario, debes elegir uno — responden a preguntas fundamentalmente distintas:

• Requerir inicio de sesión del respondiente dice: «Necesito una identidad verificada en la que pueda confiar en cada envío.»
• nf_visitor dice: «Yo respondo por la identidad, por favor usa este ID opaco.»

Las dos no se pueden conciliar a nivel de formulario. Si necesitas identidad verificada dentro de un escenario incrustado, usa Requerir inicio de sesión del respondiente y deja que tus usuarios inicien sesión en NueForm directamente.

Combinando con Reanudación automática

Reanudación automática es la función que hace brillar a nf_visitor en escenarios incrustados. Con ambas activas:

• Los usuarios que regresan ven sus respuestas previamente introducidas inmediatamente. Sin mensaje, sin elección.
• Los usuarios nuevos (un valor nf_visitor nuevo) ven un formulario vacío.
• «Solo lectura después de enviar» se respeta — una vez que el usuario ha enviado, las cargas posteriores con el mismo nf_visitor muestran la vista completada de solo lectura, que es exactamente lo que quieres para un escenario incrustado de registro/recibo.

Sin Reanudación automática, los usuarios que regresan seguirían viendo el modal «¿Continuar o empezar de nuevo?» de NueForm aunque hayas suministrado la identidad — un fallo de UX para casos de uso incrustados. Reanudación automática lo elimina.

Notas de privacidad

• nf_visitor se convierte en la clave principal de búsqueda para la respuesta en la base de datos de NueForm. Elige valores que controles y que no colisionen entre usuarios no relacionados.
• No pongas información personal identificable (PII) que no quieras almacenada en NueForm en el valor (por ejemplo, no pases direcciones de correo electrónico crudas si puedes usar un ID opaco en su lugar). El valor se incluye en payloads de webhook + analítica para la respuesta.
• El valor es visible para cualquiera con la URL — trátalo como cualquier otro token de URL. Si tu escenario incrustado muestra la barra de URL al usuario, considera un ID opaco en lugar de algo adivinable.

Combinando con campos ocultos

Otros parámetros de URL siguen funcionando como variables del formulario junto con nf_visitor. Por ejemplo:

https://nueform.io/f/tu-form-slug?nf_visitor=usuario-12345&plan=premium&fuente=flujo-actualizacion

plan y fuente están disponibles para interpolación de variables en títulos de preguntas, saltos lógicos, etc., según el comportamiento estándar de campos ocultos. Solo nf_visitor está reservado.