Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Por qué una conexión con la API de TikTok deja de funcionar y cómo mantenerla activa

Una conexión con TikTok API for Business deja de funcionar cuando no se renueva su token de acceso de 24 horas, se agota el refresh token de un año, el titular quita el acceso de la app o el token enviado falta o es incorrecto. TikTok informa los casos de token como 40102, 40103, 40104 y 40105. Renovar con antelación, revisar cada cuenta según un calendario y pedir al titular que autorice de nuevo antes de que termine el año la mantienen activa.

easyCoexistence mantiene cada conexión de TikTok activa por su cuenta: renueva el token de 24 horas con antelación, revisa la cuenta aproximadamente cada 6 horas y, cuando TikTok rechaza el token, marca el canal como Requiere reconexión y te envía un correo, para Claude, ChatGPT o tu propia plataforma.

24 hours

Vida del token de acceso de la cuenta de TikTok desde la API for Business; /tt_user/oauth2/refresh_token/ lo renueva.

1 year

Vida del refresh token; una vez vencido, el titular de la cuenta debe volver a autorizar la app.

auth_removed

Motivo de fallo cuando el titular quita el acceso de la app mientras TikTok procesa una publicación; TikTok indica no reintentar.

comment.update

Eventos que TikTok deja de enviar para una cuenta cuando vence o se revoca la autorización del titular.

5 reasons

Motivos por los que se dispara authorization.removed de TikTok for Developers: el usuario se desconecta, la cuenta se elimina, cambia la edad, hay un baneo o el desarrollador revoca.

6 hours

Frecuencia con la que easyCoexistence revisa cada cuenta de TikTok conectada; renueva el token de 24 horas por su cuenta y te envía un correo si hace falta reconectar.

¿Por qué deja de funcionar una conexión con la API de TikTok?

Por unas pocas razones, casi todas ligadas a los tokens de la cuenta o al consentimiento del titular. Algunas cortan la conexión por completo, mientras que otras la dejan a medias, con algunas llamadas rechazadas y el resto respondiendo:

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

¿Qué error devuelve cada causa y cómo se soluciona?

El campo code de TikTok identifica la mayoría, dentro de una respuesta HTTP 200 y no de un estado de error, y el estado de publicación añade un motivo de fallo propio. 40100 aparece en la tabla porque una llamada limitada puede parecer una conexión perdida. Qué significa cada una y cómo solucionarla:

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

¿Cuánto duran los tokens y cuándo conviene renovarlos?

En la API for Business, el token de acceso dura 24 horas y expires_in, en cada respuesta de token, indica los segundos que quedan; el refresh token dura un año, con su propia cuenta regresiva en refresh_token_expires_in. Renueva bien antes de que termine el día, según un calendario y no después de una llamada fallida, y guarda el refresh token que devuelve cada renovación, porque la nota de TikTok sobre ese campo indica conservarlo. Trata refresh_token_expires_in como una fecha límite: en el ejemplo de renovación de TikTok cuenta hacia atrás en lugar de iniciar un año nuevo.

¿Qué pasa cuando el titular quita el acceso de la app?

La app pierde los permisos de la API de Cuentas que el titular concedió, así que las llamadas con ese token dejan de funcionar, y TikTok no documenta ningún evento de la API for Business que lo anuncie. El titular puede hacerlo en cualquier momento desde la app de TikTok, en Configuración y privacidad, Seguridad, Gestionar permisos de la app, Quitar acceso. Las señales aparecen en otro lugar: una publicación que TikTok estaba procesando falla con auth_removed, motivo para el que TikTok indica no reintentar, y los eventos comment.update de la cuenta dejan de llegar.

¿Qué hace un cambio de tipo de cuenta con la conexión?

TikTok no asocia ningún error de token a este cambio en su documentación; lo que cambia es lo que devuelve la API. Datos como unique_video_views, daily_new_followers y audience_activity requieren Advanced Access o una Verified Business Account, igual que las API de Menciones y Business Messaging, y privacy_level_options de una cuenta privada omite PUBLIC_TO_EVERYONE. Desde el 16 de octubre de 2026, is_business_account es true solo para las Verified Business Accounts y has_advanced_access indica el Advanced Access; leer ambos, bajo user.account.type, muestra un cambio antes de que una llamada tropiece con él.

¿Cómo detectas una conexión caída antes que un cliente?

Con comprobaciones que se ejecutan aunque nadie esté publicando:

  • Una llamada ligera por cuenta según un calendario, como /business/get/ con el campo username, que devuelve un error de token cuando el token deja de funcionar.
  • /tt_user/token_info/get/, que no requiere permiso y devuelve el alcance del token, para confirmar que los permisos siguen cubriendo lo que llaman tus funciones.
  • refresh_token_expires_in convertido en una fecha al llegar cada respuesta, con un recordatorio al titular semanas antes.
  • Silencio en comment.update de una cuenta que suele recibir comentarios, ya que TikTok deja de enviar esos eventos cuando vence o se revoca la autorización.
  • Los códigos 40102, 40103, 40104 y 40105 contados por cuenta, para que una cuenta que falla destaque entre muchas.

