Publicar vídeos no TikTok via API parece simples até você abrir o portal de desenvolvedores pela primeira vez. Campos sem explicação, toggles escondidos, diferença entre Sandbox e Production que ninguém deixa claro — e um campo de "análise do aplicativo" que, se preenchido errado com algo como "upar videos", reprova sua candidatura na hora.

Aqui no @CanalQb, validamos esse processo completo do zero até o primeiro token gerado com sucesso. Este guia cobre cada campo, cada armadilha e cada decisão que vai separar um app aprovado de um app rejeitado.

O que é o TikTok for Developers e por que você precisa de um app cadastrado?

O TikTok for Developers é o portal onde você registra aplicações que consomem as APIs oficiais da plataforma — incluindo a Content Posting API, que permite publicar vídeos programaticamente sem abrir o app. Sem um app aprovado no portal, qualquer chamada à API retorna erro de autenticação e nenhum token é emitido.

Todo acesso à API do TikTok passa por OAuth 2.0. O app que você cria no portal é quem emite o Client Key e o Client Secret — as duas credenciais que o seu script precisa para solicitar permissão de publicar no seu próprio perfil. Mesmo para uso 100% pessoal (uma única conta), o cadastro é obrigatório.

Como preencher a seção "Informações Básicas" sem ser rejeitado?

A seção de Informações Básicas parece trivial, mas dois campos costumam causar rejeição imediata: a descrição e a URL de redirecionamento. Preencha cada campo exatamente como descrito abaixo para evitar reprovação automática antes mesmo de chegar na auditoria humana.

Como preencher o campo "Análise do Aplicativo" para passar na auditoria?

Este é o campo mais crítico de todo o processo. O TikTok exige entre 100 e 1000 caracteres explicando em detalhes como cada produto e escopo será usado. Respostas vagas como "upar videos" (literalmente 11 caracteres) resultam em rejeição imediata — e muitas vezes sem direito a recurso na mesma semana.

⚠️ Armadilha Real: O campo aceita o envio com menos de 100 caracteres — o sistema não bloqueia. Mas a equipe de revisão humana do TikTok rejeita automaticamente descrições que não especificam o fluxo técnico de cada escopo solicitado. Validamos isso aqui no @CanalQb testando múltiplos cenários de texto.

Use o texto abaixo como base (881 caracteres, dentro do limite):

O detalhe que faz diferença: mencione cada escopo solicitado separadamente, explique o fluxo técnico (OAuth → token → upload em chunks) e deixe claro que é uso interno de conta própria. O TikTok é muito mais rigoroso com apps que pedem escopos sem justificativa individual.

Qual a diferença entre Sandbox e Production no TikTok Developer?

Sandbox é o ambiente de testes que funciona sem auditoria. Production é o ambiente real, que exige aprovação manual da equipe do TikTok. A diferença prática que ninguém explica está na URL de redirecionamento OAuth: o Sandbox aceita http://localhost, a Production só aceita https://.

ℹ️ Insight @CanalQb: Se a automação é só para a sua conta, o Sandbox já resolve 100% do caso de uso. Você não precisa passar pela auditoria da Production para começar a publicar. O vídeo vai como privado/rascunho — mas chega lá.

Como configurar o Login Kit e a Redirect URI corretamente?

A Redirect URI é o endereço para onde o TikTok envia o código de autorização após o usuário clicar em "Autorizar". Se essa URI não estiver cadastrada no portal, o OAuth falha com erro 400 mesmo que suas credenciais estejam corretas. É um erro silencioso que confunde muito.

❌ Erro Comum: Tentar cadastrar http://localhost na aba Production. O portal rejeita com "Enter a valid URL beginning with https://" — sem outra mensagem de erro. Não tente. Use sempre a URL HTTPS do seu domínio na Production.

O motivo de usar localhost no Sandbox é simples: o script Python de OAuth sobe um servidor temporário na porta 8080 do seu computador. O TikTok redireciona para ele e o script captura o código de autorização automaticamente — sem precisar copiar e colar nada.

O toggle "Postagem Direta" precisa estar ligado para automação funcionar?

Depende do nível de automação que você quer. Com o toggle desligado, todos os vídeos enviados via API chegam como rascunho — o criador precisa publicar manualmente pelo app do TikTok. Com o toggle ligado, o vídeo vai direto ao ar sem intervenção humana.

⚠️ Atenção: Se o app for rejeitado na auditoria com o toggle ligado, tente novamente com ele desligado. O pipeline de automação continua funcional — apenas adiciona um passo manual de publicação. É uma troca válida para aprovar o app e partir para Production.

Como gerar o Refresh Token OAuth do TikTok pelo script Python?

Com o app configurado e a Redirect URI cadastrada, o próximo passo é gerar o refresh_token — o token de longa duração que o pipeline usa para obter novos access_tokens sem precisar re-autorizar manualmente. O script setup_tiktok_oauth.py faz isso em dois modos.

Onde e como adicionar as credenciais TikTok no GitHub Actions?

O refresh_token gerado pelo script precisa ser armazenado como secret criptografado no GitHub para que o pipeline de automação acesse sem expor as credenciais no código. Acesse Settings → Secrets and variables → Actions → New repository secret e crie os três secrets abaixo.

Para mais informações sobre boas práticas de segurança com secrets no CI/CD, consulte a documentação oficial do GitHub Actions.

Quais os erros mais comuns na API do TikTok e como resolver?

A maioria dos erros de integração com a API do TikTok acontece por configuração errada no portal — não no código. Aqui no @CanalQb, catalogamos os problemas que aparecem com mais frequência durante os testes de pipeline.

Checklist completo antes de submeter o app para análise

Este checklist foi validado nos testes do @CanalQb. Todos os itens precisam estar marcados antes de clicar em "Submeter para análise" — um único item faltando pode reprovar a candidatura sem mensagem clara de qual campo causou o problema.

• Ícone PNG 1024×1024px enviado
• Descrição sem mencionar plataformas concorrentes (máx. 120 chars)
• Campo de análise preenchido com fluxo técnico detalhado (mín. 100 chars)
• URLs de Termos e Privacidade em HTTPS
• Redirect URI cadastrada e salva: localhost:8080/callback (Sandbox) ou HTTPS (Production)
• Toggle "Postagem direta" configurado conscientemente (ligado ou desligado)
• Vídeo de demonstração gravado mostrando o fluxo OAuth completo
• Formulário salvo antes de submeter