Estilo Questionário

Todo formulário tem um Estilo do Formulário. O estilo NueForm mostra uma pergunta por vez. O estilo Questionário mostra todas as perguntas em uma única página: os respondentes respondem na ordem que quiserem, podem alterar qualquer resposta até terminar e enviam tudo com um único botão Enviar. Em vez de saltos de lógica, um questionário mostra ou oculta perguntas com condições de visibilidade, definidas na caixa de diálogo Visibilidade e Ações.

Mudando um formulário para o estilo Questionário

1. Abra o formulário no construtor e vá em Configurações.
2. Em Estilo do Formulário, escolha Questionário.

Um formulário que contém uma etapa Alterar idioma não pode ser mudado: o construtor mostra Formulários que contêm nós de troca de idioma não podem usar o modo questionário. Remova essa etapa primeiro.

Se o formulário tiver saltos de lógica, a caixa de diálogo Mudar para o Estilo Questionário avisa que eles serão removidos — os questionários usam condições de visibilidade no lugar deles — e que a mudança não pode ser desfeita. Se o formulário tiver etapas de e-mail ou nós de dados, a caixa de diálogo também os lista e explica como serão executados: as etapas de e-mail são enviadas quando o formulário é enviado, e os nós de dados são executados quando as respostas que usam mudam ou ao enviar.

Essas etapas não bloqueiam a mudança nem são movidas: continuam onde estão, e cada nó de dados ganha a configuração Quando executar (veja Nós de dados). Revise cada um depois da mudança.

O que os respondentes veem

Antes de enviar

• Nada é definitivo até o respondente clicar em Enviar — qualquer resposta ainda pode ser alterada.
• As respostas são salvas automaticamente enquanto o respondente preenche, como uma resposta não concluída (parcial). Uma resposta parcial não é um envio: ela não dispara webhooks, não manda e-mails de notificação e não conta para a sua cota de respostas.
• Enviar aparece sempre no fim da página. Antes, o botão verifica as respostas: se uma pergunta obrigatória estiver vazia ou uma resposta for inválida, a caixa de diálogo Algumas respostas precisam de correção as lista e nada é enviado.

Depois de enviar

Enviar conclui a resposta. É nesse momento que os webhooks disparam, os e-mails de notificação saem, as etapas de e-mail são enviadas, os nós de dados configurados para executar ao enviar são executados e a resposta passa a contar para a sua cota. Durante o envio, a página fica bloqueada. Se um nó de dados em Manter atualizado ainda estiver aguardando ou em execução, o Enviar espera por ele primeiro — por até 10 segundos. Se a nova resposta do nó mudar a página, nada é enviado ainda. Quando uma lista deixa de oferecer a opção que o respondente escolheu, a lista a apaga e mostra Atualizado com base na sua resposta anterior. Quando a resposta faz aparecer uma pergunta, essa pergunta é exibida. Nos dois casos, a página rola até a pergunta, e o respondente a confere e clica em Enviar de novo. Uma pergunta que a nova resposta oculta não interrompe o envio: a resposta dela fica de fora, como a de qualquer pergunta oculta.

Em seguida, o respondente vê a tela final do formulário, com um botão Enviar outra resposta que abre um formulário novo e vazio. É a primeira tela final a que as respostas dele levam — ou, nos modos de quiz, a que corresponde à pontuação ou ao resultado dele (veja Modos de formulário). Se as respostas não levarem a nenhuma tela final, ele vê Suas respostas foram enviadas. As telas finais nunca aparecem na página antes do envio. O botão fica oculto quando Limitar a uma resposta por visitante está ativado.

No modo de design da prévia do construtor, as telas finais a que as respostas da prévia levam aparecem abaixo de Enviar, para que você possa selecionar uma e editá-la sem enviar o formulário.

Uma resposta enviada não pode ser editada — nem pela confirmação, nem abrindo o link de novo. Se ela foi salva na página Minhas Respostas do respondente (veja Exigir login do respondente), ele ainda pode revisá-la lá, somente para leitura.

Voltando mais tarde

A retomada funciona exatamente como nos formulários no estilo NueForm — veja Permitir Retomada e ID de visitante personalizado.

Como as etapas são executadas

