Publicação e Compartilhamento

Visão Geral

A publicação é o processo de disponibilizar seu formulário aos respondentes. O NueForm usa um sistema de publicação com versionamento que permite fazer alterações no seu formulário sem afetar a versão no ar até você estar pronto.

Fluxo de Publicação

Rascunho vs. Publicado

Todo formulário existe em dois estados:

• Rascunho: A versão que você vê e edita no construtor de formulários. As alterações são salvas automaticamente, mas não ficam visíveis aos respondentes.
• Publicado: A versão que os respondentes veem ao visitar a URL do seu formulário. É um snapshot do formulário no momento em que você clicou em Publicar.

Quando você faz alterações em um formulário publicado, o construtor mostra um selo indicando alterações não publicadas. Os respondentes continuam vendo a versão publicada anteriormente até você publicar de novo.

Quem liga também recebe a versão publicada. Cada chamada usa, do começo ao fim, a versão que estava no ar quando ela começou, mesmo que você publique de novo durante a chamada: as edições do rascunho não são ouvidas nas chamadas até você publicar. Veja Telefonia.

Os itens a seguir também seguem a versão publicada da mesma forma:

• Chat com IA: as perguntas sobre as quais ele pode conversar e se ele está ativado.
• Pagamentos: o preço, a conta Stripe, o modo de pagamento e o acompanhamento de pagamentos.
• Etapas de e-mail: o que elas enviam.
• Áudio de leitura em voz alta: o texto e a voz.
• Contratos: cada signatário vê a versão que estava publicada quando a sessão de assinatura foi criada, mesmo que você publique de novo enquanto ela está aberta, e o PDF assinado traz essa mesma versão.

Alterações em qualquer um desses itens chegam aos respondentes quando você publica. A pré-visualização do construtor e a pré-visualização do rascunho usam o seu rascunho, inclusive no Chat com IA. O áudio de leitura em voz alta é a exceção: ele é gerado quando você publica, então uma pré-visualização toca o áudio publicado.

Os envios pela web também são verificados em relação à versão publicada. Uma resposta a uma pergunta da versão publicada é mantida mesmo que você tenha excluído ou alterado essa pergunta no rascunho depois, as pontuações de quiz são calculadas com as perguntas publicadas, e as configurações publicadas decidem quem pode enviar: a proteção contra bots, o login do respondente e o limite de uma resposta por visitante.

Como Publicar

1. Abra seu formulário no construtor.
2. Faça as alterações desejadas.
3. Clique no botão Publicar no canto superior direito.
4. Suas alterações agora estão no ar.

Pré-visualizando o Rascunho

Para testar o rascunho atual na página pública do formulário, abra https://nueform.io/f/{slug}?preview=1 com login feito como alguém que pode editar o formulário: o proprietário, um membro da equipe cujo papel pode editar formulários (Owner, Admin ou Editor) ou um convidado com permissão para editar. Você vê o rascunho mesmo que o formulário não esteja publicado ou esteja encerrado, e nada é registrado: nenhuma resposta, nenhum progresso salvo e nenhuma visita.

Para qualquer outra pessoa, inclusive membros com papel Viewer e convidados que só podem visualizar, ?preview=1 não muda nada: ela recebe o formulário publicado como qualquer visitante (encerrado, se estiver encerrado), e a visita e as respostas dela são registradas normalmente.

Aceitando Respostas

Um formulário só aceita respostas novas enquanto está publicado e aberto. A regra é a mesma em todos os canais: a página do formulário, as incorporações e as chamadas telefônicas.

• Não publicado — um formulário que nunca foi publicado, ou que foi despublicado, não aceita nenhum envio. Isso inclui as respostas já em andamento: assim que o formulário é despublicado, o próximo salvamento de uma resposta iniciada é recusado, e ela não pode mais ser concluída. A única exceção é uma chamada telefônica que já está em andamento: quem liga pode terminá-la e, se você despublicar o formulário durante a chamada, a resposta dela chega até você normalmente. Ela só fica retida se o formulário estiver retido para análise ou for rejeitado na análise durante a chamada (veja Telefonia).
• Encerrado — um formulário publicado deixa de aceitar respostas novas quando você o encerra com o botão No ar / Encerrado ou Aceitar respostas está desativado, quando a Data de encerramento passa, quando ele atinge o Limite de respostas ou quando o seu limite mensal de respostas se esgota (veja Limite mensal de respostas abaixo). Quem já está preenchendo, com respostas já salvas, ainda pode terminar.

