Como criar um app de quiz

Um app de quiz mostra perguntas, recolhe as respostas, pontua e exibe um resultado. A versão simples — um quiz fixo, pontuado no navegador — leva uma tarde. A versão em que as pessoas confiam para aprender, para contratar ou para competições precisa de um banco de perguntas, respostas guardadas no servidor, tentativas salvas e um cronometramento justo. Decida cedo qual dos dois você está construindo, porque isso muda a arquitetura.

Decida que tipo de quiz é

A palavra “quiz” cobre produtos bem diferentes:

Um quiz de personalidade sem consequências pode rodar com segurança inteiro no navegador. Uma avaliação não pode. Quizzes ao vivo exigem atualizações em tempo real, que são outro nível de complexidade — deixe-os fora da versão inicial, a menos que isso seja justamente o objetivo.

O que um app de quiz precisa

Dados

• Quizzes — título, descrição, configurações (limite de tempo, número de tentativas, embaralhar, nota de aprovação, mostrar as respostas depois?).
• Perguntas — o quiz, o texto, o tipo, os pontos, uma imagem opcional e uma explicação mostrada depois.
• Opções — as alternativas de resposta de uma pergunta, indicando quais estão corretas.
• Tentativas — quem fez qual quiz, quando começou e enviou, a pontuação.
• Respostas — qual opção (ou texto) a pessoa deu para cada pergunta de uma tentativa.

Manter tentativas e respostas separadas permite mostrar às pessoas exatamente o que erraram e identificar perguntas que quase todos erram — muitas vezes um sinal de que a pergunta está mal redigida.

Páginas

• Editor de quiz para o autor: adicionar perguntas, reordená-las, marcar a opção correta, pré-visualizar.
• Página inicial do quiz com as regras: número de perguntas, limite de tempo, tentativas.
• Tela de perguntas, uma por vez no celular, com progresso (“4 de 10”).
• Página de resultados com a pontuação, aprovado ou reprovado e o retorno por pergunta, se as configurações permitirem.
• Painel do autor com tentativas, média de pontuação e as perguntas mais difíceis.

Permissões

Autores criam e editam quizzes; quem responde apenas faz o quiz. Se os quizzes são para uma turma ou equipe, adicione grupos para que as pessoas vejam só os quizzes que lhes foram atribuídos. Veja como adicionar login ao seu app.

Regras de pontuação para deixar por escrito

A maioria dos bugs de quiz é de pontuação. Coloque estas regras no seu prompt:

1. Escolha única: pontos cheios se correta, zero caso contrário.
2. Múltipla escolha (“marque todas que se aplicam”): decida entre tudo ou nada e crédito parcial. Se for parcial, marcar alternativas erradas tira pontos? Escreva um exemplo: “Opções corretas A e C. Marcar só A pontua 1 de 2. Marcar A, B e C pontua 1 de 2.”
3. Perguntas não respondidas valem zero e aparecem como não respondidas, e não como erradas.
4. Limites de tempo são aplicados no servidor, usando o horário de início. Um cronômetro no navegador serve só para exibição — qualquer pessoa pode pausá-lo ou alterá-lo.
5. Embaralhar muda a ordem exibida, nunca qual opção está correta. Guarde a opção correta pelo ID, não pela posição.

Mantenha as respostas fora do navegador

Este é o ponto técnico que todo app de quiz sério precisa acertar. Se a página recebe as perguntas com as respostas corretas e pontua sozinha, qualquer pessoa pode abrir as ferramentas de desenvolvedor do navegador e ler o gabarito.

A solução é simples de descrever: o servidor envia as perguntas sem as marcações de correto, a pessoa envia as respostas, e o servidor pontua a tentativa e devolve o resultado. Diga isso explicitamente no seu prompt. Em um quiz de diversão não faz diferença; para qualquer coisa com certificado, nota ou prêmio, faz toda a diferença.

Um primeiro prompt que funciona

