Solucionando problemas de uploads com falha

Se um upload travar ou um trabalho de ingestão terminar em Falhou, este guia explica as causas mais comuns.

1. Verifique o painel de status do trabalho

Abra Uploads → Processamento na barra lateral. Cada trabalho mostra um status:

• Na fila. Upload concluído; aguardando um worker.
• Processando. OCR, estruturação e embedding estão em execução.
• Processado / aguardando revisão. Aguardando revisão antes da publicação.
• Concluído. Pronto — o documento está na sua Biblioteca.
• Erro. Algo deu errado. Clique na linha para ver uma mensagem de erro legível.

A razão da falha quase sempre indica exatamente o que corrigir.

2. Reenvie após verificar o arquivo

A maioria das falhas de upload se enquadra em uma destas categorias:

• Formato não suportado. Veja Formatos de arquivo suportados. Converta com uma ferramenta gratuita e tente novamente.
• PDF criptografado / protegido por senha. Remova a senha (Acrobat, Pré-Visualização no macOS ou qpdf --decrypt) e reenvie.
• Arquivo corrompido. Abra o arquivo localmente primeiro. Se seu visualizador de PDF não conseguir lê-lo, o Vulgate também não conseguirá. Reexporte da fonte.
• PDF vazio ou só de imagem sem contraste. O OCR precisa de pelo menos algum conteúdo legível. Aumente o contraste em uma ferramenta como Acrobat ou Pré-Visualização e tente novamente.
• Arquivo de áudio sem conteúdo audível. Alguns segundos de silêncio são aceitáveis, mas um arquivo inteiro de silêncio falhará.

3. Travamentos no lado do navegador

Se a barra de progresso de Upload ficar travada no meio:

• Queda de rede. Atualize a página — o Vulgate retoma o upload de onde parou para arquivos usando upload multipart.
• Interferência de extensão do navegador. Tente uma janela Anônima / Privada com extensões desativadas.
• Proxy corporativo bloqueando armazenamento. O Vulgate envia arquivos para o Cloudflare R2 via URL assinada (API compatível com S3); alguns proxies corporativos bloqueiam tráfego direto para armazenamento. Tente uma rede diferente ou contate sua equipe de TI.

4. Limite de gastos atingido

Se o trabalho disser Você excedeu seu limite de gastos para o seu plano, você usou os créditos de ingestão mensais do seu plano. Aguarde até o próximo ciclo de faturamento, ou abra Configurações → Faturamento e faça upgrade para um plano superior. Veja Ajustando seu plano.

5. Transcrição de áudio especificamente

• Incompatibilidade de idioma. O Vulgate detecta o idioma automaticamente; se seu arquivo é multilíngue, os resultados podem sofrer. Divida o arquivo por idioma e reenvie.
• Áudio silencioso. Verifique se o arquivo reproduz de forma audível localmente primeiro.
• Arquivo muito longo. Arquivos com mais de duas horas às vezes expiram. Divida em partes (ffmpeg -i input.mp3 -f segment -segment_time 3600 -c copy chunk_%03d.mp3) e reenvie.

Veja Por que a transcrição de áudio falhou para depuração mais aprofundada.

6. Ainda travado?

Se nenhuma das opções acima ajudar, por favor envie um email para info@vulgate.ai com:

• O ID do Trabalho da linha que falhou (o UUID mostrado na tabela de trabalhos).
• O nome do arquivo original.
• Uma cópia do arquivo, se puder compartilhar.

Investigaremos os logs e responderemos em um dia útil.