EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

reason

O campo /business/publish/status/ só retorna quando o status é FAILED, com valores como frame_rate_check_failed.

fail_reason

O nome que a Content Posting API dá ao mesmo campo, nas respostas de /v2/post/publish/status/fetch/.

1 hour

Tempo limite de download após o qual o TikTok falha um post com video_pull_failed ou photo_pull_failed.

24 hours

Janela por trás de spam_risk_too_many_posts; o TikTok sugere publicar esse post pelo app móvel.

3 hours

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:

A failed post in /business/publish/status/, from TikTok's example
{
  "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 foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing 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_failed ou photo_pull_failed quando 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_failed e picture_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_removed e spam_risk, como o TikTok orienta, ou spam_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_URL a partir de um domínio ou prefixo que o app não verificou.
  • privacy_level_option_mismatch: um privacy_level ausente 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.

Failed posts through MCP
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.
Fazendo isso com o EasyCoexistence

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