Documentação

Painel do administrador de formulários, ou simplesmente "Os meus formulários" — interface onde, como administrador, pode gerir formulários: criá-los, configurá-los, adicioná-los com perguntas, trabalhar com resultados, ver analítica e muito mais.
Lista dos seus convites, ou simplesmente "Os meus convites" — interface para os seus utilizadores, onde podem ver a lista de convites para responder a inquéritos, fazer testes ou exames que lhes foram dirigidos por outros administradores de formulários.

Existe ainda o Menu do utilizador, onde poderá ajustar a conta e a aplicação às suas necessidades.

Formulários

Na interface "Os meus formulários" é apresentada a lista atual dos seus formulários. Cada formulário é mostrado como um bloco que contém o título, um breve conjunto de definições e a descrição.

Ao clicar no bloco do formulário, será direcionado para a interface de trabalho desse formulário específico.

Criação e configuração

Para criar um novo formulário, aceda à interface "Os meus formulários" e clique no botão "Criar novo formulário". Em seguida, abrir-se-á o painel de configuração, onde poderá ajustar o formulário.

Estão disponíveis muitas configurações para uma personalização flexível do formulário, para lhe dar as propriedades e características necessárias, conforme as suas tarefas.

Lista completa de definições do formulário:

Título — o nome do formulário que será visível apenas para si na interface e na lista dos seus formulários. Campo obrigatório.
Descrição — descrição do formulário que será mostrada aos seus utilizadores antes de preencherem o formulário, teste ou exame. Não é obrigatório.
Localização — o idioma principal do formulário, no qual serão apresentados os elementos da interface, botões e informações auxiliares. É recomendado que o idioma do formulário, da descrição, das perguntas e das opções de resposta coincida sempre.
O idioma do formulário não tem de coincidir com o idioma selecionado na sua interface, mas por omissão será escolhido o idioma da sua interface.
Tipo de formulário — a definição principal do formulário, que determina as suas propriedades. Estão disponíveis 3 tipos de formulários:
- Questionário — o formulário mais simples e base, que o utilizador pode preencher, após o que receberá os resultados. O conjunto de funcionalidades deste tipo é limitado, porém está disponível no plano gratuito "Basic".
- Quiz — formulário mais profissional, em que pode adicionar um sistema de pontuação, respostas certas e erradas, mostrar o desempenho ao utilizador após as respostas, adicionar temporizadores, dividir perguntas por páginas, etc.
  Disponível no plano "Plus".
- Exame — formulário no qual para cada utilizador é gerado um bilhete de exame personalizado, com um sistema de balanço de dificuldade e muitas outras funcionalidades. O bilhete é gerado a partir da lista principal de perguntas, por isso, para o bom funcionamento do gerador de bilhetes, o formulário deve conter perguntas em quantidade suficiente.
  Neste tipo de formulário só podem ser usadas perguntas com opções de resposta, sem possibilidade de resposta livre, e deve existir sempre uma resposta correta.
  Disponível apenas no plano "Pro".
