AFK Todas as dúvidas

[ajuda] conexões

TikTok do zero: app de desenvolvedor, Content Posting API, auditoria e o post privado

O AFK posta no TikTok pela API oficial (Content Posting API). Para isso, você cria um app em developers.tiktok.com com Login Kit e Content Posting API, cola o Client key, o Client secret e o endereço de retorno no cartão TikTok e faz o login uma vez pelo terminal. Enquanto o app não passa na auditoria do TikTok, todo post sai privado (só você vê) e a sua conta do TikTok precisa estar privada. O TikTok diz que não aprova ferramenta feita para postar nas contas que você mesmo gerencia, então, para uma empresa, o post público pela API quase sempre não sai. Para postar público, use o caminho manual: o AFK entrega o vídeo e a legenda prontos e você posta pelo app.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

O que o AFK não faz: não posta sozinho por rotina, não agenda horário e não lê os números dos seus vídeos. Cada envio é um comando seu.

Sem a conexão: o AFK entrega o vídeo e a legenda prontos para você postar pelo app do TikTok.

Antes: grátis ou pago

A API do TikTok não cobra. O que limita é a auditoria.

App sem auditoriaApp auditado pelo TikTok
Quem vê o postSó você (privado)O nível que você escolher, entre os que a conta aceita
Sua conta do TikTokPrecisa estar privada na hora do envioPode ser pública
Contas que postam pelo appAté 5 contas por dia, segundo a documentação do Postiz. O TikTok não publica o número.Cota maior, por app
O que o TikTok exigeNada além do app aprovado ou do modo de testeTela de postagem com prévia, apelido da conta, privacidade sem valor marcado, comentários, Dueto e Costura desligados de início, aviso de conteúdo comercial e a frase de consentimento de música

Antes de seguir, decida: se você quer post público para clientes verem, pare aqui e use o caminho manual. Siga as partes abaixo para testar a API ou se você tem um app já auditado.

Parte 1: conta do TikTok e segurança

  1. Use a conta do TikTok do negócio, por exemplo @minhaempresa.
  2. Ligue a verificação em duas etapas. No app, toque em Perfil → menu de três linhas → Configurações e privacidade → Segurança → Verificação em duas etapas. Prefira o app autenticador ao SMS.
  3. Guarde os códigos de recuperação que o TikTok mostrar.

Parte 2: conta de desenvolvedor e app

O site de desenvolvedor do TikTok é em inglês. Os botões abaixo estão como aparecem na tela.

Você precisa de um site seu no ar, por exemplo minhaempresa.com.br, com uma página de termos de uso e uma de política de privacidade. O TikTok verifica o domínio. Se ainda não tem site, veja Mandar proposta, orçamento ou página por link (e usar o seu domínio).

  1. Abra developers.tiktok.com e crie a conta de desenvolvedor com o seu e-mail.
  2. Abra Manage apps e clique em Connect an app.
  3. Escolha o dono do app. Para uso só seu, a conta individual serve. O TikTok recomenda uma organização para app de verdade.
  4. Preencha os dados do app:
    • App icon: imagem quadrada de 1024 × 1024 px, JPG ou PNG, até 5 MB.
    • App name, categoria e descrição. A descrição aparece na tela de autorização.
    • Endereço dos termos de uso e da política de privacidade, no seu domínio.
    • Plataforma Web, com o endereço do seu site.
  5. Verifique o domínio. O TikTok aceita domínio inteiro ou prefixo de endereço. No prefixo, você baixa um arquivo de assinatura e sobe no seu site.

Parte 3: Login Kit, Content Posting API e permissões

  1. No app, clique em Add products.
  2. Adicione Login Kit. Em Redirect URI, cadastre um endereço https do seu site, por exemplo https://minhaempresa.com.br/tiktok-retorno.
    • O endereço não pode ter ? nem #.
    • A página só precisa abrir. O código do login chega na barra de endereço, mesmo que a página mostre erro.
  3. Adicione Content Posting API e ligue o Direct Post.
  4. Em Scopes, deixe user.info.basic e video.publish. O AFK não pede outra permissão.
  5. Anote o Client key e o Client secret do app. O Client secret é a senha do app: não mande para ninguém.

Parte 4: modo de teste ou análise do app

App novo começa como rascunho. Escolha um caminho:

O pedido de auditoria da Content Posting API fica em developers.tiktok.com/application/content-posting-api. Leia a Parte "Antes" desta página antes de pedir.

Parte 5: deixar a conta do TikTok privada

Sem auditoria, o TikTok só aceita envio para conta privada. O erro é unaudited_client_can_only_post_to_private_accounts.

  1. No app do TikTok, abra Perfil → menu de três linhas → Configurações e privacidade → Privacidade.
  2. Ligue Conta privada.

Conta privada some para quem não segue você. Para conta de empresa, isso pesa: volte para pública quando terminar o teste.

Parte 6: colar no AFK

  1. No painel do AFK, abra Conexões e clique no cartão TikTok.
  2. Cole o Client key em Client key do app.
  3. Cole o Client secret em Client secret do app.
  4. Cole o mesmo endereço da Parte 3, passo 2, em Endereço de retorno (Redirect URI) cadastrado no app. Tem que ser igual, letra por letra, inclusive a barra no fim.
  5. Clique em Salvar conexão. O cartão não tem Testar. A prova é o login (Parte 7).

