Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Scopes da TikTok API for Business: o que desbloqueia cada permissão

A API for Business da TikTok concede acesso em duas camadas. A aplicação de programador detém permissões em TikTok Accounts, como Video Publish e Manage Account Comment, que abrem endpoints. A autorização do titular da conta atribui ao token de acesso os scopes, como user.insights e video.list, que decidem os campos devolvidos. /tt_user/token_info/get/ lista os scopes que um token transporta.

A easyCoexistence pede ao titular da conta TikTok as permissões da sua aplicação de programador num único início de sessão, para que o Claude, o ChatGPT ou o seu próprio código possam publicar, tratar comentários e ler métricas através das suas ferramentas, e get_social_credentials dá ao seu próprio código o mesmo token para outros endpoints da Accounts API.

18000000

ID de scope de TikTok Accounts, a permissão de primeiro nível acima dos endpoints de perfil, publicações, comentários e publicação da Accounts API.

user.account.type

Scope subjacente a is_business_account e has_advanced_access nos dados de perfil de uma conta.

comment.list

Scope que o titular tem de conceder, e manter ativo, para a aplicação receber eventos de webhook comment.update.

video.upload

Scope de que um token precisa para carregar uma publicação como rascunho em vez de a publicar.

2 to 3 days

Dias úteis que pode demorar a revisão da TikTok a uma alteração de permissões de uma aplicação de programador.

Quais são as duas camadas das permissões da TikTok?

Permissões da aplicação e scopes do token. As permissões da aplicação escolhem-se em My Apps, na aplicação, em Scope of permission, e a TikTok revê-as; existem em três níveis, e uma permissão de primeiro nível cobre todos os endpoints abaixo dela. Os scopes do token são o que o titular da conta aprovou ao autorizar a aplicação, devolvidos como scope, uma string separada por vírgulas, com cada token. Uma chamada precisa da permissão da aplicação para o seu endpoint, e alguns campos da resposta também precisam de um scope no token.

Que permissão da aplicação abre cada endpoint?

A referência da API da TikTok indica, para cada endpoint da Accounts API, a permissão em TikTok Accounts que o abre, ou nenhuma. A sua referência de scopes de permissão e o guia de webhooks chamam aos mesmos grupos Business User, Business Media, Business Comment e Business Content, por isso convém conhecer os dois conjuntos de nomes:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Que scopes do token desbloqueiam que campos?

As referências da TikTok para /business/get/ e /business/video/list/ indicam uma permissão necessária para cada campo da resposta, e duas outras funcionalidades referem um scope próprio:

  • user.info.basic: display_name e profile_image.
  • user.info.username: username, que exigia user.info.basic até junho de 2023.
  • user.info.profile: profile_deep_link, bio_description e is_verified.
  • user.info.stats: following_count, followers_count, total_likes e videos_count.
  • user.account.type: is_business_account e has_advanced_access.
  • user.insights: as métricas diárias da conta e as repartições de seguidores por idade, género, país e cidade.
  • video.list: campos de publicação como item_id, caption, share_url, likes, comments, shares, reach e video_views.
  • video.insights: tempo de visualização, taxa de visualização completa, retenção, origens de tráfego, repartições de espectadores e os cliques que uma publicação gera.
  • comment.list: o webhook comment.update, que a TikTok descreve como leitura dos comentários e respostas de conteúdo dentro da app.
  • video.upload: carregar uma publicação de vídeo ou foto como rascunho, com upload_to_draft ou is_draft.

Como ver os scopes de um token?

Consulte /tt_user/token_info/get/, que recebe o app_id e o token de acesso e devolve o scope do token e o creator_id da conta. Os exemplos de strings de scope da TikTok incluem também video.publish e comment.list.manage, cujos nomes coincidem com os endpoints de publicação e de gestão de comentários, embora as suas referências não associem nenhum campo a nenhum deles.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

O que pede a ligação TikTok da easyCoexistence?

As permissões que a aplicação de programador da easyCoexistence detém, todas visíveis no ecrã de consentimento da TikTok. A easyCoexistence encaminha o titular da conta para o URL de autorização do titular da conta TikTok que o portal da TikTok gera para a sua aplicação, o qual já indica essas permissões, e acrescenta apenas um valor state próprio. O titular aprova o que a TikTok mostra, e a string de scope que a TikTok devolve fica guardada com a ligação. Os endpoints que a easyCoexistence depois chama para a conta:

  • /business/get/ para o perfil, as métricas diárias e as repartições de seguidores.
  • /business/video/list/ para as publicações e as respetivas métricas.
  • /business/video/publish/, /business/photo/publish/ e /business/publish/status/ para publicação.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ e /business/comment/delete/ para comentários.
  • /business/webhook/update/, ao nível da aplicação, para o webhook de comentários.

Como se acrescenta uma permissão mais tarde?

Em dois passos, um por camada. Para a aplicação, abra My Apps, a aplicação, Scope of permission, edite-o, indique um motivo que corresponda aos novos scopes e submeta; a revisão da TikTok pode demorar dois a três dias úteis e, desde 20 de março de 2026, um pedido que inclua TikTok Accounts exige primeiro o Accounts API Access Application Form. Para o token, o titular autoriza de novo a aplicação, pois um token mantém os scopes aprovados quando foi emitido.

O que acontece quando falta uma permissão?

Numa chamada, o código de retorno da TikTok é 40001, sem permissão para executar a operação associada, e a correção indicada remete para a referência de scopes de permissão. Num campo, as referências só o disponibilizam depois de o titular ter concedido o seu scope, e a solução indicada é que o titular autorize de novo a aplicação com esse scope. Consulte o scope do token com /tt_user/token_info/get/ antes de a pedir.

Erros comuns

  • Esperar que as contas ligadas ganhem sozinhas uma nova permissão da aplicação. Os tokens mantêm os scopes aprovados na autorização até que cada titular volte a autorizar a aplicação.
  • Pedir is_business_account sem user.account.type. A TikTok só disponibiliza esse campo e has_advanced_access a tokens que tenham esse scope.
  • Esperar por comment.update sem comment.list. A TikTok só envia eventos de comentários enquanto a autorização do titular com esse scope se mantiver válida.
  • Procurar no token nomes de permissões da aplicação. A string de scope usa nomes como video.list, enquanto nomes como Get Account Media pertencem às definições da aplicação.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Que scopes usa a TikTok API for Business?

Scopes do token como user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list e video.upload, concedidos pelo titular da conta além das permissões da aplicação em TikTok Accounts.

Que permissões exige o webhook de comentários da TikTok?

A aplicação precisa de TikTok Accounts e de Business Comment, e o titular tem de conceder comment.list. Os eventos param se essa autorização expirar ou for revogada.

Um novo scope da TikTok aplica-se aos tokens já emitidos?

Não. Um token mantém os scopes aprovados quando foi emitido, por isso o titular da conta tem de autorizar a aplicação de novo para acrescentar um novo.

Quanto tempo demora a TikTok a aprovar uma nova permissão?

A TikTok diz que a revisão de uma alteração de permissões pode levar dois a três dias úteis, e os pedidos que acrescentam TikTok Accounts precisam primeiro do Accounts API Access Application Form.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em