¿Cómo reconectas una cuenta?

Ejecutando de nuevo la autorización para la misma cuenta. Comparte la URL de autorización del titular de la cuenta de TikTok, con un valor state que vincule la respuesta a la cuenta, y disable_auto_auth=1 si el titular debe volver a ver la pantalla de permisos. Intercambia el nuevo auth_code en /tt_user/oauth2/token/ dentro de sus 10 minutos y reemplaza ambos tokens guardados. open_id es el ID específico de la aplicación que TikTok asigna a la cuenta, así que asocia los nuevos tokens al registro guardado mediante ese valor en lugar de crear un segundo registro.

¿Las conexiones de Content Posting API caducan de la misma forma?

No. TikTok for Developers, que ofrece las API de Content Posting y Display, actualizó sus páginas de tokens el 2 de noviembre de 2026: los tokens de acceso de usuario caducan en 2 horas y los refresh tokens duran 180 días desde su primera emisión. Sus refresh tokens rotan, de modo que cada renovación exitosa devuelve uno nuevo e invalida de inmediato el enviado, y si un servidor sigue usando un token reemplazado, las renovaciones posteriores fallan y el usuario debe autorizar de nuevo. Un refresh token incorrecto falla con invalid_grant, un token de acceso incorrecto con access_token_invalid y HTTP 401, y su webhook authorization.removed indica el motivo por el que un usuario dejó la app.

¿Qué hace easyCoexistence para mantener viva una conexión de TikTok?

Renueva y revisa por su cuenta, y te avisa cuando solo el titular puede solucionarlo:

  • Renovación: antes de una llamada cuando quedan menos de 15 minutos, y durante una revisión cuando quedan menos de 8 horas, guardando cada vez el nuevo refresh token y su vencimiento.
  • Una sola renovación a la vez por cuenta, de modo que las llamadas que llegan juntas la comparten.
  • La revisión: una llamada /business/get/ para el username de la cuenta cada 6 horas aproximadamente.
  • Un token rechazado, 40102, 40104 o 40105: el canal muestra Requiere reconexión, el titular recibe un único correo y una plataforma recibe channel.disconnected, con el mensaje de TikTok en disconnected_reason.
  • Mientras tanto, las herramientas responden que la cuenta necesita reconectarse, y una publicación programada falla con el estado reconexión en lugar de llegar a TikTok.
  • Reconectar: Conectar TikTok en la página del canal, o una nueva sesión de conexión, vuelve a iniciar sesión y mantiene el mismo account_id y el mismo destino de eventos.

Cómo configurarlo

  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.

Errores comunes

  • Tomar un webhook de comentarios silencioso por una cuenta tranquila. TikTok deja de enviar comment.update para una cuenta cuando termina su autorización, así que revisa la cuenta en lugar de esperar eventos.
  • Reconectar creando un registro nuevo. Asocia los nuevos tokens mediante open_id, el ID específico de la aplicación que TikTok asigna a la cuenta, y actualiza el registro guardado en su lugar, conservando su historial y configuración.
  • Reintentar 40103 o 40107 con el mismo refresh token. Ninguno se resuelve al reintentar: el primero necesita una nueva autorización, el segundo el refresh token de la última respuesta o una nueva autorización.
  • Leer 40100 como una conexión perdida. Es una llamada limitada; pausa el endpoint 5 minutos, o hasta las 00:00 UTC tras un límite diario, y el mismo token sigue funcionando.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Puede una conexión con la API de TikTok durar para siempre sin el titular?

No. La renovación la mantiene como mucho durante el año del refresh token; después, la vía documentada de TikTok es una nueva autorización por parte del titular de la cuenta.

¿Por qué fallaron varias cuentas de TikTok a la vez?

Revisa primero la app antes que las cuentas: 40113 significa que la app está bloqueada o que su ID y secreto no coinciden, y TikTok puede revocar el acceso de una app a la API de Cuentas por mal uso.

¿Una nueva función obliga a reconectar las cuentas de TikTok?

Sí, cuando necesita un permiso que el titular nunca concedió. Un token conserva los permisos aprobados en la autorización, así que el titular vuelve a autorizar la app para añadir uno.

¿Qué pasa con las publicaciones programadas de TikTok mientras una cuenta necesita reconectarse?

En easyCoexistence fallan con el estado reconexión en su hora programada en lugar de llegar a TikTok, se envía un correo al titular, y Reintentar las envía en cuanto la cuenta vuelve a estar conectada.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el