Publicações falhadas no TikTok: spam_risk_too_many_posts, picture_size_check_failed e outros motivos de falha
O TikTok indica a causa de uma publicação falhada em reason, no endpoint de estado da API for Business, ou em fail_reason na Content Posting API. Falhas de verificação como picture_size_check_failed significam que o ficheiro viola uma regra de formato e tem de ser alterado; video_pull_failed significa que o TikTok não conseguiu transferi-lo dentro de uma hora; spam_risk_too_many_posts significa demasiadas publicações pela API em 24 horas. Uma falha marcada como internal pode simplesmente ser repetida.
O easyCoexistence acompanha cada publicação no TikTok que publica até o TikTok a concluir ou a falhar, para o Claude, o ChatGPT ou a sua própria plataforma: uma falha chega com o motivo do TikTok por email, no ecrã de Publicações e como evento post.failed, pronta para nova tentativa.
O campo /business/publish/status/ só é devolvido quando o estado é FAILED, com valores como frame_rate_check_failed.
O nome que a Content Posting API dá ao mesmo campo, nas respostas de /v2/post/publish/status/fetch/.
Tempo limite de transferência, após o qual o TikTok falha uma publicação com video_pull_failed ou photo_pull_failed.
Janela associada a spam_risk_too_many_posts; o TikTok sugere publicar essa publicação a partir da aplicação para telemóvel.
Na maior parte das vezes, o easyCoexistence envia email a um proprietário sobre publicações falhadas num canal; a publicação fica em Requer atenção.
Onde é que o TikTok indica o motivo de falha de uma publicação?
Depois da chamada de publicação, que apenas inicia a tarefa: o código 0 significa que o TikTok a aceitou, não que a publicação vai ficar online. GET /business/publish/status/ devolve depois FAILED com reason, e uma aplicação subscrita aos webhooks de publicação recebe post.publish.failed com o mesmo motivo e o publish_id. O /v2/post/publish/status/fetch/ da Content Posting API devolve o campo como fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Qual é o significado de cada motivo de falha, e o que o corrige?
Os motivos do TikTok, tal como os descreve a sua referência de eventos de publicação, com a correção que cada um indica. Os quatro primeiros são verificações que o TikTok faz ao ficheiro depois de o transferir, todas marcadas como não repetíveis. A tabela de falhas do TikTok ainda indica 60 segundos como o vídeo mais longo para duration_check_failed, enquanto o endpoint de vídeo documenta 600, ou o max_video_post_duration_sec da própria conta:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Quais falhas podem ser repetidas?
As causadas pela transferência ou pelo próprio TikTok. As restantes precisam de outro ficheiro ou de outra legenda, de uma pausa, ou de nada:
- Voltar a tentar tal como está: internal, e
video_pull_failedouphoto_pull_failedquando o URL estiver público e for suficientemente rápido. - Voltar a tentar com um novo ficheiro:
file_format_check_failed,duration_check_failed,frame_rate_check_failedepicture_size_check_failed. - Voltar a tentar com uma nova legenda:
spam_risk_text. - Esperar, ou publicar a partir da aplicação do TikTok:
spam_risk_too_many_posts. - Não voltar a tentar:
auth_removedespam_risk, como o TikTok aconselha, ouspam_risk_user_banned_from_posting.
Em que se diferenciam as falhas da Content Posting API?
Os mesmos motivos, outro campo e endpoint, e recusas que acontecem antes de o processamento começar. /v2/post/publish/status/fetch/ devolve fail_reason, permite 30 pedidos por minuto por token de utilizador e acrescenta conselhos de não voltar a tentar para spam_risk_user_banned_from_posting e spam_risk_text. Várias recusas chegam, em vez disso, à chamada init, com HTTP 403:
spam_risk_too_many_posts: o criador atingiu o limite diário de publicações da API.unaudited_client_can_only_post_to_private_accounts: uma aplicação não auditada tentou publicar para uma conta pública.url_ownership_unverified:PULL_FROM_URLa partir de um domínio ou prefixo que a aplicação não verificou.privacy_level_option_mismatch: umprivacy_levelem falta ou fora das opções do criador.reached_active_user_cap: a aplicação atingiu a sua quota diária de utilizadores ativos de publicação.
O que falha antes de o TikTok ver a publicação?
O que o easyCoexistence pode detetar primeiro, com uma mensagem própria em vez de um motivo do TikTok. O conteúdo multimédia de uma publicação agendada é copiado quando é agendada, e uma ligação que devolve uma página web, um 404, o tipo errado ou um ficheiro com mais de 30 MB para imagem ou 1 GB para vídeo é recusada nesse momento. Ligações de fotos que terminem em .png, .gif, .bmp, .heic, .avif ou .svg são recusadas antes de qualquer envio, um canal que precise de ser religado no momento da publicação falha como reconnect, e remover um canal cancela as suas publicações agendadas.
Como é que o easyCoexistence comunica uma publicação falhada no TikTok?
Através da sua fila de publicação, que acompanha cada publicação no TikTok depois da chamada de publicação, verificando /business/publish/status/ a cada 20 segundos até PUBLISH_COMPLETE. Um estado FAILED falha a publicação, cujo erro indica o motivo do TikTok entre parênteses, como frame_rate_check_failed, e cada falha traz um failure_kind:
- refused: o TikTok respondeu que não, como com um estado FAILED e o respetivo motivo.
- uncertain: a chamada de publicação não obteve resposta clara, ou o TikTok não confirmou no prazo de 2 horas, por isso a publicação pode estar online (
may_be_published). - reconnect: o TikTok recusou o token da conta, e a conta precisa de um novo início de sessão.
- internal: o easyCoexistence falhou antes de entregar a publicação, por isso nada foi enviado.
Como encontrar e voltar a tentar uma publicação falhada?
O titular recebe um email por cada falha encontrada em segundo plano, no máximo um por canal a cada 3 horas, e o URL de eventos de uma plataforma recebe post.failed. A publicação aparece em Requer atenção no ecrã de Publicações, com Tentar novamente, Voltar a ligar e Ignorar, e list_scheduled_posts devolve-a ao Claude ou ao ChatGPT. retry_scheduled_post publica-a de novo, agora, a partir dos ficheiros guardados durante 7 dias após a falha; quando may_be_published é verdadeiro, consulte primeiro list_social_posts e indique confirm apenas se a publicação estiver em falta. Uma publicação que precise de novo ficheiro ou legenda volta a ser agendada em vez disso.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Erros comuns
- Voltar a tentar uma falha de verificação com o mesmo ficheiro. O TikTok marca as falhas de formato, duração, taxa de fotogramas e tamanho da imagem como não repetíveis.
- Voltar a tentar spam_risk_too_many_posts de imediato. O TikTok conta as publicações pela API nas últimas 24 horas e sugere publicar a partir da aplicação para telemóvel.
- Voltar a tentar uma publicação marcada como may_be_published sem verificar. O TikTok pode tê-la publicado; consulte as publicações mais recentes da conta, ou ela vai ao ar duas vezes.
- Procurar fail_reason na API for Business. O endpoint de estado nomeia o campo reason; fail_reason pertence à Content Posting API.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O que significa picture_size_check_failed no TikTok?
O TikTok transferiu a publicação e encontrou a imagem abaixo do mínimo de 360 píxeis de altura e de largura; é preciso um ficheiro maior, pois o TikTok marca a falha como não repetível.
O que é video_pull_failed?
O TikTok não conseguiu transferir o vídeo a partir do URL, ou não o conseguiu fazer dentro do limite de uma hora. Confirme que o URL é público e não tem limite de largura de banda, e depois volte a tentar.
Quanto tempo dura spam_risk_too_many_posts?
O TikTok conta as publicações feitas pela API nas últimas 24 horas, cerca de 15 por dia por conta, e sugere, entretanto, publicar a partir da aplicação para telemóvel do TikTok.
O easyCoexistence volta a tentar sozinho uma publicação falhada no TikTok?
Não, depois de o TikTok comunicar FAILED: a publicação fica em Requer atenção e o titular recebe um email, e Tentar novamente ou retry_scheduled_post volta a publicá-la.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em