Como Criar uma App de Questionários

Uma app de questionários mostra perguntas, recolhe respostas, pontua-as e apresenta um resultado. A versão simples — um questionário fixo, pontuado no browser — leva uma tarde a fazer. A versão em que as pessoas confiam para aprender, recrutar ou competir precisa de um banco de perguntas, de respostas guardadas no servidor, de tentativas registadas e de um tempo justo. Decida cedo qual das duas está a construir, porque isso muda a arquitetura.

Decida que tipo de questionário é

A palavra «questionário» abrange produtos muito diferentes:

Um questionário de personalidade sem consequências pode correr com segurança inteiramente no browser. Uma avaliação não pode. Os questionários ao vivo precisam de atualizações em tempo real, que são um nível de complexidade à parte — deixe-os de fora da versão um, a não ser que isso seja precisamente o objetivo.

O que precisa uma app de questionários

Dados

• Questionários — título, descrição, definições (limite de tempo, número de tentativas permitidas, baralhar, nota de aprovação, mostrar respostas no fim?).
• Perguntas — o questionário a que pertencem, o texto, o tipo, os pontos, uma imagem opcional e uma explicação mostrada depois.
• Opções — as escolhas de resposta de uma pergunta, indicando quais estão corretas.
• Tentativas — quem fez qual questionário, quando começou e submeteu, a pontuação.
• Respostas — a opção (ou texto) que a pessoa deu a cada pergunta numa tentativa.

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

Páginas

• Editor de questionários para o autor: acrescentar perguntas, reordená-las, marcar a opção correta, pré-visualizar.
• Página inicial do questionário com as regras: número de perguntas, limite de tempo, tentativas.
• Ecrã da pergunta, uma pergunta de cada vez nos telemóveis, com progresso («4 de 10»).
• Página de resultados com a pontuação, aprovado ou reprovado, e feedback por pergunta se as definições o permitirem.
• Painel do autor com as tentativas, a pontuação média e as perguntas mais difíceis.

Permissões

Os autores criam e editam questionários; quem responde apenas os realiza. Se os questionários forem para uma turma ou uma equipa, acrescente grupos para que cada pessoa veja apenas os questionários que lhe foram atribuídos. Veja como adicionar login à sua app.

Regras de pontuação para escrever

A maioria dos erros em questionários são erros de pontuação. Inclua estas regras no seu prompt:

1. Escolha única: pontuação total se estiver correta, zero caso contrário.
2. Escolha múltipla («selecione todas as que se apliquem»): decida entre tudo ou nada e crédito parcial. Se for parcial, as escolhas erradas descontam pontos? Escreva um exemplo: «Opções corretas A e C. Escolher só A dá 1 de 2. Escolher A, B e C dá 1 de 2.»
3. Perguntas sem resposta valem zero e são mostradas como não respondidas, não como erradas.
4. Os limites de tempo são aplicados no servidor com base na hora de início. Um temporizador no browser é apenas visual — qualquer pessoa o pode pausar ou alterar.
5. Baralhar muda a ordem apresentada, nunca a opção correta. Guarde a opção correta pelo seu ID, não pela posição.

Mantenha as respostas fora do browser

Este é o ponto técnico que qualquer app de questionários séria tem de acertar. Se a página receber as perguntas com as respostas corretas e as pontuar ela própria, qualquer pessoa pode abrir as ferramentas de programador do browser e ler o gabarito.

A correção é simples de descrever: o servidor envia as perguntas sem as marcas de correção, a pessoa submete, e o servidor pontua a tentativa e devolve o resultado. Diga isto explicitamente no seu prompt. Para um questionário divertido não tem importância; para qualquer coisa com certificado, nota ou prémio, tem.

Um primeiro prompt que funciona