Se um formulário deixa de aceitar as respostas de alguém enquanto a pessoa preenche (porque foi despublicado, ou encerrado antes de as primeiras respostas dela serem salvas), o formulário é substituído pela tela Formulário encerrado, nunca por uma tela de agradecimento, para que ninguém ache que uma resposta foi registrada quando não foi. Em formulários no estilo Questionário, o motivo aparece abaixo do botão Enviar.

Um envio que falha por qualquer outro motivo, como uma conexão perdida, também não mostra uma tela de agradecimento. O respondente vê Não foi possível enviar suas respostas. Tente novamente. e um botão Tentar novamente, e as respostas dele são mantidas. Em formulários no estilo Questionário, a mensagem aparece abaixo do botão Enviar, que ele pode clicar de novo.

Abrindo e Encerrando um Formulário

Um formulário publicado tem um botão No ar / Encerrado: o ícone de cadeado na linha dele na lista de formulários e o botão ao lado de Publicar no painel dele.

• Ele muda apenas se o formulário no ar aceita respostas. Ele nunca publica as suas edições pendentes: elas continuam sem publicar até você clicar em Publicar.
• Encerrar formulário sempre funciona, na hora.
• Abrir formulário verifica de novo o seu plano em relação ao formulário no ar. Se ele usa um recurso que o seu plano não inclui (perguntas de contrato, nós de dados ou um webhook, por exemplo), continua encerrado: remova o recurso e publique, ou faça upgrade, e abra de novo.
• O botão mostra o que os respondentes recebem. Aceitar respostas, Data de encerramento e Limite de respostas, nas configurações do construtor, fazem parte do rascunho, então as mudanças neles só valem quando você publica. Por exemplo, se você adiar uma data de encerramento que já passou, o formulário continua encerrado até você publicar.
• Cada abertura ou encerramento adiciona uma versão ao histórico de versões do formulário.

Em formulários de equipe, só admins e owners podem abrir ou encerrar um formulário: veja Permissões de Publicação.

Formulários Retidos para Análise

Quando você publica, o NueForm analisa automaticamente o conteúdo do formulário em busca de abusos, como phishing. Um formulário retido para essa análise continua no ar, mas enquanto está retido:

• As respostas novas ficam retidas. Elas não aparecem nas suas respostas, e nenhum webhook ou e-mail de notificação é enviado por elas. As concluídas ainda contam no seu limite mensal de respostas.
• As etapas de e-mail não são enviadas.
• Os nós de dados e os pagamentos são recusados na página do formulário.

Se o formulário for aprovado, as respostas retidas aparecem nas suas respostas; os webhooks e e-mails de notificação que ficaram pendentes não são enviados depois. Se for rejeitado, o formulário é despublicado, as respostas retidas são excluídas e você recebe um e-mail. Uma chamada telefônica ainda em andamento quando o formulário é rejeitado pode terminar, mas a resposta dela fica retida: ela não chega até você, embora ainda conte no seu limite mensal de respostas.

Versionamento

O NueForm cria automaticamente um snapshot de versão sempre que você publica. Isso dá a você um histórico completo do seu formulário ao longo do tempo.

Detalhes da Versão

Cada versão registra:

Rastreamento de Alterações

O NueForm rastreia automaticamente as alterações entre publicações:

• Perguntas adicionadas, removidas ou reordenadas
• Texto, tipo ou configurações de pergunta alterados
• Configurações do formulário modificadas (tema, título, modo etc.)
• Saltos de lógica adicionados ou modificados

Essas alterações são compiladas em um changelog armazenado com cada versão publicada.

Revertendo para uma Versão Anterior

Se você precisar voltar a uma versão anterior do seu formulário:

1. Navegue até o histórico de versões do formulário.
2. Selecione a versão que deseja restaurar.
3. Clique em Reverter para esta versão.

Compartilhando Seu Formulário

URL Pública

Todo formulário publicado fica disponível em:

https://nueform.io/f/{slug}

Onde {slug} é o identificador exclusivo do seu formulário. Por exemplo:

https://nueform.io/f/customer-feedback-2024

Slugs Personalizados

Você pode personalizar o slug do seu formulário para tornar a URL mais memorável:

1. Abra as configurações do seu formulário.
2. Encontre o campo Slug.
3. Insira o slug desejado (apenas letras minúsculas, números e hifens).
4. Salve.

Domínios Personalizados