Acesso — definição que determina se o formulário está disponível para qualquer utilizador na Internet ou apenas para aqueles a quem, como administrador, gerar e fornecer uma ligação de convite pessoal.
- Público — o formulário está disponível para todos sem restrições. Não disponível para o tipo "Exame", uma vez que cada bilhete de exame está associado à sua Ligação de convite e destina-se apenas a um utilizador específico.
- Apenas por convite — o formulário está disponível apenas através de uma ligação de convite especial.
Dividir em páginas — definição que determina como as perguntas do formulário serão distribuídas por páginas, ou se todas ficarão numa única página.
- Desativado — a opção mais simples, todas as perguntas numa única página.
- Para várias perguntas — as perguntas podem ser distribuídas por páginas de forma arbitrária, ao critério do administrador. Não disponível para o tipo "Exame", pois não é compatível com o gerador de bilhetes.
- Uma pergunta por página — cada pergunta fica numa página individual.
Temporizador — definição que estabelece limites de tempo para preencher o formulário ou teste.
Disponível nos tipos Exame e Quiz com acesso "Apenas por convite".
- Desativado — o utilizador pode preencher sem limite de tempo.
- Global — ao utilizador é dado um tempo limitado para concluir todo o formulário, definido em "Tempo do temporizador".
- Por pergunta — é atribuído um tempo limitado para responder a cada pergunta. O tempo é definido em "Tempo do temporizador".
Tempo do temporizador — quantidade de tempo atribuída ao preenchimento do formulário ou da pergunta, conforme a definição "Temporizador". Indica-se em minutos e segundos.
Sistema de pontos — funcionalidade que ajuda o administrador a avaliar o resultado global do formulário através de um sistema flexível de atribuição de pontos por cada pergunta (funciona apenas com perguntas de escolha múltipla sem resposta livre).
Disponível nos tipos Exame e Quiz.
Sistema de dificuldade — funcionalidade que só pode ser utilizada no tipo Exame.
Se ativada, todas as perguntas serão distribuídas por níveis de dificuldade, de «muito fácil» a «muito difícil». O nível define-se individualmente para cada pergunta na definição «Nível de dificuldade».
É necessário para que a geração automática do bilhete de exame equilibre melhor a dificuldade das perguntas, evitando grandes diferenças entre bilhetes.
Por exemplo, se cada bilhete tiver 35 perguntas, pode definir que em cada bilhete existam 15 fáceis, 15 médias e 5 difíceis. Sem o sistema de dificuldade, esta proporção será aleatória.
Em combinação com o "Sistema de pontos", os pontos são atribuídos não a cada pergunta individualmente, mas por grupo de dificuldade — por exemplo: fáceis 2 pontos, médias 5, difíceis 10 — ao critério do administrador.
Mostrar resultados — funcionalidade que, após a conclusão, permite ao utilizador ver o total de pontos (se o "Sistema de pontos" estiver ativo), o número de respostas certas e erradas, bem como a percentagem de acertos.
Disponível nos tipos Exame e Quiz.
Permitir voltar — permite ao utilizador, após avançar para a página/pergunta seguinte, regressar à anterior.
Pode ser utilizada se o Temporizador estiver no modo "Global". Não pode ser utilizada se "Dividir em páginas" estiver Desativado.
Monitorização de ações — permite detetar ações indesejadas do utilizador durante o preenchimento, como fechar o separador/janela do navegador ou alternar para outra janela/separador.
Necessário para minimizar a procura de respostas noutros separadores/janelas do dispositivo.
Disponível nos tipos Exame e Quiz quando o Temporizador está ativo.
Máx. de ações permitido — valor que define o número máximo de ações indesejadas do utilizador.
Se 0, as ações indesejadas serão registadas, mas não afetarão o processo ou o resultado.
Se maior que 0, quando o utilizador atingir o número definido, o preenchimento será interrompido e os resultados anulados. Antes de começar, o utilizador será informado desta restrição.
Pode ser utilizado quando a Monitorização de ações está ativa.
Data de publicação — data diferida de publicação do formulário. Se ativado, o formulário ficará disponível na data e hora indicadas.
Data de término — data diferida de expiração do formulário. Se ativado, o formulário ficará indisponível na data e hora indicadas.

Resumo do formulário

No separador "Detalhes" do formulário é apresentado um resumo das definições, o número de perguntas, o número de resultados concluídos pelos utilizadores, o estado atual do formulário e outros dados.
Neste separador encontra-se também o botão para ativar/desativar o formulário (Publicar/Remover publicação).

Perguntas

No separador "Perguntas" do formulário é apresentada a lista de perguntas já adicionadas.
Cada pergunta é mostrada como um bloco com o título, um breve conjunto de definições e botões de Edição e Eliminação.
Se a definição "Dividir em páginas" estiver definida como Para várias perguntas, estará disponível o botão "Adicionar página" para criar páginas e distribuir perguntas entre elas.
À esquerda de cada bloco de pergunta existe uma âncora com este aspeto: ; ao clicar e manter pressionado, pode arrastar os blocos para alterar a ordem ou mover entre páginas.
Para adicionar uma nova pergunta, clique no botão "Adicionar pergunta" na parte superior. Será aberto o painel de configuração da pergunta, onde poderá ajustá-la, adicionar descrição, opções de resposta e mais.