Em um formulário no estilo NueForm, uma etapa de e-mail ou um nó de dados é executado no momento em que o respondente chega até ele. Um questionário não tem esse momento — todas as perguntas estão na página ao mesmo tempo —, então as etapas são executadas em pontos definidos.

Etapas de e-mail

Uma etapa de e-mail é enviada uma vez por resposta, quando o respondente clica em Enviar — e somente se as condições de visibilidade dela forem atendidas pelas respostas enviadas. Ela sai dos nossos servidores depois do envio, então o respondente nunca espera por ela, e Reenviar se revisitado não se aplica. No construtor, a etapa mostra Disparado ao enviar o formulário. Ela pode usar as respostas do respondente, a resposta dos nós de dados em Manter atualizado (enviada junto com o formulário) e a dos nós de dados Uma vez, ao enviar posicionados antes dela.

Nós de dados

Cada nó de dados ganha a configuração Quando executar, exibida apenas no estilo Questionário:

Manter atualizado em detalhes:

• O nó é executado assim que cada variável de resposta usada na URL, nos cabeçalhos e no corpo dele (como {animal}) tiver um valor, cada nó de dados anterior cuja resposta ele usa tiver retornado uma e as condições de visibilidade dele forem atendidas. Essas condições só decidem se o nó é executado: as perguntas que elas verificam não precisam estar respondidas. Selecionar Outro sem digitar nada ainda não conta como resposta. Um nó que não usa nenhuma resposta é executado quando o formulário é aberto.
• Quando uma dessas respostas muda, o nó é executado de novo. Perguntas de escolha o acionam assim que uma opção é selecionada; respostas de texto e número — e o texto digitado no campo Outro de uma pergunta de escolha —, quando o respondente sai do campo ou para de digitar por 800 ms.
• Se o nó não puder mais ser executado — uma resposta que ele usa foi apagada, ou as condições de visibilidade dele deixaram de ser atendidas —, a variável de resposta dele também é esvaziada, para que nada continue usando uma resposta que o respondente desfez.
• Só a requisição mais recente vale: uma nova requisição cancela a que ainda está em andamento, e resultados que chegam atrasados são ignorados.
• Os resultados bem-sucedidos são reaproveitados dentro do mesmo carregamento de página: trocar de Gato para Cachorro e voltar para Gato faz duas requisições, não três.
• Cada carregamento de página permite até 20 requisições por nó de dados; resultados reaproveitados não contam. Depois disso, o nó não envia mais requisições naquele carregamento de página, e a resposta dele fica vazia para respostas que ainda não tinham sido consultadas.
• As requisições passam pelos servidores do NueForm: o navegador do respondente nunca recebe a URL, os cabeçalhos, o corpo nem os segredos de conexão do nó — só os nomes das variáveis que a requisição usa.

Uma vez, ao enviar é executado nos nossos servidores, uma vez por resposta, depois que o respondente clica em Enviar. O formulário já terminou nesse ponto, então nenhuma pergunta nem lista de opções pode usar a resposta do nó — escolha Manter atualizado para um nó cuja resposta alimenta alguma delas. Já as etapas executadas no envio podem usá-la: as etapas de e-mail e os nós de dados Uma vez, ao enviar posicionados depois dele, que são executados na ordem do formulário. Cada envio executa no máximo 10 etapas de e-mail e 10 nós de dados Uma vez, ao enviar; os demais são ignorados. As etapas de e-mail também respeitam os limites de envio por visitante, por formulário e por IP que valem para qualquer etapa de e-mail em um formulário na web — veja Etapas de e-mail.

Essas etapas também recebem a resposta mais recente dos nós de dados em Manter atualizado, que o navegador envia junto com o formulário. Assim como as respostas, esses valores vêm do navegador do respondente, então não dependa deles para nada que um respondente não deva conseguir alterar.

O padrão. Quando você adiciona um nó de dados a um questionário, ou muda um formulário para o estilo Questionário, Quando executar é definido para você: Manter atualizado se algo mais adiante no formulário usar a variável de resposta do nó enquanto o formulário é preenchido — uma pergunta (o título, a descrição, a lista de opções ou as condições dela) ou outro nó de dados que também esteja em Manter atualizado —; caso contrário, Uma vez, ao enviar. Etapas de e-mail e nós de dados Uma vez, ao enviar não contam, porque são executados no envio, quando a resposta do nó já chega até eles; perguntas desativadas, ocultas ou desligadas para formulários web também não contam. Um nó de dados recém-adicionado ainda não tem variável de resposta, então começa em Uma vez, ao enviar: mude-o para Manter atualizado quando uma pergunta posterior usar a resposta dele — se você não fizer isso, o construtor avisa (veja abaixo). Um nó de dados criado pela API ou pelo MCP sem essa configuração é executado conforme essa mesma regra, e o construtor mostra essa opção como selecionada.

