EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Erro 40104 do TikTok: token de acesso vazio

O erro 40104 do TikTok significa que a requisição chegou sem token de acesso. Endpoints da Accounts API, como /business/video/list/ e /business/comment/list/, esperam o token da conta do TikTok em um cabeçalho chamado Access-Token. Adicione esse cabeçalho com um token válido, obtido em /tt_user/oauth2/token/ ou renovado com o refresh token, e envie a requisição novamente.

O easyCoexistence adiciona o token atual da conta do TikTok, no cabeçalho Access-Token, a cada chamada feita para o Claude, o ChatGPT ou o seu próprio código.

40104

Código de retorno do TikTok quando o token de acesso está vazio; a correção é enviar um válido.

Access-Token

Cabeçalho obrigatório que carrega o token da conta do TikTok nos endpoints da Accounts API.

business_id

Parâmetro que identifica a conta do TikTok em cada chamada, definido como o open_id retornado junto com o token.

Bearer

O token_type que o TikTok retorna com o token de acesso de uma conta do TikTok, que continua sendo enviado em Access-Token.

O que significa o erro 40104?

O TikTok recebeu a chamada sem token de acesso. O apêndice de códigos de retorno lista o 40104 como token de acesso vazio, com a mesma correção dos outros erros de token: usar um token de acesso válido e repetir a chamada. A requisição chegou ao TikTok, mas nada nela indicava sob qual autorização ela age, então o TikTok a trata como sem sucesso.

Onde fica o token?

Em um cabeçalho chamado Access-Token. As referências da Accounts API, de publicação a comentários e insights, listam Access-Token como cabeçalho obrigatório com o token que a conta do TikTok autorizou. A conta em si é indicada à parte, em business_id, definido como o open_id que veio junto com o token.

An Accounts API call with its token
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","caption","video_views"]'

Como o cabeçalho fica vazio?

O token se perde em algum ponto entre o armazenamento e a requisição. Estes são os lugares para verificar:

  • O cabeçalho tem outro nome. Um token enviado como Authorization: Bearer deixa Access-Token vazio, mesmo que o TikTok informe o tipo do token como Bearer.
  • A variável que guarda o token está vazia, por exemplo após uma renovação que falhou sem que o erro fosse verificado.
  • O token vai no corpo ou na query string em vez do cabeçalho.
  • Um helper escrito para /tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/ é reaproveitado; esses endpoints não recebem o cabeçalho Access-Token, então o helper não envia nenhum.

Como corrigir?

Envie o token em Access-Token, junto com business_id. Se não houver um token atual para enviar, obtenha um: renove com /tt_user/oauth2/refresh_token/ enquanto o refresh token for válido, ou peça ao dono da conta que autorize o app novamente caso não seja. Ao depurar, registre se o cabeçalho está presente e o tamanho do seu valor, em vez do próprio token, já que o TikTok observa que quem tiver o token pode usá-lo.

Erros comuns

  • Tratar o 40104 como token expirado. O token está ausente, não velho, então renová-lo não muda nada até que o código de fato o envie.
  • Renovar o token sem repassar o novo. A renovação devolve um novo access token, e as chamadas seguintes devem enviar esse valor em Access-Token.
  • Repetir a requisição sem alterações. Sem o cabeçalho, cada tentativa chega ao TikTok do mesmo jeito e recebe o mesmo código.
Fazendo isso com o EasyCoexistence

Se o TikTok responder 40102, 40104 ou 40105 mesmo assim, a conexão é marcada para reconexão imediatamente e você recebe um e-mail. De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e 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 enviar um token de acesso do TikTok como Authorization: Bearer?

Não. Os endpoints da Accounts API leem o token do cabeçalho Access-Token, então um token enviado como Authorization: Bearer fica vazio e a chamada retorna 40104, mesmo que o TikTok informe o tipo do token como Bearer.

O 40104 é o mesmo que um token expirado?

Não. O 40104 significa que nenhum token chegou; um token expirado retorna 40102, e um token inválido ou incorreto retorna 40105.

Os endpoints de token do TikTok precisam de Access-Token?

Não. /tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/ identificam o app com client_id e client_secret no corpo da requisição.

O business_id substitui o token?

Não. O business_id indica sobre qual conta do TikTok é a chamada, e o Access-Token carrega a autorização para agir em nome dela. Toda chamada precisa dos dois.

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