Além da criação manual, existem também fluxos adicionais para construir o banco de perguntas:
Importação de perguntas — uma interface dedicada permite carregar perguntas a partir de um ficheiro JSON ou colar o JSON manualmente. Durante a importação, também é possível definir parâmetros partilhados, como o nível de dificuldade e os pontos, quando essas definições se aplicam ao formulário atual.
AskiumAI — o gerador de perguntas baseado em IA pode criar automaticamente um conjunto de perguntas com opções de resposta a partir de um tema, nível de dificuldade e outros parâmetros. As perguntas geradas são adicionadas ao formulário atual.

Na página Importação de perguntas existem duas ações de ajuda: "Exemplo do formato JSON esperado" e "Exemplo de prompt para gerar com IA". A segunda abre um modelo de prompt já preparado, no qual pode preencher o tema, o número de perguntas, o número de opções de resposta, a dificuldade e o idioma da geração, e depois copiá-lo para utilização num serviço externo de IA.

A importação suporta não só o carregamento de um ficheiro JSON local, mas também a colagem manual de raw JSON. Se o JSON tiver sido gerado por IA, pode colar tanto o JSON puro como o json code block completo devolvido pelo modelo. Depois de iniciada, a importação é executada como uma tarefa em segundo plano: a página mostra o estado do processamento e, após a conclusão com sucesso, abre a lista de perguntas importadas.

A interface de importação está disponível apenas para formulários do tipo Quiz e Exame e apenas nos planos Plus ou Pro. Se o formulário tiver um sistema de pontos ativo, numa importação normal pode definir manualmente um valor único de pontos partilhado; num exame com o Sistema de dificuldade ativado, os pontos das perguntas importadas são atribuídos automaticamente de acordo com o nível de dificuldade selecionado.

Configuração da pergunta

Estão disponíveis várias definições para ajustar a pergunta e determinar como o utilizador responderá e que efeito isso terá no resultado.
Note que a disponibilidade de algumas definições depende de outras, podendo ser mutuamente exclusivas.

Lista completa de definições da pergunta:

