Vídeo travado no processamento? O que fazer em cada rede

Quando um vídeo agendado fica preso em processamento, o problema está quase sempre em um de três lugares: o arquivo de origem, a janela de processamento da própria rede ou a confirmação final de publicação. Cada rede trata essa etapa de um jeito diferente, com prazos e estados intermediários próprios, e confundir um pelo outro leva à pior decisão possível: apagar tudo e subir o vídeo de novo sem saber o que falhou. Este guia mostra o que acontece no Instagram, no TikTok e no YouTube entre o fim do upload e o post no ar, e como diagnosticar a falha no lugar certo.

O que significa vídeo travado

Vídeo travado não é upload lento. O arquivo já chegou ao servidor da rede, mas a publicação não foi concluída: no Instagram o contêiner continua em estado de processamento, no TikTok o identificador de publicação não avança para publicado e no YouTube o upload resumível termina sem devolver o id do vídeo. Em todos os casos a interface mostra uma barra infinita ou um status genérico de aguardando processamento, e a pergunta prática é sempre a mesma: isso ainda vai terminar sozinho ou já falhou?

Vale separar também falha de token de falha de mídia: se a conta desconectou, o agendador avisa na hora e o post nem chega a ser enviado; se o vídeo travou, a autorização está válida e o problema está no processamento. São filas de correção diferentes, e misturá-las faz você reconectar contas que não precisavam de nada.

Instagram: o contêiner tem prazo

O Instagram publica em duas etapas: primeiro você cria um contêiner de mídia com o vídeo, depois publica o contêiner pronto. Antes de reenviar qualquer arquivo, consulte o estado do contêiner: a documentação do Instagram Platform recomenda checar o status uma vez por minuto, por no máximo 5 minutos, antes de concluir que algo deu errado. Muitos contêineres simplesmente ainda não terminaram de processar.

O prazo mais importante do Instagram é o do próprio contêiner. No Instagram, o contêiner de mídia expira se não for publicado dentro de 24 horas. Depois disso é preciso criar um contêiner novo, porque publicar de novo o mesmo identificador não funciona: o contêiner vencido deixou de ser elegível.

Existe também um limite silencioso que imita travamento. A API do Instagram limita cada conta profissional a 100 publicações num período móvel de 24 horas. Quando a conta atinge o teto, o contêiner pode estar pronto e ainda assim a publicação falhar, o que na tela parece processamento infinito. Se você agenda lotes grandes, monitore o consumo do limite antes de culpar o arquivo, com os limites de publicação por API sempre à vista.

TikTok: a janela de uma hora

O TikTok aceita vídeo por upload direto de arquivo ou por download a partir de uma URL hospedada por você. No segundo caso, a rede busca o arquivo no seu servidor, e essa busca tem prazo: No TikTok, quando a publicação usa download do vídeo por URL, o servidor precisa concluir a transferência dentro de uma hora. A URL precisa ser HTTPS, não pode redirecionar e tem de permanecer acessível durante todo o download — um link de CDN que caduca no meio da janela derruba a publicação sozinha.

Se o upload é feito em blocos, um erro temporário em um bloco não invalida o resto: a documentação do TikTok orienta reenviar apenas o bloco que falhou, enquanto um erro 403 no meio do caminho indica que a URL de upload expirou e a inicialização precisa ser refeita. Antes de culpar a conexão, confira também a duração do arquivo. Pela API do TikTok, o vídeo mais longo que um app pode enviar tem 10 minutos. A conta do criador pode permitir menos que isso, e aí o vídeo é cortado ou recusado mesmo com upload impecável.

YouTube: retome em vez de reiniciar

O upload do YouTube pelo Data API é resumível: se a conexão cai no meio, a transferência continua de onde parou em vez de recomeçar do zero. Falhas temporárias de servidor, como respostas 500, 502, 503 e 504, são tratadas como recuperáveis. No YouTube, o script oficial de upload retoma falhas com espera exponencial e desiste depois de 10 tentativas. Ou seja: um erro momentâneo não deveria derrubar seu vídeo agendado; se derrubou, o problema tende a estar no arquivo ou na autorização, não na instabilidade da rede.

Checklist de diagnóstico

1. Confirme em que etapa parou: upload concluído, processamento da mídia ou publicação final.
2. No Instagram, consulte o status do contêiner uma vez por minuto, por até 5 minutos, antes de reagir.
3. No TikTok com vídeo por URL, verifique se o link continua acessível, em HTTPS e sem redirecionamento.
4. Confira o arquivo: MP4 com H.264, dentro da duração e do tamanho aceitos pela rede.
5. Cheque o consumo do limite de 24 horas da conta antes de reenviar qualquer coisa.
6. Se o contêiner ou a URL de upload expirou, crie um novo do zero em vez de repetir o identificador antigo.
7. Só reexporte o vídeo depois de descartar prazo, limite e link como causas.

Quando refazer do zero

Refazer vale a pena quando o arquivo é a causa: codec fora do recomendado, áudio incompatível ou duração acima do aceito pela conta. Nesse caso, reexporte no perfil padrão da rede e siga uma rotina de teste do vídeo antes de publicar para não descobrir o problema com a agenda já cheia. O diagnóstico primeiro poupa horas de reupload em vão: na maioria dos casos travados o vídeo está bem — o que venceu foi um prazo que ninguém estava contando.