EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Por que uma conexão com a API do TikTok para de funcionar e como mantê-la ativa

A conexão com a API for Business do TikTok deixa de funcionar quando o seu token de acesso de 24 horas não é renovado, o refresh token de um ano expira, o dono remove o acesso do app ou o token enviado está ausente ou errado. O TikTok informa os casos de token como 40102, 40103, 40104 e 40105. Renovar antecipadamente, verificar cada conta em uma agenda e pedir ao dono que autorize de novo antes do fim do ano mantêm a conexão ativa.

O easyCoexistence mantém cada conexão com o TikTok ativa por conta própria: renova o token de 24 horas com antecedência, verifica a conta cerca de a cada 6 horas e, quando o TikTok recusa o token, marca o canal como Reconexão necessária e envia um e-mail para você, seja para Claude, ChatGPT ou sua própria plataforma.

24 hours

Validade do token de acesso de uma conta TikTok da API for Business; /tt_user/oauth2/refresh_token/ o renova.

1 year

Validade do refresh token; quando ele expira, o dono da conta precisa autorizar o app novamente.

auth_removed

Motivo de falha quando o dono remove o acesso do app enquanto o TikTok processa uma publicação; o TikTok diz para não repetir.

comment.update

Eventos que o TikTok deixa de enviar para uma conta quando a autorização do dono expira ou é revogada.

5 reasons

Motivos do disparo de authorization.removed do TikTok for Developers: o usuário se desconecta, a conta é excluída, há mudança de idade, banimento ou o desenvolvedor revoga.

6 hours

Com que frequência o easyCoexistence verifica cada conta TikTok conectada; ele renova o token de 24 horas sozinho e envia um e-mail se for preciso reconectar.

Por que uma conexão com a API do TikTok para de funcionar?

Por alguns motivos, a maioria ligada aos tokens da conta ou ao consentimento do dono. Algumas encerram a conexão de vez, enquanto outras a deixam pela metade, com algumas chamadas recusadas e as demais ainda respondendo:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Qual erro cada causa retorna e o que a corrige?

O campo code do TikTok identifica a maioria, dentro de uma resposta HTTP 200 e não de um status de erro, e o status da publicação acrescenta um motivo de falha próprio. O 40100 aparece na tabela porque uma chamada limitada pode parecer uma conexão perdida. O que cada um significa e a correção:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Quanto tempo duram os tokens e quando renovar?

Na API for Business, o token de acesso dura 24 horas, e expires_in em cada resposta de token informa os segundos restantes; o refresh token dura um ano, com sua própria contagem em refresh_token_expires_in. Renove bem antes do fim do dia, em uma agenda e não depois de uma chamada falhar, e guarde o refresh token que cada renovação devolve, já que a nota do TikTok sobre esse campo pede para retê-lo. Trate refresh_token_expires_in como um prazo: no exemplo de renovação do TikTok, ele conta para baixo em vez de iniciar um novo ano.

O que acontece quando o dono remove o acesso do app?

O app perde as permissões da Accounts API que o dono concedeu, então chamadas com esse token deixam de funcionar, e o TikTok não documenta nenhum evento da API for Business que avise isso. O dono pode fazê-lo a qualquer momento no app do TikTok, em Configurações e privacidade, Segurança, Gerenciar permissões do app, Remover acesso. Os sinais aparecem em outros lugares: uma publicação que o TikTok processava falha com auth_removed, motivo para o qual o TikTok diz não repetir, e os eventos comment.update da conta param de chegar.

O que uma mudança no tipo de conta faz com a conexão?

O TikTok não vincula nenhum erro de token a isso em sua documentação; o que muda é o que a API devolve. Dados como unique_video_views, daily_new_followers e audience_activity exigem Advanced Access ou uma Conta Comercial Verificada, assim como as APIs Mentions e Business Messaging, e o privacy_level_options de uma conta privada deixa de fora PUBLIC_TO_EVERYONE. Desde 16 de outubro de 2026, is_business_account retorna true apenas para Contas Comerciais Verificadas e has_advanced_access informa o Advanced Access, então ler os dois, em user.account.type, mostra uma mudança antes que uma chamada falhe por isso.

Como perceber uma conexão morta antes que um cliente perceba?

Com verificações que rodam independentemente de haver publicações:

  • Uma chamada leve por conta em uma agenda, como /business/get/ com o campo username, que retorna um erro de token quando o token deixa de funcionar.
  • /tt_user/token_info/get/, que não precisa de permissão e retorna o escopo do token, para confirmar que as concessões ainda cobrem o que os seus recursos chamam.
  • refresh_token_expires_in transformado em data quando cada resposta chega, com um lembrete ao dono algumas semanas antes.
  • Silêncio em comment.update de uma conta que costuma receber comentários, já que o TikTok interrompe esses eventos quando a autorização expira ou é revogada.
  • 40102, 40103, 40104 e 40105 contados por conta, para que uma conta com falha se destaque entre muitas.