Título — o nome da pergunta visível apenas para si na interface e na lista de perguntas do formulário ou do bilhete de exame. Recomenda-se indicar de forma muito breve (2–3 palavras) o tema da pergunta. Campo obrigatório.
Descrição — a descrição da pergunta que será mostrada aos seus utilizadores no formulário, teste ou exame. É obrigatória.
Para titulares dos planos "Plus" ou "Pro" está disponível a versão avançada do editor de descrição, permitindo texto com formatação elaborada, por exemplo, alterar tamanho, cor e estilo da fonte, adicionar listas, imagens, vídeo, blocos de código com realce de sintaxe ou fórmulas matemáticas.
Pode ser ignorada — define se o utilizador pode saltar a resposta a esta pergunta e prosseguir, ou se a resposta é obrigatória.
Se no formulário "Dividir em páginas" estiver definido como "Uma pergunta por página", estará disponível o botão "Ignorar".
Tipo de resposta — definição principal da pergunta, que determina a forma de resposta. Estão disponíveis:
- Lista de opções — o utilizador deve escolher uma ou várias das opções apresentadas. Pode também permitir resposta própria ou definir quais as opções corretas e incorretas.
- Campo de entrada — o utilizador deve introduzir a resposta num campo de entrada. O tipo e as propriedades deste campo são definidos nas definições seguintes.
- Seleção de data — o utilizador deve escolher uma data num seletor.
- Intervalo — o utilizador define um valor através de um controlo deslizante horizontal. Ao mover, o valor altera-se de imediato.
- Avaliação — uma fila de símbolos (normalmente estrelas); ao clicar, o utilizador define um valor igual à posição do símbolo.
- Dados pessoais — tipo especial que recolhe dados pessoais do utilizador, como nome, apelido e email. Ajudam a orientar-se na lista de resultados e a encontrar um resultado específico.
Tipo de lista de opções — subdefinição de Lista de opções que determina quantas opções o utilizador pode escolher. Estão disponíveis 2 tipos:
- Uma opção — o utilizador pode escolher apenas uma opção.
- Várias opções — o utilizador pode escolher uma ou várias opções.
Corretude — subdefinição de Lista de opções que determina se as opções se dividem em corretas e incorretas.
Resposta própria — subdefinição de Lista de opções que define se o utilizador pode introduzir a sua própria resposta. Não disponível se a definição "Corretude" estiver ativa.
Nível de dificuldade — subdefinição de Lista de opções; se o tipo de formulário for "Exame" e o "Sistema de dificuldade" estiver ativo, define a que grupo de dificuldade pertence a pergunta atual. Obrigatório indicar.
Opções de resposta — subdefinição de Lista de opções, a lista de opções disponíveis para o utilizador selecionar na pergunta atual. Para adicionar uma nova opção, clique em "Adicionar opção" e ela será adicionada dinamicamente ao fim da lista.
Para cada opção estão disponíveis arrastar para mudar a ordem e o botão de eliminação.
Se a Corretude estiver ativa, cada opção terá a marca "Correta". Se estiver definido "Várias opções", pode haver várias corretas, mas em qualquer caso pelo menos uma.
Tipo de campo — subdefinição de Campo de entrada que determina as propriedades do campo e os tipos de dados permitidos. Estão disponíveis 5 tipos:
- Uma linha — campo de texto simples sem quebras de linha.
- Multilinha — campo de texto onde é possível quebrar linha.
- Número — campo numérico que aceita apenas números inteiros.
- Número decimal — campo numérico que aceita inteiros ou números com vírgula (decimais).
- Email — campo para introdução de email.
Tipo de dados pessoais — subdefinição de Dados pessoais que define quais dados se esperam no campo:
- Nome
- Apelido
- Email
Comprimento mín. — subdefinição de Campo de entrada para os tipos Uma linha ou Multilinha, que define o comprimento mínimo permitido da string. Deve ser um número inteiro não inferior a 0. Opcional.
Comprimento máx. — subdefinição de Campo de entrada para os tipos Uma linha ou Multilinha, que define o comprimento máximo permitido da string. Deve ser um número inteiro não inferior a 0. Opcional.
N.º de linhas por defeito — subdefinição de Campo de entrada para o tipo Multilinha, que define a altura inicial do campo em linhas. Deve ser um inteiro não inferior a 1. Opcional.
Mín. — subdefinição de Campo de entrada para os tipos Número ou Número decimal, que define o valor mínimo permitido. Deve ser um número inteiro. Opcional.
Máx. — subdefinição de Campo de entrada para os tipos Número ou Número decimal, que define o valor máximo permitido. Deve ser um número inteiro. Opcional.
Passo — subdefinição de Campo de entrada para os tipos Número ou Número decimal, que define o número ao qual o valor introduzido deve ser múltiplo. Deve ser um número inteiro. Opcional.

Particularidades do Exame

No tipo "Exame", o tipo de pergunta é sempre "Lista de opções" e não pode ser alterado. Não é possível desativar a Corretude nem ativar Resposta própria, pelo que esses controlos estarão ocultos.

Importação de perguntas

A página de importação pode ser aberta a partir da secção de perguntas do formulário atual. Está disponível apenas para formulários do tipo Quiz e Exame e apenas nos planos Plus ou Pro. Na interface, pode escolher um nível de dificuldade comum para todas as perguntas importadas e, se o formulário atual usar um sistema de pontuação fora do modo de dificuldade de exame, também definir manualmente um valor comum de pontos.

