Pular para o conteúdo
← DevForm

Documentação

Como um formulário é montado, compartilhado e lido.

Perguntas e tipos de resposta

Adicione texto curto ou longo, e-mail, número, data, escolha única, múltipla escolha, avaliação e perguntas de sim ou não. Perguntas obrigatórias bloqueiam o próximo passo; as opcionais podem ser puladas. O envio de arquivos continua indisponível até existir um fluxo real de upload.

Lógica condicional

Uma pergunta pode aparecer quando uma resposta anterior é igual, diferente, uma entre várias opções, foi respondida ou não foi respondida. Uma condição que aponta para frente, para si mesma ou para uma pergunta excluída falha de forma segura e mostra a pergunta a todos.

Chaves de exportação estáveis

Cada pergunta tem uma chave usada como nome da coluna no CSV. Reescrever a pergunta visível não altera essa chave, então uma importação, planilha ou análise baseada na exportação continua funcionando.

Rascunhos, publicação e links

Um rascunho não aceita respostas. Publique quando as perguntas estiverem prontas e compartilhe o único link hospedado. Você pode tirar do ar sem excluir o formulário nem as respostas, e visualizar antes de publicar.

Incorporação

Os planos pagos fornecem um trecho para incorporar o mesmo formulário hospedado no seu site. O formulário, a validação, a lógica e o armazenamento das respostas continuam no DevForm; a página ao redor continua sendo sua.

Webhooks

Adicione um endpoint https no editor do formulário e cada resposta completa é enviada a ele por POST como JSON: o formulário, os campos, as respostas e os campos ocultos. Cada requisição traz x-devform-signature: t=<hora unix>,v1=<HMAC-SHA256 em hex de "<t>.<corpo>" com o seu segredo de assinatura> — rejeite uma assinatura que não confira ou um carimbo de tempo com mais de cinco minutos. x-devform-delivery não muda entre tentativas, então use-o para descartar duplicatas. Uma resposta que não seja 2xx é tentada de novo sete vezes ao longo de cerca de um dia. Disponível em todos os planos; gerenciado por proprietários e administradores.

Campos ocultos, respostas encadeadas e redirecionamentos

Declare parâmetros de URL como ref ou utm_source como campos ocultos e compartilhe devform.osokoro.com/f/seu-formulario?ref=newsletter: o valor é guardado com a resposta, aparece na caixa de entrada e é exportado como a coluna hidden.ref. Parâmetros que você não declarou são ignorados. Escreva {{chave}} numa pergunta, num texto de ajuda ou no encerramento para mostrar uma resposta anterior ou um campo oculto. Uma URL de redirecionamento leva as pessoas à sua própria página https depois da tela de agradecimento.

Respostas, parciais e limites

As respostas aparecem enquanto são preenchidas, inclusive as inacabadas, para você ver em qual pergunta as pessoas param. Respostas inacabadas ficam por até 30 dias. Envios completos contam para a franquia mensal do plano.

Encerrar um formulário

Um formulário para de aceitar respostas quando você o despublica, quando passa a data de encerramento ou quando atinge o limite de respostas. Quem responde vê a mesma mensagem neutra em todos os casos. A franquia mensal conta as respostas completas de todos os seus formulários, e o painel de formulários mostra quanto dela já foi usado.