NueForm

Criando Formulários

Aprenda a criar formulários no NueForm, configurar as opções do formulário, escolher os modos de formulário e definir telas de boas-vindas e de agradecimento.

Visão Geral

O NueForm permite criar formulários bonitos e interativos que apresentam uma pergunta por vez. Este guia cobre tudo, desde a criação do seu primeiro formulário até a configuração de opções avançadas, como modos de quiz e envio incremental.

Construtor de Formulários do NueForm
A interface do construtor de formulários com lista de perguntas, pré-visualização e painéis de configurações.

Criando um Novo Formulário

Para criar um novo formulário:

  1. Navegue até Meus Formulários no painel.
  2. Clique no botão Novo Formulário.
  3. Escolha entre um NueForm (formulário padrão) ou um Fuse (atividade colaborativa em tempo real).
  4. Dê um título ao formulário e uma descrição opcional.
  5. Comece a adicionar perguntas pela paleta de tipos de pergunta.

Cada formulário recebe automaticamente um slug exclusivo para sua URL pública. Você pode personalizar esse slug a qualquer momento nas configurações do formulário.

Configurações do Formulário

Painel de Configurações do Formulário
O painel de configurações do formulário no construtor.

Configurações Básicas

ConfiguraçãoDescriçãoPadrão
TítuloO título do formulário, exibido no painel e opcionalmente na tela de boas-vindas.Obrigatório
DescriçãoUma descrição opcional para referência interna.Vazio
SlugO caminho da URL do seu formulário publicado (por exemplo, nueform.io/f/my-survey). Deve ser exclusivo.Gerado automaticamente
Mostrar Barra de ProgressoExibe uma barra de progresso mostrando o quanto o respondente avançou.Ativado
Mostrar Navegação de PerguntasMostra as setas de navegação para cima/baixo e o contador de perguntas (por exemplo, 3 / 16) na parte inferior dos formulários de uma pergunta por vez.Ativado
Limitar a Uma RespostaRestringe cada visitante a um único envio usando identificação de visitante baseada no navegador.Desativado
Envio IncrementalSalva respostas parciais conforme o respondente avança, capturando os dados mesmo se ele abandonar o formulário.Desativado
Permitir RetomadaOs respondentes podem retomar um formulário parcialmente preenchido. As respostas são salvas no banco de dados após cada pergunta, permitindo continuar de onde pararam — em qualquer dispositivo quando conectados, ou no mesmo navegador quando anônimos.Ativado

Permitir Retomada

Quando Permitir Retomada está ativado (o padrão), o NueForm salva de forma transparente o progresso de cada respondente no banco de dados conforme ele avança pelo formulário. O respondente não precisa optar por nada para que o salvamento aconteça — ele simplesmente ocorre.

O que os respondentes veem

  • Modal de retomada ao carregar o formulário. Quando um respondente retorna e um progresso parcial é detectado, um modal bloqueante aparece perguntando "Continuar de onde parou?" com duas opções:
    • Continuar — restaura as respostas anteriores e o leva para a próxima pergunta não respondida.
    • Começar do zero — descarta o progresso parcial salvo (após uma etapa de confirmação) e inicia uma tentativa totalmente nova.
  • Modal de salvar progresso ao carregar o formulário (entre dispositivos). Se um usuário NueForm conectado abrir um formulário aberto (que não exige login), ele verá um modal oferecendo "Salvar seu progresso no seu perfil para retomar em qualquer dispositivo." Escolher Salvar progresso vincula a resposta em andamento à conta dele, permitindo continuar de outro navegador, celular ou computador. Escolher Não, obrigado mantém a resposta anônima e vinculada apenas àquele navegador; o aviso é suprimido pelos próximos 30 dias.

Onde o progresso é armazenado