A página inclui duas ações de apoio: "Exemplo do formato JSON esperado" e "Exemplo de prompt para geração através de AI". A primeira mostra o contrato JSON exato com as chaves question_short_title, question, options e correct_index. A segunda abre um modelo de prompt pronto a usar, onde pode preencher o tema, o número de perguntas, o número de opções de resposta, a dificuldade e o idioma, e depois copiá-lo para utilização num serviço AI externo.

Exemplo de JSON

{
  "questions": [
    {
      "question_short_title": "HTTP status codes",
      "question": "Which status code means that the request was successful?",
      "options": [
        "200 OK",
        "301 Moved Permanently",
        "404 Not Found",
        "500 Internal Server Error"
      ],
      "correct_index": 0
    }
  ]
}

As perguntas podem ser importadas de duas formas: carregando um ficheiro JSON local ou colando manualmente o raw JSON de origem. Se o conteúdo tiver sido gerado por um modelo AI, a página também aceita o json code block completo da resposta. Após o envio, a importação é executada como uma tarefa em segundo plano: a página verifica automaticamente o estado da tarefa e, quando esta termina com sucesso, abre a lista de perguntas importadas para revisão e edição adicional.

Se o formulário for um exame com o Sistema de dificuldade ativado, os pontos das perguntas importadas são atribuídos automaticamente de acordo com o nível de dificuldade selecionado. Assim, o mesmo fluxo de importação permanece compatível tanto com quizzes pontuados manualmente como com exames equilibrados por dificuldade.

AskiumAI: gerador de perguntas

AskiumAI é uma página separada para gerar perguntas diretamente dentro do formulário atual. A interface mostra o seu saldo atual de tokens AI e ajuda a preencher o banco de perguntas sem sair da aplicação. A geração de perguntas está disponível apenas para formulários do tipo Quiz e Exame; para outros tipos de formulário, a interface mostra um aviso e não permite iniciar a tarefa.

Na página do gerador, define a área / tema, a dificuldade, o número de perguntas e o número de opções de resposta. Se o formulário usar um sistema de pontuação fora do modo de dificuldade de exame, também pode indicar os pontos por uma resposta correta. O idioma das perguntas geradas segue a localização configurada para o próprio formulário, e não o idioma atual da interface.

Depois do envio, o AskiumAI primeiro verifica o tema e depois executa a geração como uma tarefa em segundo plano. A página mostra estados intermédios, consulta automaticamente o estado da tarefa e, após o sucesso, abre a lista de perguntas geradas. As perguntas e opções de resposta geradas devem ser sempre revistas manualmente antes da publicação, porque a AI ainda pode cometer erros.

Quando a geração estiver concluída, as perguntas resultantes podem ser revistas, editadas, removidas parcialmente ou mantidas de forma seletiva antes de continuar a trabalhar com o formulário.

Definições de dificuldade

Se o tipo de formulário for "Exame" e o "Sistema de dificuldade" estiver ativo, ficará disponível o separador "Definições de dificuldade".
Neste separador pode ajustar a dificuldade média do bilhete de exame.
Para tal, indique quantas perguntas de cada dificuldade existirão em cada bilhete. Existem 5 níveis:

Muito fácil
Fácil
Médio
Difícil
Muito difícil

Durante a geração automática dos bilhetes, será usado o número indicado de perguntas de determinada dificuldade, mas em ordem aleatória. Assim, o nível global de dificuldade dos bilhetes ficará equilibrado, mantendo-se a unicidade de cada conjunto de perguntas.

Escolhe quais níveis usar; não é obrigatório utilizar todo o intervalo. Normalmente usam-se 2–3 níveis, por exemplo de Fácil a Difícil.

Além disso, se o "Sistema de pontos" estiver ativo, neste separador pode indicar quantos pontos correspondem a cada nível de dificuldade, pois com a combinação "Sistema de pontos" + "Sistema de dificuldade" já não se atribuem pontos por pergunta, mas apenas aqui por nível.

Ligações de convite

Este separador fica disponível se na configuração do formulário estiver ativa a função "Acesso — Apenas por convite".