Com um plano Pro+, você pode servir seus formulários a partir do seu próprio domínio:

• Subdomínio: yourcompany.nueform.io/f/{slug}
• Domínio personalizado: forms.yourcompany.com/f/{slug}

Veja o guia de Domínios Personalizados para as instruções de configuração.

Parâmetros de URL

Você pode passar dados para o seu formulário por meio de parâmetros de URL. Eles ficam disponíveis como variáveis de URL para uso em saltos de lógica e substituição de texto:

https://nueform.io/f/my-form?name=John&source=email

Neste exemplo, {name} seria resolvido como "John" e {source} como "email" em qualquer lugar dos títulos, descrições ou condições de lógica do seu formulário.

Veja o guia de Variáveis para mais detalhes.

Incorporação

Você pode incorporar seu formulário em qualquer site usando um iframe:

<iframe
  src="https://nueform.io/f/{slug}"
  width="100%"
  height="600"
  frameborder="0"
  style="border: none;"
></iframe>

Passando Variáveis de URL em Incorporações

Você pode passar variáveis de URL para formulários incorporados assim como faria com links diretos:

<iframe
  src="https://nueform.io/f/my-form?name=John&company=Acme"
  width="100%"
  height="600"
  frameborder="0"
></iframe>

Webhooks

Com um plano Pro+, você pode configurar uma URL de webhook no seu formulário. Quando uma resposta é enviada, o NueForm envia uma requisição POST à sua URL de webhook com os dados da resposta.

Payload do webhook

O corpo do POST do webhook traz:

• event — sempre form.submitted
• formId — o ID do formulário
• formTitle — o título do formulário no momento do envio
• responseId — o ID da resposta
• answers — todas as respostas, cada uma com seu questionId e seu value
• respondent — quem enviou, em formulários que exigem login; null nos demais
• submittedAt — quando o webhook foi enviado

Os resultados de quiz não são incluídos: busque-os pela API de Respostas usando o responseId (veja Resultados de questionário). O esquema completo está em Payloads de webhooks.

Segurança do webhook

Toda requisição de webhook traz um cabeçalho X-NueForm-Signature — uma assinatura HMAC-SHA256 do corpo da requisição, feita com o seu segredo do webhook — que você pode usar para verificar se a requisição veio do NueForm. Você não precisa configurar o segredo antes: veja na visão geral de webhooks como ele é criado. Formulários de equipe são assinados com o segredo do owner da equipe: veja Segredos de formulários de equipe.

Webhooks Globais

Além dos webhooks por formulário, você pode configurar até 5 webhooks globais nas configurações da sua conta. Os webhooks globais disparam para cada envio de resposta em todos os seus formulários.

Envio Incremental

Quando ativado, o NueForm salva respostas parciais conforme o respondente avança pelo formulário. Isso significa que:

• Se um respondente abandonar o formulário no meio do caminho, você ainda terá as respostas parciais dele.
• Cada vez que o respondente avança para a próxima pergunta, o progresso dele é salvo.
• A resposta é marcada como "concluída" quando ele chega ao final e envia.

Isso é especialmente útil para formulários longos em que o abandono é uma preocupação.

Limitando Respostas

A configuração Limitar a Uma Resposta usa identificação de visitante baseada no navegador para impedir que a mesma pessoa envie o formulário mais de uma vez. Quando ativada:

• Um ID de visitante exclusivo é gerado e armazenado no armazenamento local do navegador.
• Em visitas subsequentes, o formulário verifica se esse visitante já enviou.
• Se sim, o formulário exibe uma mensagem em vez de permitir um novo envio.

Limite mensal de respostas

Cada plano inclui uma cota mensal de respostas, contabilizada em todos os seus formulários em conjunto:

Uma resposta é contabilizada quando é concluída — ou seja, quando a pessoa realmente envia o formulário. Formulários preenchidos pela metade e nunca enviados não consomem sua cota, assim como respostas que você mesmo importa via CSV ou do Typeform.

Respostas por telefone coletadas pelo NueVoice também contam. Observe que, se uma ligação encadeia vários formulários, cada formulário concluído conta como uma resposta própria.

A cota é reiniciada no início de cada mês civil. Você pode ver o uso atual e a data de reinício na sua página de Perfil, na seção Custo e cobrança da Atividade e nos alertas de limite de plano da sua central de notificações.

Em formulários de equipe, as respostas são descontadas da cota do proprietário da equipe, não da cota do membro que criou o formulário.