RespondenteArmazenamentoEntre dispositivos?
Usuário conectado (login obrigatório)Vinculado à conta do usuário no banco de dados.Sim — retome de qualquer dispositivo.
Usuário conectado (formulário aberto, optou por "Salvar progresso")Vinculado à conta do usuário no banco de dados.Sim — retome de qualquer dispositivo.
Usuário conectado (formulário aberto, recusou "Salvar progresso")Anônimo, vinculado ao ID de visitante do navegador.Não — apenas no mesmo navegador.
Respondente anônimoVinculado ao ID de visitante do navegador (cookie).Não — apenas no mesmo navegador.

A retomada é feita no servidor e vem ativada por padrão — limpar os cookies do navegador não apaga mais o progresso salvo de um usuário conectado. Para respondentes anônimos, o progresso continua vinculado ao cookie de ID de visitante, então limpar os cookies os fará recomeçar.

Quando desativar Permitir Retomada

Desative essa configuração apenas para formulários de uso único em que o estado parcial não é útil — por exemplo, uma enquete rápida, um formulário em modo quiosque ou uma pergunta pontual de "joinha para cima / joinha para baixo". A maioria dos formulários mais longos se beneficia de mantê-la ativada.

Tela de Boas-Vindas

A tela de boas-vindas é a primeira coisa que os respondentes veem ao abrir seu formulário. Configure-a com:

CampoDescriçãoPadrão
Título de Boas-VindasO cabeçalho exibido na tela de boas-vindas. Deixe vazio para pular a tela de boas-vindas por completo.Vazio (sem tela de boas-vindas)
Descrição de Boas-VindasTexto de apoio abaixo do título. Suporta formatação de texto rico.Vazio
Texto do Botão de Boas-VindasO rótulo do botão que inicia o formulário."Começar"

Se você deixar o Título de Boas-Vindas vazio, os respondentes irão direto para a primeira pergunta. Isso é útil para formulários incorporados ou pesquisas rápidas.

Tela de Agradecimento

A tela de agradecimento aparece depois que o respondente envia o formulário.

CampoDescriçãoPadrão
Título de AgradecimentoO cabeçalho exibido após o envio."Obrigado!"
Descrição de AgradecimentoTexto de apoio abaixo do título. Suporta formatação de texto rico e substituição de variáveis.Vazio

Você pode usar a sintaxe {variableName} na descrição de agradecimento para exibir conteúdo personalizado com base nas respostas do respondente. Veja o guia de Variáveis para mais detalhes.

Modos de Formulário

O NueForm oferece suporte a quatro modos de formulário distintos, cada um projetado para um propósito diferente. O modo é definido no nível do formulário e afeta como as respostas são pontuadas e como as telas finais se comportam.

Modo Padrão

O modo padrão para pesquisas, formulários de contato, coleta de feedback e qualquer formulário que não exija pontuação.

  • Sem pontuação ou notas.
  • As respostas são coletadas e exibidas como estão.
  • As telas finais são puramente exibicionais.

Modo Quiz de Conhecimento

Projetado para quizzes, testes e avaliações em que há respostas certas e erradas.

  • Cada pergunta pontuável (múltipla escolha, menu suspenso, escolha por imagem, sim/não, jurídico, escala de opinião, avaliação) pode ter respostas corretas definidas.
  • Uma pontuação por resposta correta (padrão: 1 ponto) é concedida para cada resposta certa.
  • O feedback do quiz pode ser mostrado após cada pergunta com mensagens personalizáveis.
  • A pontuação final, o número de respostas corretas e o total de perguntas pontuáveis são calculados e armazenados.

Configurações do Quiz:

ConfiguraçãoDescriçãoPadrão
Mostrar Respostas CorretasExibe feedback imediato após cada pergunta, dizendo ao respondente se ele acertou ou errou.Ativado
Texto de Feedback de AcertoMensagem personalizada mostrada quando o respondente acerta. Máximo de 100 caracteres."Correto!"
Texto de Feedback de ErroMensagem personalizada mostrada quando o respondente erra. Máximo de 100 caracteres."Incorreto!"

Configuração de Pontuação (por pergunta):

  • Respostas Corretas (correctAnswers): Um array de IDs de opções que constituem a resposta correta. Para perguntas de resposta única, contém um ID. Para perguntas de seleção múltipla, todos os IDs corretos devem ser selecionados.
  • Pontuação por Resposta Correta (correctAnswerScore): Pontos concedidos por uma resposta correta. O padrão é 1.

