Finais Condicionais

Finais condicionais permitem mostrar telas finais diferentes aos respondentes com base na pontuação do questionário. Em vez de uma única tela de "Thank you!", você pode exibir resultados personalizados --- por exemplo, mostrando "Especialista!" para quem pontua alto e "Continue aprendendo!" para quem pontua baixo.

Como Funciona a Pontuação do Questionário

O NueForm suporta três modos de questionário, cada um com seu próprio mecanismo de pontuação:

Definindo o Modo do Formulário

1. Abra seu formulário no construtor do NueForm.
2. Abra as configurações do formulário (ícone de engrenagem).
3. Em Form Mode, selecione um dos modos de questionário.

Como alternativa, use a API:

curl -X PATCH https://app.nueform.com/api/v1/forms/FORM_ID \
  -H "Authorization: Bearer nf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "knowledge_quiz" }'

Configurando Várias Telas Finais

Cada tela final em um formulário em modo questionário pode ter um intervalo de pontuação que determina quando ela é mostrada. O NueForm avalia as telas finais em ordem e mostra a primeira cujo intervalo de pontuação contém a pontuação do respondente.

Etapa 1: Criar as Telas Finais

Adicione várias perguntas end_screen ao seu formulário. Cada uma representa uma página de resultado diferente.

1. No construtor de formulários, clique em + e selecione End Screen na categoria Layout.
2. Defina o título e a descrição deste final (por exemplo, "Nível Especialista --- Parabéns!").
3. Repita para cada final distinto que você quiser criar.

Etapa 2: Atribuir os Intervalos de Pontuação

Para os modos Questionário de Conhecimento e Qualificação de Leads, cada tela final precisa de um intervalo de pontuação:

1. Selecione uma pergunta de tela final.
2. No painel de propriedades da pergunta, defina o Score Range:
   • Min Score --- A pontuação mínima para mostrar este final (inclusiva).
   • Max Score --- A pontuação máxima para mostrar este final (inclusiva).

Exemplo: Questionário de Conhecimento com 10 Perguntas (1 Ponto Cada)

Etapa 3: Configurar as Perguntas Pontuáveis

Questionário de Conhecimento

Para cada pergunta que você quer pontuar:

1. Selecione a pergunta no construtor.
2. No painel de propriedades, marque a(s) resposta(s) correta(s). Isso está disponível para estes tipos de pergunta: multiple_choice, dropdown, yes_no, opinion_scale, rating e legal.
3. Opcionalmente, defina um valor de pontos personalizado (o padrão é 1 ponto por resposta correta).

Qualificação de Leads

Para cada pergunta que você quer pontuar:

1. Selecione a pergunta.
2. No painel de propriedades, atribua um valor de pontos a cada opção. Por exemplo, em um menu suspenso "Tamanho da Empresa":
   • "1-10 funcionários" = 1 ponto
   • "11-50 funcionários" = 3 pontos
   • "51-200 funcionários" = 5 pontos
   • "200+ funcionários" = 10 pontos

A pontuação total do respondente é a soma dos pontos de todas as opções selecionadas.

Finais do Questionário de Compatibilidade

Questionários de compatibilidade funcionam de forma diferente dos questionários baseados em pontuação. Em vez de intervalos numéricos de pontuação, cada opção é mapeada para um ou mais finais de resultado. O final com mais "votos" das opções do respondente vence.

Como Funciona a Pontuação de Compatibilidade

1. As opções de cada pergunta são mapeadas para uma ou mais telas finais.
2. Quando um respondente seleciona uma opção, cada tela final associada recebe um ponto de contagem.
3. Depois que todas as perguntas são respondidas, a tela final com a maior contagem é mostrada.
4. Empates são resolvidos pela ordem (a primeira tela final vence).

Configurando um Questionário de Compatibilidade

1. Defina o modo do formulário como Questionário de Compatibilidade.
2. Adicione várias perguntas End Screen --- cada uma representa um resultado (por exemplo, tipos de personalidade, recomendações de produtos).
3. Para cada pergunta pontuável, abra as propriedades e mapeie cada opção para os finais relevantes:
   • A opção "Prefiro manhãs" mapeia para a tela final "Madrugador"
   • A opção "Prefiro noites" mapeia para a tela final "Coruja Noturna"

Exemplo: "Que Tipo de Viajante Você É?"

Telas Finais:

• Caçador de Aventuras
• Explorador de Culturas
• Especialista em Relaxamento

Pergunta: "Escolha sua atividade de férias ideal"

Depois de todas as perguntas, o final com a maior contagem determina o resultado.

Configurações do Questionário (Questionário de Conhecimento)

Questionários de conhecimento têm configurações adicionais de feedback:

Configure-as nas configurações do formulário, em Quiz Settings:

{
  "quizSettings": {
    "showCorrectAnswers": true,
    "correctFeedbackText": "That's right!",
    "incorrectFeedbackText": "Not quite. Try again next time!"
  }
}

Como Funciona a Seleção da Tela Final

Quando uma resposta é enviada, o NueForm calcula os resultados do questionário no servidor:

1. Questionário de Conhecimento: Conta as respostas corretas e soma os valores de pontos. Escolhe a primeira tela final cujo scoreRange contém a pontuação total.
2. Qualificação de Leads: Soma os valores de pontos das opções selecionadas. Escolhe a primeira tela final cujo scoreRange contém a pontuação total.
3. Questionário de Compatibilidade: Conta quantas vezes cada tela final foi "votada" pelas opções do respondente. Escolhe a tela final com a maior contagem (empates resolvidos pela ordem).

Se nenhuma tela final corresponder à pontuação calculada, a primeira tela final do formulário é usada como fallback.

Os resultados calculados são armazenados no campo quizResults da resposta:

{
  "formMode": "knowledge_quiz",
  "score": 7,
  "correctAnswers": 7,
  "totalScorableQuestions": 10,
  "maxScore": 10,
  "matchedEndingId": "507f1f77bcf86cd799439099"
}

Testando Finais Condicionais

1. Publique seu formulário de questionário.
2. Envie respostas com diferentes padrões de resposta para acionar cada tela final.
3. Verifique no painel Responses se quizResults contém a pontuação esperada e o matchedEndingId.
4. Confirme que cada respondente vê a tela final correta.

Boas Práticas

1. Cubra todos os intervalos de pontuação. Garanta que toda pontuação possível seja mapeada para uma tela final. Use 0 como o mínimo do seu intervalo mais baixo e a pontuação máxima possível como o máximo do seu intervalo mais alto.

2. Mantenha o feedback encorajador. Mesmo para pontuações baixas, use uma linguagem positiva e construtiva nas descrições das suas telas finais.

3. Use o fallback com sabedoria. A primeira tela final do seu formulário é o fallback padrão. Faça dela uma mensagem genérica e segura para o caso de os intervalos de pontuação estarem mal configurados.

4. Limite o número de finais. De três a cinco finais distintos geralmente oferecem personalização suficiente sem ficar difícil de gerenciar.

5. Teste os casos extremos. Envie respostas que pontuem exatamente no limite entre dois intervalos para verificar se o final correto é selecionado.

Relacionado

• Modos de Formulário --- Referência detalhada de todos os modos de questionário
• Payloads de Webhook --- Como os resultados do questionário aparecem nos dados do webhook
• Referência da API: Respostas --- Acessando os resultados do questionário via API