Crie uma app web de questionários. Os autores iniciam sessão e criam questionários com título, descrição, limite de tempo opcional, número de tentativas permitidas e nota de aprovação. Cada questionário tem perguntas de tipo escolha única, escolha múltipla ou verdadeiro/falso, com pontos e uma explicação opcional. Quem responde abre um questionário por ligação, vê as regras e depois responde a uma pergunta por ecrã com uma barra de progresso. As respostas corretas nunca podem ser enviadas para o browser antes da submissão — pontue as tentativas no servidor e aplique o limite de tempo a partir da hora de início guardada no servidor. A escolha múltipla é tudo ou nada. Depois de submeter, mostre a pontuação, aprovado/reprovado e, se o autor o permitir, cada pergunta com a resposta correta e a explicação. Guarde todas as tentativas e respostas numa base de dados. Dê aos autores uma página de resultados com a pontuação média e as perguntas mais falhadas.

Passos de construção

1. Primeiro o editor. Crie um questionário com dez perguntas de tipos variados. Se escrever perguntas for penoso, os autores não usarão a app.
2. Responder a um questionário. Experimente num telemóvel. Verifique o progresso, avançar e recuar, e o que acontece ao atualizar a página.
3. Pontuação no servidor. Abra o separador de rede das ferramentas de programador enquanto responde ao questionário e confirme que nenhuma resposta contém as respostas corretas antes de submeter.
4. Testes de pontuação. Dê à IA cinco exemplos resolvidos com as pontuações esperadas, incluindo uma resposta parcialmente correta de escolha múltipla e uma pergunta sem resposta.
5. Temporizador. Inicie um questionário com tempo, espere passar o limite e depois submeta. Deve ser rejeitado ou pontuado tal como estava no prazo — decida qual.
6. Resultados e análise. Verifique a lista das perguntas mais falhadas contra as tentativas que fez de propósito.
7. Extras. Só agora acrescente imagens, bancos de perguntas com seleção aleatória, certificados ou uma tabela de classificação.

Erros comuns

• Gabarito na página. O defeito mais comum e mais grave.
• Confiar no relógio do browser. Aplique os limites no servidor.
• Guardar a resposta correta como «opção 2». Ao baralhar, a resposta errada passa a estar marcada como correta.
• Editar um questionário depois de as pessoas o terem feito. Alterar uma pergunta altera o significado das pontuações antigas. Bloqueie os questionários com tentativas, ou crie versões.
• Tentativas ilimitadas numa avaliação. Defina a regra de tentativas e aplique-a no servidor.
• Tabelas de classificação com nomes completos por defeito. Deixe as pessoas escolher um nome de apresentação, sobretudo os estudantes.

Quando um produto pronto é a melhor escolha

Se precisa de um jogo rápido para a sala de aula, de um questionário dentro de uma plataforma de cursos que já usa, ou de um questionário pontual para captar contactos, as ferramentas de questionários e formulários existentes são mais rápidas e muitas vezes gratuitas. As plataformas de gestão de aprendizagem já incluem questionários com pautas. Veja as alternativas ao Typeform e as alternativas ao Google Forms para o caminho dos formulários.

Construa o seu próprio quando o questionário faz parte de algo maior — um curso que vende, um processo de recrutamento, um programa de formação com regras próprias — ou quando precisa de pontuação, identidade visual ou controlo dos dados que as ferramentas não oferecem. Pode combiná-lo com uma app de cartões de estudo para praticar, ou colocá-lo dentro de uma plataforma de cursos online.

Construir com a Mythex

Na Mythex descreve a app de questionários no chat e experimenta-a na pré-visualização em direto, incluindo a vista de tamanho de telemóvel. O agente acrescenta uma base de dados quando pede para guardar tentativas, e escreve a pontuação no servidor juntamente com o front end. Para os logins dos autores, a Mythex liga a abordagem de autenticação que escolher, em vez de um produto de início de sessão incorporado. Se uma alteração estragar a pontuação, volte a um ponto de controlo anterior e tente de novo. Publique numa ligação mythex.ai, ou no seu próprio domínio no plano Pro.

Perguntas