Parte 7: login pelo terminal

  1. Abra o terminal na pasta do AFK e rode: 
    python ferramentas/publicar/postar_tiktok.py --link
  2. O AFK mostra um link. Abra no navegador em até 30 minutos, entre com a conta do TikTok do negócio e autorize.
  3. O TikTok volta para o seu endereço de retorno. Copie o endereço inteiro da barra, mesmo que a página mostre erro. Ele começa com https:// e tem code= e state=.
  4. Rode, com o endereço entre aspas: 
    python ferramentas/publicar/postar_tiktok.py --codigo "https://minhaempresa.com.br/tiktok-retorno?code=...&state=..."
  5. O certo é aparecer TikTok conectado: cada publicação renova o acesso sozinha; depois de 365 dias do login, faça o login de novo.

Cada link vale uma vez só. Se gerar dois links, só o último vale. O acesso fica num arquivo tiktok.json dentro da pasta meu-negocio/credenciais/, no seu computador. Esse arquivo dá acesso de postagem à sua conta: não mande para ninguém.

No dia a dia

Você querComo
Enviar um vídeo do computadorpython ferramentas/publicar/postar_tiktok.py --arquivo video.mp4 --legenda "Bolo de pote novo #confeitaria"
Enviar um vídeo que está no seu site--video https://minhaempresa.com.br/video.mp4 no lugar de --arquivo. O domínio tem que estar verificado no app.
Escolher a privacidade--privacidade SELF_ONLY (padrão), MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR ou PUBLIC_TO_EVERYONE. Sem auditoria, só SELF_ONLY passa.
Postar público para clientesPelo app do TikTok, com o vídeo e a legenda que o AFK entregou.
Renovar o login de 365 diasFaça a Parte 7 de novo.
Trocar o Client secretGere outro no app de desenvolvedor, cole no cartão, clique em Salvar conexão e faça a Parte 7.
Desligar a conexãoNo cartão, clique em Desconectar e confirme. O AFK apaga as chaves do .env. Apague também meu-negocio/credenciais/tiktok.json. No app do TikTok, remova o acesso do app nas configurações de segurança.

Erros e soluções

O que apareceO que fazer
Falta conectar o app do TikTok: preencha TikTok na Central de Conexões do painelFaça a Parte 6 e depois a Parte 7.
O link de login passou de 30 minutos. Nada foi gravado.Gere outro link com --link e use em até 30 minutos.
Este endereço não é do último link de login que o AFK gerouVocê gerou mais de um link. Gere um novo e use só ele.
Não há login esperando (cada link vale uma vez só).O link já foi usado. Gere outro com --link.
Isso não é o endereço da página de retorno do TikTokVocê colou só o código. Copie o endereço inteiro da barra, com https://.
O TikTok não autorizouVocê recusou a autorização, ou o endereço de retorno no cartão é diferente do cadastrado no Login Kit. Confira letra por letra.
unaudited_client_can_only_post_to_private_accountsApp sem auditoria e conta pública. Faça a Parte 5.
O TikTok não aceita a privacidade PUBLIC_TO_EVERYONE nesta conta.O app não tem auditoria. Use --privacidade SELF_ONLY ou poste pelo app.
scope_not_authorizedA conta não deu a permissão video.publish. Confira a Parte 3, passo 4, e faça o login de novo.
url_ownership_unverifiedO endereço do --video não está num domínio verificado. Verifique o domínio no app ou use --arquivo.
spam_risk_too_many_postsA conta bateu o limite diário de posts pela API. Tente no dia seguinte.
reached_active_user_capO app bateu o limite diário de contas postando. Tente no dia seguinte.
O acesso de 365 dias do TikTok venceu.Faça a Parte 7 de novo.
Vídeo enviado; o TikTok ainda está processandoConfira no app do TikTok antes de enviar de novo, para não duplicar.
O TikTok recusou o vídeo:Leia o motivo. Confira formato (MP4), duração e tamanho.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o Client secret nem o arquivo tiktok.json.

Fontes oficiais (conferido em 30/10/2026): developers.tiktok.com/doc/content-posting-api-get-started (passos: app, Content Posting API, Direct Post, video.publish; cliente sem auditoria posta só no modo privado; auditoria em /application/content-posting-api) · developers.tiktok.com/doc/content-sharing-guidelines (tela exigida para Direct Post; "utility tool" para as contas que você gerencia não é aceito; app não pode ser só de teste ou interno) · developers.tiktok.com/doc/content-posting-api-reference-direct-post (erros unaudited_client_can_only_post_to_private_accounts, spam_risk_too_many_posts, reached_active_user_cap, url_ownership_unverified, scope_not_authorized, privacy_level_option_mismatch; 6 pedidos por minuto por token) · developers.tiktok.com/doc/content-posting-api-media-transfer-guide (partes de 5 a 64 MB, última até 128 MB; vídeo até 4 GB; MP4, WebM, MOV; 3 minutos para todos, até 10 para algumas contas; domínio verificado para PULL_FROM_URL) · developers.tiktok.com/doc/oauth-user-access-token-management (acesso de 24 horas; renovação de 365 dias; o token de renovação pode mudar a cada renovação) · developers.tiktok.com/doc/login-kit-web (Redirect URI https, sem parâmetros e sem #, até 10; state contra falsificação) · developers.tiktok.com/doc/getting-started-create-an-app (Manage apps → Connect an app; ícone 1024 px; termos e privacidade verificados; Add products; Scopes; App review com vídeo de demonstração e Submit for review) · developers.tiktok.com/doc/add-a-sandbox (Sandbox → Create Sandbox; até 10 contas suas em Target users; sem post público no sandbox) · docs.postiz.com/providers/tiktok (Postiz instalado por você usa app TikTok próprio; sem auditoria, post privado, conta privada e até 5 contas por dia).

ainda não tem o AFK?

Com o app do TikTok conectado, o AFK envia o vídeo pela API oficial e renova o acesso sozinho por até 365 dias, mas sem a auditoria do TikTok o post sai privado.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.