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.
Escopo que o TikTok define como compartilhar conteúdo na conta do criador como rascunho, para editar e publicar no TikTok.
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.
O status /business/publish/status/ informa quando um rascunho foi enviado e o TikTok notificou a caixa de entrada do criador.
Requisições que cada token de acesso de usuário pode enviar ao endpoint de upload da Content Posting API.
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 posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent 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:
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_sharecom HTTP 403. - Requisições: 6 por minuto por token de acesso de usuário, depois
rate_limit_exceededcom HTTP 429. - Escopo: um token sem video.upload recebe
scope_not_authorizedcom HTTP 401. - Mídia:
PULL_FROM_URLa partir de um domínio ou prefixo que o app não verificou recebeurl_ownership_unverifiedcom 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:
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.
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