Como reconectar uma conta?

Executando a autorização de novo para a mesma conta. Compartilhe a URL de autorização do titular da conta TikTok, com um valor state que vincule o retorno à conta, e disable_auto_auth=1 se o dono deve ver de novo a tela de permissões. Troque o novo auth_code em /tt_user/oauth2/token/ dentro de seus 10 minutos e depois substitua os dois tokens armazenados. open_id é o ID específico da aplicação para a conta no TikTok, então associe os novos tokens ao registro guardado por ele, em vez de criar um segundo.

As conexões da Content Posting API expiram do mesmo jeito?

Não. O TikTok for Developers, que serve as APIs Content Posting e Display, atualizou suas páginas de token em 2 de novembro de 2026: os tokens de acesso do usuário expiram em até 2 horas e os refresh tokens valem 180 dias a partir da primeira emissão. Os refresh tokens rotacionam, então cada renovação bem-sucedida devolve um novo e invalida imediatamente o enviado, e se um servidor continuar usando um token substituído, as renovações seguintes falham e o usuário precisa autorizar de novo. Um refresh token inválido falha com invalid_grant, um token de acesso inválido com access_token_invalid e HTTP 401, e o webhook authorization.removed informa o motivo da saída do usuário.

O que o easyCoexistence faz para manter uma conexão com o TikTok ativa?

Ele renova e verifica por conta própria, e avisa quando só o dono pode resolver:

  • Renovação: antes de uma chamada quando restam menos de 15 minutos, e durante uma verificação quando restam menos de 8 horas, guardando o novo refresh token e a validade a cada vez.
  • Uma renovação por vez por conta, para que chamadas que chegam juntas compartilhem a mesma.
  • A verificação: uma chamada a /business/get/ para o username da conta, cerca de a cada 6 horas.
  • Um token recusado, 40102, 40104 ou 40105: o canal mostra Reconexão necessária, o dono recebe um e-mail, e uma plataforma recebe channel.disconnected, com a mensagem do TikTok em disconnected_reason.
  • Até lá, as ferramentas respondem que a conta precisa ser reconectada, e uma publicação agendada falha com reconnect em vez de chegar ao TikTok.
  • Para reconectar: Conectar TikTok na página do canal, ou uma nova sessão de conexão, faz o login de novo e mantém o mesmo account_id e destino de eventos.

Como configurar

  1. Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
  2. Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

Erros comuns

  • Tratar um webhook de comentários silencioso como conta silenciosa. O TikTok interrompe comment.update de uma conta quando a autorização dela termina, então verifique a conta em vez de esperar eventos.
  • Reconectar criando um registro novo. Associe os novos tokens pelo open_id, o ID específico da aplicação para a conta no TikTok, e atualize o registro guardado no lugar, mantendo seu histórico e configurações.
  • Repetir 40103 ou 40107 com o mesmo refresh token. Nenhum dos dois se resolve ao repetir: o primeiro exige nova autorização; o segundo, o refresh token da resposta mais recente ou uma nova autorização.
  • Ler 40100 como conexão perdida. É uma chamada limitada; pause o endpoint por 5 minutos, ou até 00:00 UTC após um limite diário, e o mesmo token continua funcionando.
Fazendo isso com o EasyCoexistence

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

Uma conexão com a API do TikTok pode durar para sempre sem o dono?

Não. A renovação a leva no máximo pelo ano do refresh token; depois disso, o caminho documentado pelo TikTok é uma nova autorização feita pelo titular da conta.

Por que as conexões do TikTok falharam em várias contas ao mesmo tempo?

Olhe para o app antes das contas: 40113 significa que o app está bloqueado ou que o ID e o segredo não conferem, e o TikTok pode revogar o acesso de um app à Accounts API por uso indevido.

Um novo recurso exige reconectar contas do TikTok?

Quando ele precisa de um escopo que o dono nunca concedeu, sim. Um token mantém os escopos aprovados na autorização, então o dono autoriza o app de novo para acrescentar um.

O que acontece com publicações agendadas no TikTok enquanto uma conta precisa ser reconectada?

No easyCoexistence, elas falham com reconnect na hora agendada em vez de chegar ao TikTok, o dono recebe um e-mail, e Repetir as envia assim que a conta estiver conectada de novo.

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