Modo Qualificação de Leads

Projetado para pontuação de leads, avaliações de personalidade e formulários em que respostas diferentes valem pontos diferentes.

  • Cada opção em uma pergunta pontuável recebe um valor de pontos (choiceScores).
  • Os pontos se acumulam conforme o respondente avança.
  • Várias telas finais podem ser configuradas com faixas de pontuação, e o respondente é direcionado à tela final apropriada com base em sua pontuação total.

Configuração de Pontuação (por pergunta):

  • Pontuações por Opção (choiceScores): Um mapeamento de ID de opção para valor de pontos. Por exemplo: { "choice_1": 10, "choice_2": 5, "choice_3": 0 }.

Configuração da Tela Final:

  • Cada pergunta end_screen pode ter uma propriedade scoreRange com valores min e max.
  • Após o envio, o sistema faz a correspondência entre a pontuação total e a tela final apropriada.

Modo Quiz de Correspondência

Projetado para quizzes de personalidade, formulários no estilo "Qual personagem é você?" e avaliações baseadas em resultados.

  • Cada opção é mapeada para um ou mais resultados de tela final (choiceOutcomes).
  • Conforme o respondente responde, as contagens se acumulam para cada resultado.
  • A tela final com a maior contagem é exibida.

Configuração de Pontuação (por pergunta):

  • Resultados por Opção (choiceOutcomes): Um mapeamento de ID de opção para um array de IDs de perguntas de tela final. Por exemplo: { "choice_1": ["end_screen_a", "end_screen_b"], "choice_2": ["end_screen_c"] }.

Em todos os modos de quiz, apenas os tipos de pergunta pontuáveis participam da pontuação: Múltipla Escolha, Menu Suspenso, Escolha por Imagem, Sim/Não, Jurídico, Escala de Opinião e Avaliação.

Perguntas de Tela Final

Nos modos de quiz (conhecimento, qualificação de leads, correspondência), você pode adicionar várias perguntas end_screen ao seu formulário. Elas funcionam como finais condicionais:

  • Quiz de Conhecimento: A tela final é selecionada com base na pontuação do respondente.
  • Qualificação de Leads: Cada tela final tem um scoreRange (mín/máx), e a faixa correspondente determina qual tela é mostrada.
  • Quiz de Correspondência: Cada tela final acumula contagens dos resultados das opções, e a que tiver a maior contagem vence.

As perguntas de tela final ficam na lista de perguntas, mas não são mostradas durante o fluxo do formulário. Elas só aparecem no final, substituindo a tela de agradecimento padrão.

Adicionando Perguntas

As perguntas são adicionadas pela Paleta de Tipos de Pergunta no lado esquerdo do construtor de formulários. As perguntas são organizadas em categorias:

  • Texto: Texto Curto, Texto Longo, E-mail, Telefone, Número, Site
  • Escolha: Múltipla Escolha, Menu Suspenso, Escolha por Imagem, Sim/Não
  • Avaliação: Avaliação, Escala de Opinião, Net Promoter Score
  • Data: Data
  • Mídia: Upload de Arquivo, Desenho, Gravação de Vídeo/Áudio, Assinatura
  • Layout: Declaração, Tela de Boas-Vindas, Tela Final, Resumo, Salvar Respostas, Grupo de Perguntas, Página de Múltiplas Perguntas, Markdown
  • Avançado: Jurídico/Termos, Classificação, Matriz, Pagamento, Informações de Contato, Endereço

Veja a seção Tipos de Pergunta para a documentação detalhada de cada tipo.

Propriedades das Perguntas

Toda pergunta compartilha um conjunto de propriedades comuns:

