NueForm

Modos de Formulário

Entenda os quatro modos de formulário do NueForm -- padrão, quiz de conhecimento, qualificação de leads e quiz de correspondência -- incluindo mecânica de pontuação, configurações de quiz e configuração de telas finais.

Visão Geral

O NueForm oferece suporte a quatro modos de formulário distintos, cada um projetado para um caso de uso diferente. O modo do formulário é definido pelo campo mode no modelo Form e determina como as respostas são pontuadas, como o feedback é apresentado e como as telas finais são selecionadas.

Escolher o modo certo afeta quais propriedades no nível da pergunta ficam disponíveis e como os resultados finais do envio são calculados.

Modo Padrão

Valor do modo: standard

O modo padrão é o predefinido para todos os novos formulários. Ele foi projetado para pesquisas, formulários de contato, coleta de feedback, formulários de inscrição e qualquer cenário em que a pontuação não seja necessária.

Comportamento

  • Nenhum tipo de pontuação ou nota.
  • As respostas são coletadas e armazenadas como estão.
  • As telas finais são puramente exibicionais -- não há direcionamento condicional baseado em pontuações ou resultados.
  • A tela de agradecimento padrão é mostrada após o envio.

Quando Usar

  • Formulários de contato e captura de leads
  • Pesquisas de satisfação do cliente
  • Inscrição em eventos
  • Formulários de feedback
  • Qualquer coleta de dados de uso geral

Modo Quiz de Conhecimento

Valor do modo: knowledge_quiz

O modo quiz de conhecimento foi projetado para quizzes, testes, provas e avaliações em que as perguntas têm respostas certas e erradas. Cada pergunta pontuável pode definir uma ou mais respostas corretas, e o respondente recebe uma pontuação com base em quantas acertou.

Mecânica de Pontuação

Cada pergunta pontuável tem uma propriedade correctAnswer que identifica a resposta correta. Quando o respondente envia, o NueForm compara as respostas dele com as respostas corretas e calcula os resultados:

Campo de ResultadoDescrição
scoreO número de perguntas respondidas corretamente.
correctAnswersA contagem de respostas corretas.
totalScorableQuestionsO número total de perguntas que participam da pontuação.
maxScoreA pontuação máxima alcançável (igual a totalScorableQuestions quando cada pergunta vale 1 ponto).

Tipos de Pergunta Pontuáveis

Apenas certos tipos de pergunta participam da pontuação do quiz de conhecimento:

  • Múltipla Escolha
  • Menu Suspenso
  • Escolha por Imagem
  • Sim/Não
  • Avaliação
  • Escala de Opinião

Os tipos de pergunta não pontuáveis (como texto curto, texto longo, upload de arquivo etc.) continuam incluídos no formulário, mas não contribuem para a pontuação do quiz.

Feedback do Quiz

O modo quiz de conhecimento oferece suporte a feedback em tempo real após cada pergunta. Quando ativado, o respondente vê imediatamente se sua resposta estava certa ou errada antes de avançar para a próxima pergunta.

Telas Finais com Faixas de Pontuação

No modo quiz de conhecimento, você pode criar várias telas finais com propriedades scoreRange para exibir condicionalmente resultados diferentes com base no desempenho do respondente. Cada tela final especifica uma faixa de pontuação mínima e máxima, e o respondente é direcionado à tela final cuja faixa contém sua pontuação final.

Exemplo:

  • Tela Final A: scoreRange 8-10 -- "Excelente! Você arrasou!"
  • Tela Final B: scoreRange 5-7 -- "Bom trabalho! Você passou."
  • Tela Final C: scoreRange 0-4 -- "Continue estudando e tente novamente."

Quando Usar

  • Quizzes e provas educacionais
  • Avaliações de treinamento
  • Jogos de trivia
  • Testes de certificação
  • Verificações de conhecimento

Modo Qualificação de Leads

Valor do modo: lead_qualification

O modo qualificação de leads foi projetado para pontuação de leads, avaliações de personalidade e formulários em que diferentes opções de resposta valem pontos diferentes. Em vez de uma única resposta correta, cada opção recebe uma pontuação numérica que se acumula conforme o respondente avança.

Mecânica de Pontuação

Cada opção em uma pergunta pontuável tem uma propriedade points que define seu valor numérico. Conforme o respondente seleciona respostas, os pontos se acumulam em uma pontuação total.

Campo de ResultadoDescrição
Pontuação totalA soma de todos os pontos das opções selecionadas em todas as perguntas pontuáveis.
matchedEndingIdO ID da tela final cuja faixa de pontuação corresponde ao total do respondente.

Configurando Pontos por Opção

No editor de perguntas, cada opção de escolha inclui um campo de valor de pontos quando o formulário está no modo qualificação de leads. Por exemplo:

  • "Muito interessado" -- 10 pontos
  • "Um pouco interessado" -- 5 pontos
  • "Sem interesse" -- 0 pontos

Telas Finais com Faixas de Pontuação

Cada tela final pode definir um scoreRange com valores min e max. Após o envio, o NueForm faz a correspondência entre a pontuação total do respondente e a tela final apropriada:

Exemplo:

  • Tela Final A: scoreRange 30-50 -- "Você é um lead quente! Um representante de vendas entrará em contato em breve."
  • Tela Final B: scoreRange 15-29 -- "Obrigado pelo interesse. Enviaremos mais informações."
  • Tela Final C: scoreRange 0-14 -- "Obrigado pelo seu tempo. Aqui estão alguns recursos para saber mais."