No separador "Ligações de convite" é apresentada por omissão a lista atual de ligações ativas.
Cada ligação é mostrada como um bloco com informação geral:

URL completo da ligação
Nome e apelido do utilizador convidado, se indicados
Endereço de E-mail do utilizador convidado, se indicado
Número de perguntas no bilhete de exame, se o tipo for Exame

Em cada bloco há também um comutador para ativar/desativar a ligação e um conjunto de botões:

Botão de envio do convite por email, se o endereço estiver indicado; indisponível se a ligação já foi enviada, usada ou desativada;
Botão de copiar o URL para a área de transferência; indisponível se a ligação estiver desativada;
Botão "Partilhar" para enviar a ligação para redes sociais, mensageiros, email, etc.; indisponível se a ligação já foi usada ou desativada;
Botão para gerar QR code da ligação; indisponível se a ligação estiver desativada;
Botão de edição da ligação; indisponível se a ligação já foi usada;
Botão de eliminação da ligação; indisponível se a ligação já foi usada;
Botão para ir aos resultados do utilizador; disponível apenas após a ligação ter sido utilizada;

Ao clicar no bloco da ligação de convite, entra na interface de trabalho dessa ligação específica.

Para adicionar uma nova ligação de convite, clique em "Adicionar" e será direcionado para a criação da nova ligação.

Criação de uma ligação de convite

Ao criar uma nova ligação de convite, estão disponíveis os seguintes campos:

Nome
Apelido
Email

Nenhum destes campos é obrigatório; podem ficar vazios. No entanto, para facilitar a identificação dos resultados mais tarde, recomenda-se adicionar estas informações; caso contrário, a identificação pode ser difícil.

No momento da criação, é atribuído a cada ligação de convite um chave única, que é anexada ao URL da própria ligação. Se a ligação permanecer anónima (sem nome, apelido e email), o único identificador será a chave única.

Se os seus utilizadores (clientes/colaboradores/estudantes/...) forem recorrentes, pode guardar os seus dados na lista de contactos com o botão "Guardar contacto", bem como importá-los clicando em "Importar" e escolhendo o contacto.

Se o tipo for "Exame", após criar a ligação será imediatamente direcionado para o seu ecrã de trabalho para preencher o bilhete de exame com perguntas, pois inicialmente estará vazio.

Edição da ligação de convite

Em geral, a interface de edição é semelhante à de criação, mas adiciona-se o comutador de estado (ativada/desativada) e é mostrada a chave única.

Bilhete de exame

Se o tipo de formulário for "Exame", na interface de edição da ligação de convite estará disponível uma segunda parte destinada a trabalhar com o bilhete de exame e a preenchê-lo com perguntas.
Pode preencher o bilhete de duas formas:

Clicando em "Gerar bilhete" — o bilhete será preenchido de imediato com base nas definições de dificuldade (se o "Sistema de dificuldade" estiver ativo, as definições estiverem preenchidas e o formulário tiver perguntas suficientes para cada nível).
Preenchendo manualmente, clicando em "Adicionar pergunta" e escolhendo as perguntas necessárias da lista (pode selecionar várias de uma vez).

Num bilhete já preenchido, pode alterar a ordem das perguntas arrastando pela âncora e pode eliminá-las clicando no botão de eliminação.

No tipo "Exame", não é possível ativar uma ligação de convite cujo bilhete não tenha perguntas adicionadas.

Lista de contactos

Este separador fica disponível se na configuração do formulário estiver ativa a função "Acesso — Apenas por convite".

Aqui é apresentada a lista de contactos dos seus utilizadores (clientes/colaboradores/estudantes/...). Esta lista serve para que, posteriormente, possa importar os dados (nome, apelido e email) para as ligações de convite, facilitando a sua criação.

Para adicionar um novo contacto, clique em "Adicionar" e será direcionado para o ecrã de criação de um novo contacto.

Cada contacto tem 3 campos:

Nome
Apelido
Email

Para guardar um contacto, é necessário preencher todos os campos. Note também que o Email na sua lista de contactos não pode repetir-se.