Crie um app web de quiz. Autores fazem login e criam quizzes com título, descrição, limite de tempo opcional, número de tentativas permitidas e nota de aprovação. Cada quiz tem perguntas do tipo escolha única, múltipla escolha ou verdadeiro/falso, com pontos e uma explicação opcional. Quem responde abre um quiz por link, vê as regras e depois responde uma pergunta por tela, com uma barra de progresso. As respostas corretas nunca podem ser enviadas ao navegador antes do envio — pontue as tentativas no servidor e aplique o limite de tempo a partir do horário de início registrado no servidor. Múltipla escolha é tudo ou nada. Depois do envio, mostre a pontuação, aprovado/reprovado e, se o autor permitir, cada pergunta com a resposta correta e a explicação. Salve cada tentativa e resposta em um banco de dados. Dê aos autores uma página de resultados com a média de pontuação e as perguntas mais erradas.

Etapas de construção

1. Editor primeiro. Crie um quiz com dez perguntas de tipos variados. Se escrever perguntas for trabalhoso, os autores não vão usar o app.
2. Fazer um quiz. Teste no celular. Confira o progresso, voltar e avançar, e o que acontece ao atualizar a página.
3. Pontuação no servidor. Abra a aba de rede do navegador enquanto faz o quiz e confirme que nenhuma resposta contém as respostas corretas antes do envio.
4. Testes de pontuação. Dê à IA cinco exemplos resolvidos com as pontuações esperadas, incluindo uma resposta parcialmente correta de múltipla escolha e uma pergunta não respondida.
5. Cronômetro. Inicie um quiz com tempo, espere passar do limite e então envie. Ele deve ser recusado ou pontuado como estava no prazo — decida qual.
6. Resultados e análises. Confira a lista de perguntas mais erradas contra as tentativas que você fez de propósito.
7. Extras. Só agora adicione imagens, bancos de perguntas com sorteio aleatório, certificados ou um ranking.

Erros comuns

• Gabarito na página. O erro mais comum e o mais grave.
• Confiar no relógio do navegador. Aplique os limites no servidor.
• Guardar a resposta correta como “opção 2”. Ao embaralhar, a resposta errada passa a ser marcada como correta.
• Editar um quiz depois que as pessoas já fizeram. Mudar uma pergunta muda o sentido das pontuações antigas. Bloqueie quizzes com tentativas, ou versione-os.
• Tentativas ilimitadas em uma avaliação. Defina a regra de tentativas e aplique-a no servidor.
• Rankings com o nome completo por padrão. Deixe as pessoas escolherem um nome de exibição, principalmente para estudantes.

Quando um produto pronto é a melhor escolha

Se você precisa de um jogo rápido para a sala de aula, de um quiz dentro de uma plataforma de cursos que já usa, ou de um quiz pontual para captar contatos, ferramentas de quiz e formulários prontos são mais rápidos e, muitas vezes, gratuitos. Plataformas de aprendizado já incluem quizzes com diário de notas. Veja alternativas ao Typeform e alternativas ao Google Forms para a rota de formulários.

Crie o seu quando o quiz faz parte de algo maior — um curso que você vende, um fluxo de contratação, um programa de treinamento com regras próprias — ou quando precisa de pontuação, marca ou controle de dados que as ferramentas não oferecem. Combine-o com um app de flashcards para a prática, ou coloque-o dentro de uma plataforma de cursos online.

Construindo com a Mythex

Na Mythex você descreve o app de quiz no chat e o testa na prévia ao vivo, inclusive em uma visualização do tamanho de celular. O agente adiciona um banco de dados quando você pede para salvar tentativas, e escreve a pontuação no servidor junto com o front-end. Para o login dos autores, a Mythex conecta uma abordagem de autenticação que você escolhe, em vez de um produto de login embutido. Se uma mudança quebrar a pontuação, volte a um checkpoint anterior e tente de novo. Publique em um link mythex.ai, ou em seu próprio domínio no plano Pro.

Perguntas