Janelas de expiração que derrubam vídeos nas redes

O vídeo passou no teste técnico, o horário estava certo e a publicação falhou mesmo assim. Quase sempre há um cronômetro invisível envolvido: a URL de upload do TikTok vale por uma hora, o contêiner do Instagram expira em 24 e nenhum painel avisa isso com clareza. Este guia mostra onde cada rede esconde seus prazos, quais erros esses prazos produzem e como organizar o fluxo para não estourar nenhuma janela.

O cronômetro de uma hora do TikTok

No fluxo de Direct Post do TikTok, a ferramenta de agendamento primeiro pede um endereço de upload à API e só depois transfere o arquivo. No TikTok, o endereço de upload devolvido pela API vale por uma hora e o envio precisa terminar dentro desse prazo. Se o arquivo pesado, a conexão lenta ou uma nova tentativa demorada cruzar essa marca, o envio seguinte responde com erro 403 e o trabalho recomeça do zero, conforme a documentação de Direct Post do TikTok.

O formato também entra na conta antes de qualquer prazo. Todos os criadores do TikTok podem publicar vídeos de 3 minutos, mas o teto de 10 minutos depende da conta. Para apps, o limite do endpoint de upload é de 10 minutos e o arquivo pode ter até 4GB, então um vídeo longo pode estourar tanto o limite da conta quanto a própria janela de envio em uma conexão lenta; as regras completas de tamanho, codecs e ordem das partes estão no guia de transferência de mídia do TikTok.

O contêiner do Instagram vive 24 horas

O Instagram publica em duas etapas: primeiro cria um contêiner com a mídia, depois publica o contêiner pronto. O contêiner de publicação do Instagram expira e devolve o status EXPIRED quando não é publicado em 24 horas. Ferramentas que criam o contêiner muito antes do horário marcado, ou que perdem a segunda chamada por queda de autorização, costumam descobrir a falha só quando o status volta com essa etiqueta. A recomendação oficial é consultar o status uma vez por minuto, por no máximo 5 minutos, antes de disparar a publicação; os seis estados possíveis do contêiner estão na documentação de publicação do Instagram.

Limites por minuto e por dia

As janelas de validade convivem com cotas de frequência. Cada token de usuário do TikTok pode iniciar no máximo 6 requisições de publicação por minuto. Uma agência que dispara vários vídeos da mesma conta em rajada consegue derrubar o próprio envio. Contas profissionais do Instagram ficam limitadas a 100 publicações via API em um período móvel de 24 horas. Quando o teto diário do TikTok é atingido, a API responde com o erro spam_risk_too_many_posts em vez de uma mensagem sobre tempo; já detalhei esses tetos no artigo sobre limites de publicação por API.

Checklist quando a publicação falhar

Antes de reenviar às cegas, siga esta ordem de diagnóstico; ela resolve a maioria das falhas de janela em poucos minutos:

1. Anote o horário exato da falha e compare com o momento em que o upload começou; mais de uma hora no TikTok indica endereço vencido.
2. Consulte o status do contêiner no Instagram antes de recriar a mídia; EXPIRED exige contêiner novo, IN_PROGRESS só pede espera.
3. Confira quantas publicações por API a conta já fez nas últimas 24 horas antes de tentar de novo.
4. Verifique se houve rajada de envios no mesmo minuto na mesma conta e espace as novas tentativas.
5. Só depois disso reenvie o arquivo, começando o upload do zero com um endereço novo.

Como blindar o fluxo

A defesa mais eficaz é encurtar a distância entre upload e publicação. Programe a transferência do arquivo para começar pouco antes do horário de saída, monitore o status até o estado final e trate toda queda de autorização como motivo para revalidar antes da próxima janela. Se o vídeo ficou preso depois de enviado, o artigo sobre vídeo travado no processamento traz o encaminhamento por rede; recriar o upload sem resolver a conexão da conta só repete a falha.

O que muda para agências com várias contas

Com várias contas de clientes no mesmo painel, as janelas se sobrepõem: cada conta tem seus próprios contêineres e tokens, mas o hábito de disparar tudo no mesmo minuto multiplica erros de limite e endereços vencidos. Distribua os envios em blocos ao longo do dia, deixe margem confortável entre o fim do upload e o horário de publicação e registre o resultado de cada conta separadamente. Quando a falha aparece em todas as contas ao mesmo tempo, a causa está no fluxo; quando aparece em uma só, está na conta.

Janelas de tempo não aparecem em painel nenhum, mas são as causas mais previsíveis de falha: uma hora no upload do TikTok, 24 horas no contêiner do Instagram e cotas por minuto e por dia nas duas plataformas. Coloque esses quatro números no procedimento de diagnóstico da equipe e a próxima falha aparentemente aleatória deixa de ser mistério.