Resultados

Neste separador é apresentada a lista de resultados do preenchimento do formulário pelos utilizadores. Cada resultado é mostrado como um bloco com informação breve:

Chave — chave única de cada resultado;
Estado do resultado: Em curso ou Concluído;
Data e hora da conclusão do formulário;
Nome e apelido do utilizador, se no formulário estiver "Apenas por convite" e a ligação tiver nome/apelido indicados;
Email do utilizador, se "Apenas por convite" e o email estiver indicado na ligação;
Pontos obtidos pelo utilizador neste resultado, se o "Sistema de pontos" estiver ativo;
Percentagem % de respostas corretas, se o tipo for Quiz ou Exame;

Ao clicar no bloco do resultado, abrirá a página com a informação detalhada deste resultado:

Resumo geral;
Registo de ações indesejadas (se a "Monitorização de ações" estava ativa);
lista completa de respostas às perguntas do formulário, com indicação de correção, quando aplicável;

Analítica

No separador Analítica é apresentado um resumo geral de todos os resultados desde a criação do formulário.

Estão disponíveis as seguintes informações:

Gráficos de preenchimento — mostram a dinâmica de preenchimento pelos utilizadores:
- Gráfico diário — número de preenchimentos por dia nos últimos 30 dias.
- Gráfico mensal — número de preenchimentos por mês nos últimos 12 meses.
Estatísticas de resultados — dados estatísticos agregados de todo o período:
- Total de resultados
- Total de pontos no formulário
- Média de pontos obtidos
- Máximo de pontos obtidos
- Mínimo de pontos obtidos
- Média da percentagem de acertos
- Percentagem máxima de acertos
- Percentagem mínima de acertos
Estatísticas das perguntas — dados estatísticos por cada pergunta individualmente.
Para perguntas com opções:
- Número e percentagem relativa de omissões;
- Número e percentagem relativa de respostas corretas;
- Tabela comparativa por cada opção de resposta;
- Gráfico comparativo por cada opção de resposta;
Para perguntas com campo numérico:
- Número e percentagem relativa de omissões;
- Valor médio da resposta;
- Valor máximo da resposta;
- Valor mínimo da resposta;
Para perguntas com campo de texto ou data: a lista completa de respostas.

A analítica também pode ser exportada para PDF e Excel. A exportação é preparada em segundo plano e, depois disso, o ficheiro gerado fica disponível para download.

Neste separador pode configurar o estilo visual do formulário em modo de pré-visualização em tempo real. Para além das cores e fontes básicas, a secção de branding inclui agora também definições da barra de progresso e trabalho com predefinições de branding.

Cor de fundo da página, cor do texto e fonte principal
Fundo do cabeçalho, título, fonte do título, logótipo e possibilidade de ocultar totalmente o cabeçalho
Cor de fundo da barra de progresso, cor do progresso e altura da barra
Cores dos botões, cores ao passar o cursor, fonte do texto dos botões, padding e forma dos botões
Estilo do bloco do título da página, cores do temporizador, estilos das opções de resposta e ícones do resultado

Se o formulário utilizar uma barra de progresso, pode ajustar aqui o seu aspeto. Se não quiser mostrá-la de todo, pode desativá-la completamente nas definições principais do formulário.

Também pode guardar o estilo atual como uma predefinição de branding e depois carregar uma predefinição existente noutro formulário. Isto é útil quando pretende reutilizar o mesmo estilo visual em vários formulários.

Todas as alterações de branding são mostradas de imediato na pré-visualização em tempo real.

Integrações com serviços externos

No Askium existem atualmente dois cenários principais de integração: webhooks de resultados e integrações LMS / LTI.

Webhooks de resultados

No separador de integrações do formulário pode ativar o envio automático de dados sobre um resultado concluído para um sistema externo. O envio acontece depois de o utilizador terminar o formulário.

Esta funcionalidade configura-se no separador dedicado Webhooks e está disponível nos planos pagos acima de Basic.

Nas definições do webhook estão disponíveis os seguintes campos:

