Tipos de Pergunta de Escolha

Múltipla Escolha

Apresente uma lista de opções para o respondente escolher. Suporta seleção única, seleção múltipla, texto livre em "Outro", randomização e ordenação alfabética. Cada opção pode ter a sua própria imagem, vídeo ou ícone, e a propriedade layout alterna entre uma lista vertical e uma grade de cartões com imagem — então esse único tipo cobre tanto opções de texto simples quanto opções baseadas em imagem.

Identificador de tipo: multiple_choice

Propriedades

Objeto de Opção

Cada opção no array choices tem:

Mídia da Opção

Qualquer opção pode ter a sua própria mídia. O media.display decide como ela fica na opção:

A mídia da opção suporta os mesmos tratamentos da mídia da pergunta — filtros, tonalidade, bordas, ponto focal e zoom. Veja Exibição de Mídia da Opção para entender como Preencher e Ajustar diferem e quando usar cada um.

Validação

Se required for true, o respondente deve selecionar pelo menos uma opção antes de prosseguir.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Ao usar equals ou not_equals, o valor de comparação é o ID da opção. Para perguntas de seleção múltipla, equals verifica se o valor está entre os itens selecionados.

Formato da Resposta

• Seleção única (allowMultiple: false): Uma string (o ID da opção selecionada).
• Seleção múltipla (allowMultiple: true): Um array de strings (os IDs das opções selecionadas).

Pontuação em Modo Quiz

Múltipla Escolha é um tipo de pergunta pontuável em todos os modos de quiz:

• Quiz de Conhecimento: Defina correctAnswers (array de IDs das opções corretas) e correctAnswerScore (pontos por resposta correta).
• Qualificação de Leads: Defina choiceScores (mapeamento de ID de opção para valor de pontos).
• Quiz de Correspondência: Defina choiceOutcomes (mapeamento de ID de opção para IDs de perguntas de tela final).

Menu Suspenso

Um menu suspenso para selecionar a partir de uma lista de opções. Suporta a mesma configuração da Múltipla Escolha, mas exibe as opções em um formato compacto de menu suspenso. O media por opção e o layout não se aplicam aqui — um menu suspenso sempre renderiza suas opções como texto simples.

Identificador de tipo: dropdown

Propriedades

Validação

Se required for true, o respondente deve selecionar pelo menos uma opção.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

• Seleção única: Uma string (o ID da opção selecionada).
• Seleção múltipla: Um array de strings (os IDs das opções selecionadas).

Pontuação em Modo Quiz

Menu Suspenso é um tipo de pergunta pontuável. A configuração de pontuação é idêntica à da Múltipla Escolha.

Escolha por Imagem

Para montar a mesma coisa, use uma pergunta de Múltipla Escolha com layout definido como blocks e um objeto media em cada opção. Tudo o que a Escolha por Imagem fazia continua disponível, além dos tratamentos que ela nunca teve: opções em vídeo e ícone, filtros, tonalidade, ponto focal, zoom e um modo Ajustar que mostra imagens largas inteiras em vez de recortá-las.

{
  "type": "multiple_choice",
  "properties": {
    "layout": "blocks",
    "choices": [
      { "id": "c1", "label": "Mountains", "media": { "type": "image", "url": "https://…", "display": "background" } },
      { "id": "c2", "label": "Coast", "media": { "type": "image", "url": "https://…", "display": "background" } }
    ]
  }
}

Formulários existentes e importações do Typeform são tratados automaticamente — uma pergunta picture_choice é convertida em Múltipla Escolha com layout: "blocks", então nada precisa ser reescrito.

Sim / Não

Uma pergunta binária simples que apresenta os botões "Sim" e "Não".

Identificador de tipo: yes_no

Propriedades

O tipo de pergunta Sim/Não não tem propriedades adicionais além das propriedades comuns de pergunta.

Validação

Se required for true, o respondente deve clicar em "Sim" ou "Não".

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Ao usar equals, compare com true (Sim) ou false (Não). Os valores em string "true" e "false" também são aceitos.

Formato da Resposta

A resposta é armazenada como um booleano (true para Sim, false para Não, ou null se não respondida).

