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.
Código de retorno do TikTok quando o token de acesso está vazio; a correção é enviar um válido.
Cabeçalho obrigatório que carrega o token da conta do TikTok nos endpoints da Accounts API.
Parâmetro que identifica a conta do TikTok em cada chamada, definido como o open_id retornado junto com o token.
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.
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.
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