Quando Usar

  • Qualificação de leads de vendas
  • Avaliações de personalidade
  • Avaliações de risco
  • Mecanismos de recomendação
  • Pontuação de prioridade

Modo Quiz de Correspondência

Valor do modo: match_quiz

O modo quiz de correspondência foi projetado para quizzes baseados em resultados, em que cada resposta é mapeada para um resultado específico, e o resultado com mais correspondências determina o desfecho. É o formato clássico de quiz "Qual personagem é você?" ou "Qual é o seu estilo?".

Mecânica de Pontuação

O modo quiz de correspondência usa um sistema de contagem em vez de pontos numéricos:

  1. Os resultados do quiz são definidos nas quizSettings do formulário usando o array quizOutcomes. Cada resultado corresponde a uma tela final.
  2. Cada opção em uma pergunta pontuável tem uma propriedade matchOutcome que a mapeia para um dos resultados definidos.
  3. Conforme o respondente responde às perguntas, as contagens se acumulam para cada resultado.
  4. Após o envio, o resultado com a maior contagem determina qual tela final é exibida.

Configurando Resultados

Os resultados são definidos no nível do formulário em quizSettings.quizOutcomes. Cada resultado tem um nome e corresponde a uma tela final. No editor de perguntas, cada opção é mapeada para um resultado por meio de sua propriedade matchOutcome.

Exemplo:

Resultados: "Explorador", "Planejador", "Sociável"

  • Pergunta: "Como você prefere passar os fins de semana?"
    • "Trilhas e aventuras" -- mapeia para "Explorador"
    • "Organizando e planejando a semana seguinte" -- mapeia para "Planejador"
    • "Encontrando os amigos" -- mapeia para "Sociável"

Depois que todas as perguntas são respondidas, o resultado com a maior contagem vence. Em caso de empate, o primeiro resultado no array quizOutcomes tem precedência.

Quando Usar

  • Quizzes de personalidade ("Qual personagem é você?")
  • Correspondência de estilo ou preferência
  • Quizzes de recomendação de produtos
  • Avaliações de aptidão profissional
  • Conteúdo do tipo "Que tipo de X é você?"

Configurações de Quiz

As configurações no nível do quiz são armazenadas no campo JSON quizSettings do formulário. Essas configurações se aplicam globalmente ao formulário e controlam o comportamento do feedback.

ConfiguraçãoTipoDescriçãoModos AplicáveisPadrão
showCorrectAnswersbooleanMostra feedback de acerto/erro após o envio de cada pergunta.knowledge_quiztrue
correctFeedbackTextstringMensagem personalizada exibida quando o respondente acerta.knowledge_quiz"Correto!"
incorrectFeedbackTextstringMensagem personalizada exibida quando o respondente erra.knowledge_quiz"Incorreto!"
quizOutcomesarrayArray de definições de resultado para correspondência baseada em resultados.match_quiz[]

As configurações showCorrectAnswers, correctFeedbackText e incorrectFeedbackText são usadas apenas no modo quiz de conhecimento. Elas não têm efeito nos outros modos.

Referência de Tipos de Pergunta Pontuáveis

Os seguintes tipos de pergunta participam da pontuação em todos os modos de quiz (quiz de conhecimento, qualificação de leads e quiz de correspondência):

Tipo de PerguntaQuiz de ConhecimentoQualificação de LeadsQuiz de Correspondência
Múltipla EscolhaResposta corretaPontos por opçãoMapeamento de resultado
Menu SuspensoResposta corretaPontos por opçãoMapeamento de resultado
Escolha por ImagemResposta corretaPontos por opçãoMapeamento de resultado
Sim/NãoResposta corretaPontos por opçãoMapeamento de resultado
AvaliaçãoResposta corretaPontos por opçãoMapeamento de resultado
Escala de OpiniãoResposta corretaPontos por opçãoMapeamento de resultado

Todos os outros tipos de pergunta (texto curto, texto longo, e-mail, upload de arquivo, data etc.) não participam da pontuação, mas ainda podem ser incluídos no formulário para fins de coleta de dados.

Definindo o Modo do Formulário

O modo do formulário é configurado no painel Configurações do Formulário do construtor:

  1. Abra o formulário no construtor.
  2. Navegue até Configurações.
  3. Em Modo do Formulário, selecione um dos quatro modos.
  4. Configure as opções específicas do modo (configurações de quiz, resultados etc.) conforme necessário.
  5. Para cada pergunta pontuável, configure as propriedades de pontuação (respostas corretas, pontos por opção ou mapeamentos de resultado) no editor de perguntas.

Alterar o modo do formulário depois que as perguntas foram configuradas pode apagar os dados de pontuação específicos do modo (respostas corretas, pontos por opção ou mapeamentos de resultado). O melhor é escolher o modo do formulário antes de montar suas perguntas.

Comparando os Modos

RecursoPadrãoQuiz de ConhecimentoQualificação de LeadsQuiz de Correspondência
PontuaçãoNenhumaCerto/erradoBaseada em pontosBaseada em contagem
Configuração por perguntaNenhumacorrectAnswerpoints em cada opçãomatchOutcome em cada opção
Cálculo do resultadoNenhumPontuação, contagem de acertos, pontuação máximaTotal de pontos, final correspondenteResultado com maior contagem
Direcionamento de tela finalApenas padrãoFaixa de pontuaçãoFaixa de pontuaçãoContagem de resultados
Feedback após a respostaNãoSim (configurável)NãoNão
Ideal paraPesquisas, formuláriosTestes, quizzesPontuação de leads, avaliaçõesQuizzes de personalidade
Última atualização: 20 de julho de 2026