EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Enviar um vídeo aos rascunhos de um criador no TikTok pela API

As APIs do TikTok enviam um vídeo aos rascunhos do criador com o fluxo de upload: o /v2/post/publish/inbox/video/init/ da Content Posting API envia sob o escopo video.upload, e o TikTok notifica o criador na caixa de entrada para editar e publicar no app. A API for Business faz o mesmo com upload_to_draft em /business/video/publish/, ou com is_draft em posts de foto.

O easyCoexistence publica vídeos e posts de foto do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou da sua própria plataforma, agora ou em uma data e hora com até 90 dias de antecedência, com cada publicação agendada visível na tela Posts até sair.

video.upload

Escopo que o TikTok define como compartilhar conteúdo na conta do criador como rascunho, para editar e publicar no TikTok.

5 pending

Número máximo de compartilhamentos pendentes que a Content Posting API permite em qualquer período de 24 horas, limite que o TikTok define para reduzir spam.

SEND_TO_USER_INBOX

O status /business/publish/status/ informa quando um rascunho foi enviado e o TikTok notificou a caixa de entrada do criador.

6 a minute

Requisições que cada token de acesso de usuário pode enviar ao endpoint de upload da Content Posting API.

Ignored

O que acontece com os demais campos de post_info quando upload_to_draft é true em /business/video/publish/.

Em que um rascunho difere de uma publicação direta?

Em quem aperta Publicar. Uma publicação direta vai ao ar quando o TikTok a processa; um rascunho cai na caixa de entrada do TikTok do criador e só é publicado quando ele o abre, edita como quiser e publica. A diferença atravessa as duas APIs de publicação do TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent in the call

Como a Content Posting API envia um rascunho?

Com um POST para https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, um token de acesso de usuário com video.upload e um objeto source_info. PULL_FROM_URL faz o TikTok buscar o vídeo em um domínio ou prefixo de URL que o app verificou; FILE_UPLOAD retorna um upload_url, para o qual o arquivo é enviado em partes com requisições PUT. O publish_id retornado vai para /v2/post/publish/status/fetch/, fotos usam /v2/post/publish/content/init/ com post_mode definido como MEDIA_UPLOAD, e o TikTok pede que os apps orientem os usuários a abrir a notificação na caixa de entrada para continuar a edição no TikTok:

Upload a video to the creator's inbox from a URL
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
  -H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "source_info": {
      "source": "PULL_FROM_URL",
      "video_url": "https://media.example.com/tiktok/draft.mp4"
    }
  }'

# data.publish_id: pass it to /v2/post/publish/status/fetch/

Quais limites se aplicam aos rascunhos da Content Posting API?

O TikTok documenta estes na sua referência de upload, cada um retornado pela chamada init quando se aplica:

  • Rascunhos pendentes: no máximo 5 compartilhamentos pendentes em qualquer período de 24 horas; depois disso, spam_risk_too_many_pending_share com HTTP 403.
  • Requisições: 6 por minuto por token de acesso de usuário, depois rate_limit_exceeded com HTTP 429.
  • Escopo: um token sem video.upload recebe scope_not_authorized com HTTP 401.
  • Mídia: PULL_FROM_URL a partir de um domínio ou prefixo que o app não verificou recebe url_ownership_unverified com HTTP 403.

Como a API for Business envia um rascunho?

Com seus endpoints de publicação e mais um campo em post_info. Em /business/video/publish/, upload_to_draft definido como true envia o vídeo como rascunho, e o TikTok ignora os demais campos de post_info; em /business/photo/publish/, is_draft mantém apenas o título e a legenda. Ambos precisam de video.upload no token da conta, que /tt_user/token_info/get/ lista; sem ele, o dono aprova o envio de rascunhos autorizando o app novamente. A mídia continua em uma URL verificada, o status indica SEND_TO_USER_INBOX, e o criador encontra o rascunho pela notificação na caixa de entrada:

Send a video to the creator's drafts on the API for Business
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/draft.mp4",
    "post_info": {
      "upload_to_draft": true,
      "is_brand_organic": false,
      "is_branded_content": false
    }
  }'

O que o criador faz com o rascunho?

Finaliza no TikTok. A notificação na caixa de entrada abre o vídeo ou as fotos enviadas no editor do TikTok, onde o criador revisa, edita e publica. Na Content Posting API, o status muda de SEND_TO_USER_INBOX para PUBLISH_COMPLETE quando o criador publica a partir do rascunho, e o TikTok observa que um rascunho pode gerar mais de uma publicação.

O easyCoexistence envia rascunhos?

Não: publish_tiktok_post publica. Ele chama /business/video/publish/ ou /business/photo/publish/ sem upload_to_draft nem is_draft, então a publicação vai ao ar quando o TikTok a processa. Para segurar uma publicação para revisão, agende-a com scheduled_at, de 1 minuto a 90 dias à frente: ela espera em Próximas na tela Posts, update_scheduled_post altera o horário, a legenda ou o título de uma publicação de foto, e cancel_scheduled_post a interrompe antes de sair.

Erros comuns

  • Pedir video.publish para enviar rascunhos. Rascunhos exigem video.upload, o escopo que o TikTok descreve como compartilhar conteúdo como rascunho.
  • Definir uma legenda em um rascunho de vídeo pela API for Business. Com upload_to_draft true, o TikTok ignora o restante de post_info.
  • Enviar rascunhos mais rápido do que os criadores publicam. A Content Posting API para em 5 compartilhamentos pendentes em 24 horas, com spam_risk_too_many_pending_share.
  • Deixar os usuários sem um caminho até a caixa de entrada. O TikTok pede que os apps os orientem a abrir a notificação na caixa de entrada para concluir a publicação.
Fazendo isso com o EasyCoexistence

De US$ 9 até US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os 3 primeiros 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

Dá para salvar um vídeo como rascunho pela API do TikTok?

Sim. O fluxo de upload o coloca na caixa de entrada do TikTok do criador, onde ele edita e publica; o token precisa do escopo video.upload.

Onde aparece um rascunho enviado pela API?

No app do TikTok, atrás de uma notificação na caixa de entrada que abre o vídeo no editor do TikTok para o criador concluir.

Um rascunho do TikTok mantém minha legenda?

Na API for Business, um rascunho de foto mantém o título e a legenda, enquanto um rascunho de vídeo descarta os demais campos de post_info.

Um rascunho do TikTok pode virar mais de uma publicação?

Sim. O TikTok observa que um rascunho pode gerar mais de uma publicação, e na Content Posting API o status muda para PUBLISH_COMPLETE quando o criador publica a partir dele.

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