Pontuação em Modo Quiz

Sim/Não é um tipo de pergunta pontuável:

• Quiz de Conhecimento: Defina correctAnswers com um único valor "true" ou "false".
• Qualificação de Leads: Defina choiceScores com as chaves "true" e "false".
• Quiz de Correspondência: Defina choiceOutcomes com as chaves "true" e "false".

Classificação

Apresente uma lista de itens para o respondente organizar na ordem de preferência dele, arrastando e soltando.

Identificador de tipo: ranking

Propriedades

Validação

Se required for true, o respondente deve enviar uma classificação (todos os itens devem estar em uma ordem definida).

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um array de strings (IDs das opções na ordem de classificação do respondente, do primeiro ao último).

["choice_3", "choice_1", "choice_2"]

Matriz

Um tipo de pergunta em grade, em que os respondentes avaliam vários itens (linhas) em várias categorias (colunas). Cada interseção de linha e coluna é uma opção selecionável.

Identificador de tipo: matrix

Propriedades

Validação

Se required for true, o respondente deve selecionar uma opção por linha.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um objeto (Record<string, string>) que mapeia cada rótulo de linha para o rótulo de coluna selecionado:

{
  "Product Quality": "Excellent",
  "Customer Service": "Good",
  "Value for Money": "Average"
}

Lista

Colete várias entradas do mesmo tipo. Uma Lista contém itens de texto simples (digite e pressione Enter, ou toque em Adicionar) ou itens de composite repetidos — entradas estruturadas construídas a partir de um composite reutilizável, como adicionar qualquer número de membros de conselho em uma única pergunta.

Identificador de tipo: list

Propriedades

Validação

Se required for true, pelo menos um item deve ser adicionado. minItems / maxItems são aplicados no envio; as regras de padrão e comprimento por item (itens de texto) são aplicadas conforme cada item é adicionado.

Operadores de Salto de Lógica

list_count_equals, list_count_greater_than, list_count_less_than, contains, not_contains, is_answered, is_not_answered

Os operadores de contagem comparam com o número de itens na resposta.

Formato da Resposta

• Itens de texto: um array de strings.
• Itens de composite: um array de objetos, cada um indexado pelo ID do subcampo:

[
  { "sub_first_name": "Ada", "sub_email": "ada@example.com" },
  { "sub_first_name": "Grace", "sub_email": "grace@example.com" }
]

Cada item de composite também é registrado como uma entrada de composite independente — veja o guia de Composites para a visualização de Entradas entre formulários e os modos de exibição recolhida.

Opções de uma variável

Múltipla Escolha, Menu Suspenso e Classificação podem carregar suas opções de uma variável em vez de uma lista fixa — normalmente a resposta de um nó de dados que chama a sua API. Uma Matriz pode fazer o mesmo com as linhas, as colunas ou ambas.

Configuração

1. Adicione um nó de dados que retorne a lista e dê a ele uma Variável de resposta — por exemplo, breeds.
2. Nas configurações da pergunta, mude Origem das opções de Lista fixa (o padrão) para De uma variável. Em uma Matriz, use Origem das linhas e Origem das colunas.
3. Digite a variável que contém a lista: {breeds}, ou um caminho dentro da resposta, como {breeds.data}.
4. Se os seus itens não usam as chaves label e value, abra Seus itens usam outros nomes de campo? e informe o Campo do rótulo e o Campo do valor que os seus dados usam.

Em um formulário no estilo NueForm, coloque o nó de dados antes da pergunta. Em um formulário no estilo Questionário, ajuste Quando executar do nó de dados para Manter atualizado, para que a lista acompanhe as respostas do respondente — veja Estilo Questionário.

Essas configurações de origem só aparecem em perguntas colocadas diretamente no formulário. O construtor não as mostra em uma pergunta dentro de um Grupo de perguntas, de uma Página com várias perguntas ou de um composite, porque essas perguntas guardam a resposta dentro da resposta do elemento que as contém, onde os rótulos não podem ser mantidos. Uma pergunta que já carrega as opções de uma variável mantém a configuração se você a mover para um deles, mas aí as respostas dela mostram os valores dos itens em vez dos rótulos.

