Configurações de publicação do TikTok pela API: privacidade, comentários, Duet e Stitch
A API for Business do TikTok recebe as configurações de uma postagem na chamada de publicação, em sua maior parte dentro de post_info. Vídeos aceitam disable_comment, disable_duet e disable_stitch, uma capa definida por thumbnail_offset ou custom_thumbnail_url, os rótulos is_brand_organic e is_branded_content, e is_ai_generated. Postagens de foto aceitam privacy_level, disable_comment, os mesmos rótulos de marca e auto_add_music. GET /business/video/settings/ retorna os valores permitidos para cada conta.
A easyCoexistence publica vídeos e postagens de foto do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código, com a legenda, o título de uma postagem de foto e comentários ativados ou desativados, e get_social_credentials entrega ao seu próprio código o token para ler as configurações permitidas da conta.
Opções de privacidade para as postagens de foto de uma conta pública: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.
Nível de privacidade que uma conta privada recebe no lugar de PUBLIC_TO_EVERYONE: visível somente para os seus seguidores.
Padrão de disable_comment, disable_duet e disable_stitch, então comentários, Duets e Stitches permanecem ativados, a menos que sejam definidos.
Maior imagem de capa personalizada para um vídeo, que deve ter pelo menos 360 x 360 pixels e até 20 MB.
Rótulo que is_branded_content aplica; ele prevalece quando is_brand_organic também é true.
Campo obrigatório do post_info de uma postagem de foto, limitado às opções que GET /business/video/settings/ retorna para a conta.
Quais configurações cada endpoint de publicação aceita?
/business/video/publish/ e /business/photo/publish/ compartilham algumas configurações e diferem em outras. A maioria fica dentro de post_info, enquanto custom_thumbnail_url e photo_cover_index ficam no nível superior do corpo. Lado a lado, como as referências do TikTok as listam, com Sem campo onde um endpoint não documenta nada para aquela configuração:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
O que a conta permite?
GET /business/video/settings/ com business_id retorna os limites da conta para as suas postagens. Consulte antes de publicar, já que o TikTok aceita apenas os valores que ela lista:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSeSELF_ONLYpara uma conta pública;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSeSELF_ONLYpara uma conta privada.comment_disabled: true quando a conta não aceita comentários de ninguém, e entãodisable_commentaceita apenas true.duet_disabledestitch_disabled: true quando a conta permite Duet ou Stitch apenas para Somente você, ou é privada; a opção correspondente então aceita apenas true.max_video_post_duration_sec: o vídeo mais longo que a conta pode publicar; um vídeo maior falha.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Quem pode ver a postagem?
Em uma postagem de foto, o privacy_level que você envia: PUBLIC_TO_EVERYONE para pessoas dentro ou fora do TikTok, MUTUAL_FOLLOW_FRIENDS para seguidores que a conta segue de volta, FOLLOWER_OF_CREATOR para os seguidores de uma conta privada, ou SELF_ONLY. O endpoint de vídeo não tem campo de privacidade, já que publica vídeos públicos. Uma postagem definida como Amigos ou Somente você também não pode ser assistida pelo seu embed_url.
Como funcionam comentários, Duet e Stitch?
Cada um é uma opção que desliga o recurso quando definida como true. disable_comment existe nos dois endpoints; disable_duet e disable_stitch existem apenas em vídeos. Todos têm false como padrão, o que mantém o recurso ativo, dentro do que as próprias configurações de privacidade da conta permitem: uma conta que não aceita comentários de ninguém, ou que limita Duet ou Stitch a Somente você, só pode publicar com essa opção definida como true.
Como a capa é escolhida?
Em um vídeo, de duas formas. post_info.thumbnail_offset escolhe um quadro pelo seu tempo em milissegundos, 0 por padrão, arredondado para o quadro mais próximo; um tempo além do fim do vídeo envia um webhook de falha e o vídeo não é publicado. custom_thumbnail_url, no nível superior do corpo, usa uma imagem no lugar e faz o TikTok ignorar o offset. Em uma postagem de foto, photo_cover_index escolhe uma das imagens, contando a partir de 0.
- Imagem de capa personalizada: JPG, JPEG, WebP ou PNG, até 20 MB.
- Tamanho: de 360 x 360 pixels até 1080 x 1920, ou 1920 x 1080.
- Localização: um domínio ou prefixo de URL verificado para o app, como o próprio vídeo.
O que significam os rótulos de marca?
Divulgações que o TikTok exibe na postagem. is_brand_organic definido como true rotula a postagem como Conteúdo promocional, para postagens que promovem o negócio da própria conta. is_branded_content definido como true rotula como Parceria paga, para postagens feitas em parceria paga com uma marca, e prevalece quando ambos são true. Em um vídeo com is_branded_content, tto_invite_link pode vincular a postagem a uma campanha do TikTok One Creator Marketplace da qual a conta participa.
Quais outras opções ficam em post_info?
Algumas mais, cada uma documentada no endpoint que a recebe:
is_ai_generated, vídeos: rotula a postagem como Criador rotulou como gerado por IA, o que não pode ser alterado depois de publicada.location_idcomlocation_name: uma marcação de localização encontrada por GET /business/publish/location/.music_sound_info: um som comercial pelo ID; em vídeos também seu volume, de 0 a 100, e seu início e fim em milissegundos.auto_add_music, postagens de foto: adiciona música recomendada, que pode ser alterada depois no app do TikTok.upload_to_draftouis_draft: envia a postagem para a caixa de entrada do criador como rascunho, com o vídeo, usando o escopo video.upload.is_ads_only, vídeos: publica uma postagem 'Only show in ads' que fica fora do perfil.
Quais configurações o publish_tiktok_post define?
Três vêm da sua requisição: a legenda, o título de uma postagem de foto e disable_comment. A easyCoexistence envia is_brand_organic e is_branded_content como false, publica postagens de foto como PUBLIC_TO_EVERYONE com a primeira imagem como capa, e deixa de fora o restante das configurações de um vídeo, para que valham os padrões do TikTok: disable_duet e disable_stitch como false, thumbnail_offset 0 e is_ai_generated como false.
Como você envia as outras configurações?
A partir do seu próprio código, com o token e o business_id da conta de get_social_credentials, em caminhos da Business API sob business/. Um GET para business/video/settings/ lê os limites da conta. Um POST para business/video/publish/ ou business/photo/publish/ pode conter o corpo completo documentado, e ele chega ao TikTok como escrito, incluindo as URLs de mídia, por isso elas precisam estar em um domínio ou prefixo de URL verificado para o app; publish_tiktok_post é a chamada que direciona o seu link pela rota de mídia verificada da easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Erros comuns
- Esperar que privacy_level funcione em um vídeo. O endpoint de vídeo publica postagens públicas e sua referência não lista nenhum campo de privacidade; postagens de foto aceitam privacy_level.
- Ativar comentários para uma conta que não aceita nenhum. Quando comment_disabled é true, o TikTok aceita disable_comment apenas como true.
- Definir thumbnail_offset além do fim do vídeo. O TikTok envia um webhook de falha e o vídeo não é publicado.
- Enviar PUBLIC_TO_EVERYONE para uma conta privada. Suas privacy_level_options listam FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY no lugar.
De US$ 9 a 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
Posso publicar um vídeo privado do TikTok pela API?
Não com o endpoint de vídeo, que publica postagens públicas. Postagens de foto aceitam privacy_level, inclusive SELF_ONLY, e um vídeo pode ir para a caixa de entrada do criador como rascunho com upload_to_draft.
Como desativo Duets e Stitches pela API?
Defina post_info.disable_duet e post_info.disable_stitch como true em /business/video/publish/. Quando a conta já os limita, o TikTok aceita apenas true.
Posso adicionar uma marcação de localização pela API do TikTok?
Sim. post_info aceita location_id com location_name, para uma marcação de localização encontrada por GET /business/publish/location/.
Qual é a diferença entre is_brand_organic e is_branded_content?
is_brand_organic adiciona o rótulo Conteúdo promocional para o negócio da própria conta; is_branded_content adiciona o rótulo Parceria paga e prevalece quando ambos são true.
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