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.
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.
Scope subjacente a is_business_account e has_advanced_access nos dados de perfil de uma conta.
Scope que o titular tem de conceder, e manter ativo, para a aplicação receber eventos de webhook comment.update.
Scope de que um token precisa para carregar uma publicação como rascunho em vez de a publicar.
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:
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_nameeprofile_image. - user.info.username: username, que exigia user.info.basic até junho de 2023.
- user.info.profile:
profile_deep_link,bio_descriptioneis_verified. - user.info.stats:
following_count,followers_count,total_likesevideos_count. - user.account.type:
is_business_accountehas_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 evideo_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_draftouis_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.
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.
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