Status — ativar ou desativar o envio;
URL address — endereço completo do endpoint para o qual o Askium enviará os dados;
Format — formato do payload: JSON ou XML;
Authorization — se deve ser adicionada uma header de autorização;
Header — nome da header, por exemplo Authorization ou X-Webhook-Token;
Value — valor da header ou do token que será enviado com o pedido.

O payload pode incluir blocos form, result, score, user e answers. Se a pergunta utilizar o editor HTML avançado, o texto da pergunta é enviado no campo advanced_html.

Exemplo de webhook JSON

{
  "form": {
    "id": "quiz-http-001",
    "title": "HTTP Basics"
  },
  "result": {
    "id": "res-8f2d1a",
    "completed_at": "2026-04-11T09:15:00Z"
  },
  "score": {
    "points": 8,
    "max_points": 10,
    "correct_answers": 4,
    "total_questions": 5
  },
  "user": {
    "link_id": "link-abc123",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "answers": [
    {
      "question": {
        "id": "q-http-001",
        "title": "HTTP code",
        "advanced_html": "<p>Which status code means success?</p>"
      },
      "answer_text": "200 OK",
      "correct": true
    }
  ]
}

Exemplo de webhook XML

<result>
  <form>
    <id>quiz-http-001</id>
    <title>HTTP Basics</title>
  </form>
  <result_meta>
    <id>res-8f2d1a</id>
    <completed_at>2026-04-11T09:15:00Z</completed_at>
  </result_meta>
  <score>
    <points>8</points>
    <max_points>10</max_points>
    <correct_answers>4</correct_answers>
    <total_questions>5</total_questions>
  </score>
  <user>
    <link_id>link-abc123</link_id>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <email>john.doe@example.com</email>
  </user>
  <answers>
    <answer>
      <question>
        <id>q-http-001</id>
        <title>HTTP code</title>
        <text>Which status code means success?</text>
      </question>
      <answer_text>200 OK</answer_text>
      <correct>true</correct>
    </answer>
  </answers>
</result>

Integrações LMS / LTI

O processo LMS / LTI é composto por duas etapas separadas: primeiro cria-se uma integração LMS partilhada no menu do utilizador e depois o formulário específico é associado a uma integração existente através do ecrã de ligações de integração.

Ou seja, a integração não é criada “dentro do formulário”. É configurada uma vez e depois pode ser reutilizada em vários formulários.

Para LTI 1.0 / 1.1 são preenchidos OAuth Consumer Key e OAuth Shared Key;
Para LTI 1.3 são preenchidos Platform ID / iss, Client ID, OIDC login initiation URL, Access token URL e JWKS endpoint URL.

O ecrã de ligações está disponível para Quiz e Exame, não para Questionário, e requer um plano acima de Basic.

API

A aplicação inclui uma secção dedicada às definições da API, pensada para trabalhar de forma segura com sistemas externos e automações através de uma chave API privada.

ativar e desativar o acesso à API;
gerar uma nova chave API privada;
copiar a chave atual;
ativar uma restrição adicional por IP;
indicar o único endereço IP permitido.

Regras básicas da API

Base URL: https://askium.org/api
Authorization: Authorization: Bearer YOUR_PRIVATE_API_KEY
Content-Type: application/json
Se a restrição por IP estiver ativa, os pedidos só serão aceites a partir do endereço permitido
POST /api/results/verify é uma rota pública e não exige chave API privada

Rotas disponíveis

POST /api/forms/{form_key}/invitation-links
DELETE /api/forms/{form_key}/invitation-links/{link_key}
GET /api/forms/{form_key}/invitation-links/active
POST /api/forms/{form_key}/questions/import
POST /api/results/{result_key}/verification-key
POST /api/results/verify

POST/api/forms/{form_key}/invitation-links

Cria uma ligação de convite personalizada. Para formulários do tipo Exame, o sistema gera automaticamente também o ticket.

curl -X POST "https://askium.org/api/forms/exam-api-001/invitation-links" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  }'