Falhas de publicação no TikTok: spam_risk_too_many_posts, picture_size_check_failed e outros motivos de falha
O TikTok informa a causa de uma publicação com falha em reason, no endpoint de status da API for Business, ou em fail_reason, na Content Posting API. Falhas de verificação, como picture_size_check_failed, indicam que o arquivo quebra uma regra de formato e precisa ser trocado; video_pull_failed significa que o TikTok não conseguiu baixá-lo em uma hora; spam_risk_too_many_posts indica posts demais via API em 24 horas. Uma falha marcada como internal pode simplesmente ser repetida.
O easyCoexistence acompanha cada post do TikTok que publica até o TikTok concluí-lo ou falhar, para Claude, ChatGPT ou a sua própria plataforma: uma falha chega com o motivo do TikTok por e-mail, na tela de Posts e como evento post.failed, pronta para repetir.
O campo /business/publish/status/ só retorna quando o status é 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 download após o qual o TikTok falha um post com video_pull_failed ou photo_pull_failed.
Janela por trás de spam_risk_too_many_posts; o TikTok sugere publicar esse post pelo app móvel.
Com mais frequência, o easyCoexistence envia um e-mail ao dono sobre posts com falha em um canal; o post fica em Precisa de atenção.
Onde o TikTok informa o motivo da falha de um post?
Depois da chamada de publicação, que só inicia a tarefa: o código 0 significa que o TikTok aceitou, não que o post vai ao ar. GET /business/publish/status/ então retorna FAILED com reason, e um app inscrito nos webhooks de publicação recebe post.publish.failed com o mesmo reason e o publish_id. O /v2/post/publish/status/fetch/ da Content Posting API retorna o campo como fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}O que significa cada motivo de falha, e o que o corrige?
Os motivos do TikTok, conforme descritos na sua referência de eventos de publicação de posts, ao lado da correção indicada por cada um. Os quatro primeiros são verificações que o TikTok faz no arquivo depois de baixá-lo, todas marcadas como não repetíveis. A tabela de falhas do TikTok ainda dá 60 segundos como o vídeo mais longo para duration_check_failed, enquanto o endpoint de vídeo documenta 600, ou o próprio max_video_post_duration_sec da 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 pelo download ou pelo próprio TikTok. As demais precisam de outro arquivo ou legenda, de uma pausa, ou de nada:
- Repetir como está: internal, e
video_pull_failedouphoto_pull_failedquando a URL estiver pública e rápida o bastante. - Repetir com um arquivo novo:
file_format_check_failed,duration_check_failed,frame_rate_check_failedepicture_size_check_failed. - Repetir com uma legenda nova:
spam_risk_text. - Aguardar, ou publicar pelo app do TikTok:
spam_risk_too_many_posts. - Não repetir:
auth_removedespam_risk, como o TikTok orienta, ouspam_risk_user_banned_from_posting.
Em que as falhas da Content Posting API diferem?
Os mesmos motivos, com outro campo e outro endpoint, e recusas que acontecem antes de o processamento começar. /v2/post/publish/status/fetch/ retorna fail_reason, permite 30 requisições por minuto por token de usuário, e acrescenta orientação de não repetir para spam_risk_user_banned_from_posting e spam_risk_text. Várias recusas chegam na chamada de init, com HTTP 403:
spam_risk_too_many_posts: o criador atingiu o limite diário de posts da API.unaudited_client_can_only_post_to_private_accounts: um app não auditado tentou publicar para uma conta pública.url_ownership_unverified:PULL_FROM_URLa partir de um domínio ou prefixo que o app não verificou.privacy_level_option_mismatch: umprivacy_levelausente ou fora das opções do criador.reached_active_user_cap: o app atingiu a cota diária de usuários ativos para publicação.
O que falha antes de o TikTok ver o post?
O que o easyCoexistence pode detectar primeiro, com uma mensagem própria em vez de um motivo do TikTok. A mídia de um post agendado é copiada no momento do agendamento, e um link que retorna uma página web, um 404, o tipo errado, ou um arquivo acima de 30 MB para imagem ou 1 GB para vídeo é recusado nessa hora. Links de foto que terminam em .png, .gif, .bmp, .heic, .avif ou .svg são recusados antes de qualquer envio, um canal que precisa ser reconectado no momento da publicação falha com o motivo reconnect, e remover um canal cancela os seus posts agendados.
Como o easyCoexistence informa um post do TikTok com falha?
Pela sua fila de publicação, que acompanha cada post do TikTok depois da chamada de publicação, consultando /business/publish/status/ a cada 20 segundos até PUBLISH_COMPLETE. Um status FAILED faz o post falhar, e o erro traz o motivo do TikTok entre parênteses, como frame_rate_check_failed, e cada falha carrega um failure_kind:
- refused: o TikTok respondeu não, como em um status FAILED e o seu motivo.
- uncertain: a chamada de publicação não obteve resposta clara, ou o TikTok não confirmou em até 2 horas, então o post pode estar no ar (
may_be_published). - reconnect: o TikTok recusou o token da conta, e ela precisa de um novo login.
- internal: o easyCoexistence falhou antes de entregar o post, então nada foi enviado.
Como encontrar e repetir um post com falha?
O dono recebe um e-mail por falha encontrada em segundo plano, no máximo um por canal a cada 3 horas, e a URL de eventos de uma plataforma recebe post.failed. O post aparece em Precisa de atenção na tela de Posts, com Repetir, Reconectar e Descartar, e list_scheduled_posts o devolve ao Claude ou ao ChatGPT. retry_scheduled_post publica de novo, agora, a partir dos arquivos mantidos por 7 dias após a falha; quando may_be_published for true, consulte antes list_social_posts e passe confirm somente se o post não estiver lá. Um post que precisa de novo arquivo ou legenda é agendado de novo 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
- Repetir uma falha de verificação com o mesmo arquivo. O TikTok marca as falhas de formato, duração, taxa de quadros e tamanho da imagem como não repetíveis.
- Repetir spam_risk_too_many_posts de imediato. O TikTok conta posts via API nas últimas 24 horas e sugere publicar pelo app móvel.
- Repetir um post marcado como may_be_published sem conferir. O TikTok pode tê-lo publicado; confira os posts mais recentes da conta, ou ele sai duas vezes.
- Procurar fail_reason na API for Business. O endpoint de status dela informa o campo reason; fail_reason pertence à Content Posting API.
De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que significa picture_size_check_failed no TikTok?
O TikTok baixou o post e encontrou a imagem abaixo do mínimo de 360 pixels de altura e largura; é preciso um arquivo maior, já que o TikTok marca a falha como não repetível.
O que é video_pull_failed?
O TikTok não conseguiu baixar o vídeo da sua URL, ou não dentro do tempo limite de uma hora. Confira se a URL está pública e sem limite de banda, e então repita.
Quanto tempo dura spam_risk_too_many_posts?
O TikTok conta os posts feitos pela API nas últimas 24 horas, cerca de 15 por dia por conta, e sugere publicar pelo app móvel do TikTok enquanto isso.
O easyCoexistence repete sozinho um post do TikTok com falha?
Não depois que o TikTok informa FAILED: o post fica em Precisa de atenção e o dono recebe um e-mail, e Repetir ou retry_scheduled_post o envia de novo.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em