Requisições que alteram dados. Se você escolher Manter atualizado para uma requisição POST, PUT, PATCH ou DELETE, o construtor mostra um aviso: Esta requisição pode criar ou alterar dados sempre que for executada. Se ela envia dados em vez de consultar algo, escolha “Uma vez, ao enviar”. É só uma dica — a decisão é sua.

Uma resposta necessária durante o preenchimento. Se um nó estiver em Uma vez, ao enviar, mas uma pergunta ou lista posterior usar a resposta dele enquanto o formulário é preenchido, o construtor avisa: Uma pergunta ou lista posterior usa a resposta deste nó enquanto o formulário é preenchido, mas o nó só é executado ao enviar, então a resposta estará vazia ali. Escolha “Manter atualizado”.

Configurações que só o Estilo NueForm usa. Um questionário executa os nós de dados em segundo plano ou depois que a resposta é concluída, então no estilo Questionário o construtor oculta as configurações Modo Silencioso, Modo Debug, Usar como Validação e Texto de Carregamento de um nó, com este aviso: “Modo Silencioso”, “Modo Debug”, “Usar como Validação” e “Texto de Carregamento” só se aplicam ao Estilo NueForm. No Estilo Questionário, uma requisição com falha nunca bloqueia o envio. O tempo limite da requisição continua valendo. As configurações ocultas mantêm os valores, então voltar o formulário para o Estilo NueForm as restaura. Se uma resposta precisar passar por uma verificação no seu próprio sistema, verifique-a quando processar a resposta.

Indicadores no construtor

O cartão de cada etapa no construtor mostra quando ela é executada:

Chamadas telefônicas

Nada muda nas chamadas telefônicas NueVoice. Uma chamada continua fazendo uma pergunta por vez, e as etapas de e-mail e os nós de dados são executados quando a chamada chega até eles, na ordem do formulário. Quando executar vale só para o formulário na web.

Exemplo: raças do animal escolhido

1. Adicione uma pergunta de Múltipla escolha "Qual animal?" com as opções Gato e Cachorro e defina o Nome da variável de resposta dela como animal.
2. Adicione um nó de dados que chame https://api.example.com/breeds?animal={animal}, defina a Variável de resposta dele como breeds e ajuste Quando executar para Manter atualizado. O cartão dele mostra É executado ao responder: com a pergunta do animal.
3. Adicione uma Lista suspensa "Raça favorita", defina Origem das opções como De uma variável e digite {breeds} — veja Opções de uma variável.
4. Adicione uma etapa de e-mail que agradeça ao respondente. Ela é enviada quando ele clica em Enviar.

Quando um respondente escolhe Gato, a lista suspensa mostra Carregando opções… e depois as raças de gato. Ao trocar para Cachorro, as raças de cachorro são carregadas; se a raça que ele tinha escolhido não for mais oferecida, ela é apagada com o aviso Atualizado com base na sua resposta anterior. Ao voltar para Gato, o primeiro resultado é reaproveitado.

Respostas de escolha em variáveis

No exemplo acima, {animal} guarda o rótulo da opção que o respondente escolheu (Gato, não o ID da opção), exatamente como no Estilo NueForm. Em um formulário traduzido, o rótulo fica no idioma em que o respondente está preenchendo o formulário: para quem responde em inglês, {animal} vale Cat, então a requisição das raças sai com animal=Cat, e as etapas de e-mail e os textos que usam {animal} também recebem Cat. Para mostrar uma pergunta ou executar uma etapa só para uma opção, coloque a condição na própria pergunta (Qual animal? é Gato): ela compara a opção, seja qual for o idioma. Uma condição que compara a variável com um rótulo (animal é igual a Gato) deixa de funcionar para quem responde em outro idioma. Em uma lista carregada de uma variável, a variável guarda o rótulo do item do jeito que foi carregado — ele não é traduzido.