Uploads de Arquivo

O tipo de pergunta de upload de arquivo do NueForm permite que os respondentes anexem arquivos aos envios do formulário. Este guia mostra como configurar uploads de arquivo, definir restrições e acessar os arquivos enviados.

Configurando uma Pergunta de Upload de Arquivo

1. Abra seu formulário no construtor do NueForm.
2. Clique no botão + para adicionar uma nova pergunta.
3. Selecione File Upload na lista de tipos de pergunta.
4. Configure o título da pergunta (por exemplo, "Envie seu currículo" ou "Anexe documentos comprobatórios").
5. Defina a pergunta como required se for necessário fornecer um arquivo.

Tipos de Arquivo Suportados

O NueForm aceita uma ampla variedade de tipos de arquivo. Por padrão, todos os tipos de arquivo comuns são aceitos. Você pode restringir os tipos aceitos nas propriedades da pergunta.

Tipos de Arquivo Comuns

Limites de Tamanho de Arquivo

O tamanho máximo de arquivo por upload depende do seu plano do NueForm:

Cotas de Armazenamento

Cada conta do NueForm tem uma cota total de armazenamento que abrange todos os arquivos enviados em todos os formulários. Isso inclui:

• Arquivos enviados pelos respondentes por meio de perguntas de upload de arquivo.
• Arquivos de mídia enviados por você no construtor de formulários (imagens e vídeos para a mídia das perguntas).

Verificando Seu Uso de Armazenamento

Seu uso atual de armazenamento é registrado nas configurações da sua conta. O NueForm armazena o total de bytes consumidos em todos os seus uploads.

O Que Acontece Quando Você Atinge o Limite

Quando sua cota de armazenamento é atingida:

• Novos uploads de arquivo dos respondentes falharão com uma mensagem de erro.
• Envios de formulário que incluam uploads de arquivo serão rejeitados.
• Outros tipos de pergunta (texto, escolha, avaliação etc.) não são afetados.
• Você pode liberar espaço excluindo respostas antigas que contenham arquivos anexados.

Como o Armazenamento de Arquivos Funciona

O NueForm armazena os arquivos enviados no Vercel Blob Storage:

1. Quando um respondente seleciona um arquivo, ele é enviado diretamente para o armazenamento do NueForm.
2. Cada arquivo recebe um nome de arquivo único baseado em UUID (por exemplo, a1b2c3d4.pdf) para evitar conflitos de nomes.
3. O nome original do arquivo é preservado nos metadados junto com o arquivo armazenado.
4. A URL do arquivo é armazenada como o valor da resposta da pergunta.

O registro do arquivo armazenado inclui:

Acessando os Arquivos Enviados

No Painel de Respostas

Ao visualizar uma resposta no painel do NueForm, as respostas de upload de arquivo exibem:

• O nome original do arquivo.
• Um link de download para acessar o arquivo.
• O tamanho do arquivo.

Pela API

Quando você recupera uma resposta pela API de Respostas, as respostas de upload de arquivo contêm a URL de armazenamento do arquivo:

{
  "questionId": "507f1f77bcf86cd799439033",
  "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}

Você pode baixar o arquivo fazendo uma requisição GET para essa URL.

Pelos Webhooks

Os payloads do webhook incluem a URL do arquivo como o valor da resposta:

{
  "event": "form.submitted",
  "formId": "...",
  "responseId": "...",
  "answers": [
    {
      "questionId": "507f1f77bcf86cd799439033",
      "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
    }
  ]
}

Consulte Payloads de Webhook para a referência completa de payloads.

Em Exportações CSV

Quando você exporta respostas como CSV, as respostas de upload de arquivo aparecem como URLs nas células do CSV. Você pode clicar nessas URLs para baixar os arquivos.

Configurando as Propriedades do Upload de Arquivo

No painel de propriedades da pergunta, você pode configurar:

Múltiplos Uploads de Arquivo

Se você precisa que os respondentes enviem vários arquivos, adicione várias perguntas de upload de arquivo ao seu formulário. Cada pergunta aceita um arquivo, mantendo o envio estruturado e organizado.

Por exemplo:

• Pergunta 1: "Envie seu currículo (PDF)"
• Pergunta 2: "Envie sua carta de apresentação (PDF)"
• Pergunta 3: "Envie seu portfólio (PDF ou ZIP)"

Boas Práticas

1. Seja específico sobre o que deve ser enviado. Use o título e a descrição da pergunta para dizer aos respondentes exatamente qual arquivo você precisa e em qual formato. Por exemplo: "Envie seu currículo em PDF (máx. 10 MB)."

2. Defina as perguntas como obrigatórias quando apropriado. Se o arquivo for essencial (por exemplo, o currículo em uma candidatura de emprego), marque a pergunta como obrigatória. Se for opcional (por exemplo, documentos comprobatórios adicionais), deixe-a opcional.

3. Monitore o uso de armazenamento. Verifique sua cota de armazenamento periodicamente, principalmente se seus formulários recebem alto volume de envios. Faça upgrade do seu plano se estiver se aproximando do limite.

4. Processe os arquivos com agilidade. Se você usa webhooks para receber as URLs dos arquivos, baixe e processe os arquivos do seu lado. Não dependa apenas do armazenamento do NueForm para arquivamento de longo prazo.

5. Considere a nomeação dos arquivos nas instruções. Peça aos respondentes que nomeiem seus arquivos de forma descritiva antes de enviar (por exemplo, "Nome-Sobrenome-Curriculo.pdf"), já que o NueForm preserva os nomes originais dos arquivos nos metadados.

Solução de Problemas

Relacionados

• Tipos de Pergunta: Mídia --- Visão geral dos tipos de pergunta relacionados a mídia
• Payloads de Webhook --- Como as URLs de arquivo aparecem nos dados do webhook
• Referência da API: Respostas --- Acesso aos arquivos enviados pela API