PropriedadeDescrição
TítuloO texto da pergunta exibido ao respondente. Suporta texto rico (negrito, itálico, sublinhado, links) e substituição de {variable}.
DescriçãoTexto de ajuda opcional mostrado abaixo do título. Suporta texto rico e substituição de variáveis.
ObrigatóriaSe o respondente deve responder a esta pergunta antes de prosseguir.
OcultaSe a pergunta fica oculta para o respondente (útil para lógica interna).
Nome de Classe PersonalizadoUm nome de classe CSS opcional aplicado ao contêiner da pergunta para estilização personalizada.
Ocultar Número da PerguntaRemove o prefixo de número da pergunta (por exemplo, "1 ->") da exibição.
TransiçãoA animação usada na transição para esta pergunta. Opções: Deslizar Vertical (padrão), Deslizar Horizontal, Deslizar Diagonal, Salto Elástico, Zoom Através, Rotação de Entrada.
Variável de RespostaArmazena a resposta do respondente como uma variável nomeada para uso na substituição de {variable} em perguntas posteriores.

Anexos de Mídia

Toda pergunta oferece suporte a anexos de mídia opcionais. Você pode adicionar imagens, vídeos, ícones ou QR codes a qualquer pergunta.

Tipos de Mídia:

TipoDescrição
ImagemEnvie uma imagem ou forneça uma URL externa. Suporta ajustes de brilho, contraste, saturação, rotação de matiz e desfoque.
VídeoIncorpore um vídeo do YouTube ou Vimeo com opções de reprodução automática, mudo, loop e controles.
ÍconeEscolha entre milhares de react-icons com cor personalizável.
QR CodeGere um QR code a partir de um modelo de URL que suporta substituição de {variable}.

Opções de Layout (Desktop):

LayoutDescrição
stackA mídia aparece acima do conteúdo da pergunta (padrão).
split-leftMídia à esquerda, pergunta à direita, em um layout lado a lado.
split-rightMídia à direita, pergunta à esquerda.
float-leftA mídia flutua à esquerda do texto da pergunta.
float-rightA mídia flutua à direita do texto da pergunta.
backgroundA mídia aparece como plano de fundo atrás da pergunta.
fullscreen-fitA mídia preenche a tela mantendo a proporção.
fullscreen-coverA mídia cobre a tela inteira, cortando conforme necessário.

Opções de Layout (Mobile):

LayoutDescrição
stackA mídia aparece acima da pergunta (padrão).
hiddenA mídia fica oculta em dispositivos móveis.
backgroundA mídia aparece como plano de fundo.
fullscreen-fitA mídia preenche a tela mantendo a proporção.
fullscreen-coverA mídia cobre a tela inteira.

Ajustes de Imagem:

AjusteIntervaloPadrão
Brilho-100 a 1000
Contraste0 a 200100
Saturação0 a 200100
Rotação de Matiz0 a 360 graus0
Desfoque0 a 20 px0

Ponto Focal: Defina um ponto focal (coordenadas normalizadas de 0 a 1) para controlar qual parte da imagem permanece visível quando cortada.

Apresentações de Slides

Você pode anexar vários itens de mídia a uma única pergunta para criar uma apresentação de slides. As configurações incluem:

ConfiguraçãoDescriçãoPadrão
DuraçãoSegundos por slide.5
TransiçãoAnimação entre slides: crossfade, slide, zoom, flip, ken-burns, blur-fade.crossfade
Reprodução AutomáticaAvança os slides automaticamente.Ativado
Mostrar IndicadoresExibe indicadores de pontos abaixo da apresentação.Ativado
Mostrar SetasExibe setas de anterior/próximo.Desativado
Pausar ao Passar o MousePausa a reprodução automática quando o usuário passa o mouse sobre a apresentação.Ativado

Ordenação das Perguntas

As perguntas são exibidas aos respondentes na ordem em que aparecem no construtor. Você pode reordenar as perguntas arrastando-as no painel de navegação de perguntas no lado esquerdo do construtor.

Salvando e Publicando

Os formulários são salvos automaticamente conforme você faz alterações. Para disponibilizar um formulário aos respondentes, você deve publicá-lo. Veja o guia de Publicação para detalhes sobre o fluxo de publicação.

Última atualização: 20 de julho de 2026