ID de Visitante Personalizado (Formulários Incorporados)

Quando você incorpora um NueForm dentro do seu próprio aplicativo, geralmente já sabe quem é o usuário — ele tem uma conta no seu sistema, você tem um ID de usuário interno e gostaria que o formulário restaurasse silenciosamente as respostas anteriores dele sempre que fosse aberto. Sem que você precise gerenciar cookies do NueForm ou armazenamento do navegador, e sem que seus respondentes vejam um aviso de "Continuar ou começar do zero?".

O parâmetro de URL nf_visitor cuida disso. Combinado com as configurações de formulário Permitir Retomada + Retomada automática, seus usuários finais veem apenas o formulário — nunca a interface de retomada do NueForm.

Exemplo rápido

https://nueform.io/f/your-form-slug?nf_visitor=user-12345

Se existir uma resposta parcial para user-12345, o formulário a restaura silenciosamente. Se não, o formulário começa do zero. O usuário nunca vê um modal, nunca escolhe entre "Continuar ou Começar do zero" e nem sequer sabe que existe um mecanismo de retomada.

Para "reiniciar" um usuário (dar a ele um recomeço), escolha um novo valor de nf_visitor:

https://nueform.io/f/your-form-slug?nf_visitor=user-12345-attempt-2

O rastreamento de identidade é responsabilidade sua — escolha o esquema que melhor se adequar ao seu aplicativo.

Checklist de configuração

1. Abra seu formulário no construtor do NueForm.
2. Expanda a seção Permitir Retomada.
3. Ative Permitir que os respondentes retomem de onde pararam.
4. Ative o novo botão filho Retomada automática.
5. Incorpore o formulário usando o padrão de URL acima, fornecendo seu próprio valor de nf_visitor.

É isso.

Como funciona

• O nf_visitor é lido pela página do respondente do formulário a cada carregamento.
• Ele substitui o ID de visitante baseado em cookie que o NueForm normalmente usa para retomada + deduplicação.
• Nada é gravado no localStorage quando o nf_visitor está presente — seu valor é a fonte da verdade, e o navegador do seu respondente permanece limpo.
• Envios, salvamentos parciais e buscas de retomada usam seu valor como chave.
• O parâmetro é removido de urlVariables antes da substituição de variáveis do formulário, então ele nunca vaza para campos ocultos, payloads de webhook ou detecção de origem de tráfego nas análises.

Regras de validação

O valor deve:

• Ter de 1 a 256 caracteres
• Corresponder a [A-Za-z0-9_\-:.@]+ — letras, dígitos, sublinhado, hífen, dois-pontos, ponto e @

UUIDs, endereços de e-mail e a maioria dos IDs opacos do seu próprio banco de dados se encaixam naturalmente. Se o valor não corresponder, o NueForm o ignora silenciosamente e recorre ao ID de visitante derivado do cookie. Nenhum erro é exibido ao usuário, então verifique o comportamento no seu ambiente de teste antes de entrar em produção.

Quando o nf_visitor é ignorado

O nf_visitor é completamente ignorado quando o formulário tem Exigir login do respondente ativado.

Esses dois recursos são mutuamente exclusivos — você não pode ter ambos. Se Exigir login do respondente estiver ativado, o NueForm usa a identidade autenticada do respondente (sessão Auth0), e o parâmetro de URL é tratado como se nunca tivesse sido fornecido. Tudo flui naturalmente como um carregamento normal de formulário com login.

Se você precisar dos dois comportamentos no mesmo formulário, terá que escolher um — eles respondem a perguntas fundamentalmente diferentes:

• Exigir login do respondente diz: "Preciso de uma identidade verificada em que eu possa confiar em cada envio."
• nf_visitor diz: "Eu mesmo atesto a identidade; por favor, use este ID opaco."

Os dois não podem ser conciliados no nível do formulário. Se você precisar de identidade verificada dentro de um cenário incorporado, use Exigir login do respondente e deixe seus usuários entrarem diretamente no NueForm.

Combinando com a Retomada automática

A Retomada automática é o recurso que faz o nf_visitor brilhar em cenários incorporados. Com ambos ativados:

• Usuários que retornam veem suas respostas inseridas anteriormente de imediato. Sem aviso, sem escolha.
• Novos usuários (um valor novo de nf_visitor) veem um formulário vazio.
• O "Somente leitura após o envio" é respeitado — depois que o usuário envia, carregamentos subsequentes com o mesmo nf_visitor mostram a visualização concluída somente leitura, que é exatamente o que você quer para um cenário incorporado de registro/comprovante.

Sem a Retomada automática, os usuários que retornassem ainda veriam o modal "Continuar ou Começar do zero?" do NueForm, mesmo com a identidade fornecida por você — uma falha de UX para casos de uso incorporados. A Retomada automática a elimina.

Notas de privacidade

• O nf_visitor se torna a chave primária de busca da resposta no banco de dados do NueForm. Escolha valores que você controla e que não colidam entre usuários não relacionados.
• Não coloque no valor PII que você não queira armazenada no NueForm (por exemplo, não passe endereços de e-mail brutos se puder usar um ID opaco). O valor acompanha os payloads de webhook + as análises da resposta.
• O valor fica visível para qualquer pessoa com a URL — trate-o como qualquer outro token de URL. Se o seu cenário incorporado mostra a barra de URL ao usuário, considere um ID opaco em vez de algo fácil de adivinhar.

Combinando com campos ocultos

Outros parâmetros de URL continuam funcionando como variáveis de formulário junto com o nf_visitor. Por exemplo:

https://nueform.io/f/your-form-slug?nf_visitor=user-12345&plan=premium&source=upgrade-flow

plan e source ficam disponíveis para interpolação de variáveis em títulos de perguntas, saltos de lógica etc., conforme o comportamento padrão de campos ocultos. Apenas o nf_visitor é reservado.