Na área de trabalho do construtor, a pergunta mostra Opções de {breeds} no lugar das opções.

Formatos aceitos

A variável precisa conter uma lista JSON — seja de strings simples, em que cada string é ao mesmo tempo o rótulo e o valor:

["Siamese", "Persian"]

seja de objetos com um rótulo e um valor:

[
  { "label": "Siamese", "value": "siamese" },
  { "label": "Persian", "value": "persian" }
]

Objetos que usam outras chaves também funcionam — informe essas chaves em Campo do rótulo e Campo do valor. Para esta resposta, use a variável {breeds.data}, o Campo do rótulo name e o Campo do valor id:

{ "data": [{ "name": "Siamese", "id": "siamese" }, { "name": "Persian", "id": "persian" }] }

Em Múltipla Escolha, um item também pode trazer uma URL image, que vira a imagem daquela opção:

[{ "label": "Siamese", "value": "siamese", "image": "https://example.com/siamese.jpg" }]

Quando a resposta é um objeto, aponte para a lista dentro dele com um caminho de pontos, como {breeds.data}. Para uma chave que não é uma palavra simples, use {breeds["the list"]}.

Como os itens são lidos

• O valor de cada item vira o ID da opção. É o que a resposta armazena, o que as condições de lógica comparam e o que a pontuação do quiz confere.
• Se um objeto tiver só um rótulo ou só um valor, esse dado é usado para os dois. Números e true/false são lidos como texto.
• Itens sem valor, ou com o mesmo valor de um item anterior, são ignorados, assim como valores com mais de 500 caracteres. Rótulos com mais de 500 caracteres são encurtados, e só os primeiros 1.000 itens são usados.
• Os rótulos aparecem como texto simples: nenhuma formatação é aplicada e os tokens {variable} que eles contiverem não são substituídos.
• "Outro" continua funcionando em Múltipla Escolha e Menu Suspenso: ele aparece depois dos itens carregados.
• As demais configurações da pergunta — como Permitir seleção múltipla, Ordem aleatória e Ordem alfabética — valem para os itens carregados normalmente.
• Um nó de dados guarda até 4.096 caracteres da resposta, então uma lista longa pode chegar cortada. Veja Respostas de nós de dados como listas de opções.

O que os respondentes veem

Não existe lista fixa de reserva. Enquanto a variável não tiver uma lista utilizável, a pergunta mostra uma das três primeiras mensagens abaixo no lugar das opções. A última aparece acima das opções depois que a lista muda:

Respostas salvas

• A resposta armazena os valores dos itens, exatamente como IDs de opção. Em uma Matriz, ela associa o valor de cada linha ao valor da coluna escolhida.
• Os rótulos que o respondente viu são salvos junto com a resposta, então as respostas, as exportações CSV e os e-mails de notificação mostram rótulos em vez de valores.
• Os webhooks enviam os valores junto com um mapa valueLabels de cada valor escolhido para o rótulo dele, tanto em envios pela web quanto em envios por ligação telefônica.
• A lista é carregada enquanto o respondente preenche o formulário, então o NueForm não confere de novo os valores enviados com ela. Perguntas obrigatórias continuam sendo exigidas. Se uma resposta precisa ser um dos seus próprios itens, verifique isso no seu sistema ao processar a resposta.

Pontuação e condições

• Pontuação: não existe lista fixa para marcar, então o editor de pontuação pede valores de itens, que precisam corresponder exatamente ("Corresponde exatamente ao valor do item."). Veja Modos de formulário.
• Condições: os saltos de lógica e as condições de visibilidade dessas perguntas usam operadores de texto e um valor digitado. Em uma Matriz, o editor de condições oferece apenas is_answered e is_not_answered, porque a resposta dela associa linhas a colunas. Veja Saltos de lógica.
• Chamadas telefônicas: o agente lê todas as opções da lista, e quem liga pode dizer uma opção ou digitar o número dela. Veja Telefonia.

Propriedades da origem

Uma Matriz tem o mesmo conjunto para cada eixo: rowSource, rowVariable, rowLabelField, rowValueField e columnSource, columnVariable, columnLabelField, columnValueField.