Ligar o TikTok ao Social Quack — o guia completo

O TikTok é a única plataforma em que ligar a conta pede um formulário e uma pequena gravação de ecrã, em vez de dois cliques. Esta página leva-te do princípio ao fim em cerca de 20 minutos, com todas as respostas prontas a colar. Só fazes isto uma vez.

Preferes saltar a revisão do TikTok? Liga antes através do Zernio: colas uma chave, inicias sessão e publicas — uns minutos, sem formulário. Vê o guia do Zernio. Esta página é o caminho em que fazes tudo tu, com a tua própria aplicação de programador.

Duas fases, e podes começar a publicar logo depois da fase 1:

Fase 1 — criar a tua aplicação de programador do TikTok

1. Vai a https://developers.tiktok.com e inicia sessão com a tua conta do TikTok. (Pode ser-te pedido que confirmes o email e aceites os termos de programador.)
2. Manage apps → Connect an app. Preenche:
   • App name: o que quiseres, p. ex. My Social Quack
   • App icon: qualquer imagem de 1024×1024 (o teu logótipo ou uma fotografia)
   • Category: Productivity (ou a mais parecida)
   • Description: cola a que está nas respostas para copiar e colar mais abaixo
   • Terms of Service URL: https://socialquack.com/terms · Privacy Policy URL: https://socialquack.com/privacy
   • Platform: assinala Desktop
3. Add products (barra lateral esquerda): acrescenta Login Kit e Content Posting API.
   • Em Content Posting API, ativa Direct Post.
4. Login Kit → Redirect URI: assinala Desktop e cola o redirect URI exatamente como o Social Quack o mostra (Channels → TikTok → Set up keys ▾ → Set up app keys — é parecido com http://localhost:4400/oauth/tiktok/callback). Grava.

   Porquê Desktop e não Web? O Social Quack corre no teu próprio computador. A plataforma Desktop do TikTok aceita redirecionamentos para localhost e não te obriga a verificar um domínio. A Web obrigaria.

5. Scopes: confirma que estes três aparecem nos teus produtos: user.info.basic, video.upload, video.publish.
6. Cria uma Sandbox — é o passo que toda a gente salta. Enquanto o TikTok não tiver revisto a tua aplicação, a client key principal ("production") é recusada com unauthorized_client. Na página da tua aplicação clica em Sandbox (canto superior direito) → Create sandbox. Dá-lhe os mesmos produtos (Login Kit, Content Posting API com Direct Post), os mesmos scopes e o mesmo Redirect URI e, em Target users, acrescenta o teu nome de utilizador do TikTok.
7. Sandbox → Client key / Client secret: copia os dois para o Social Quack (Channels → TikTok → Set up keys ▾ → Set up app keys) e clica em Connect (ligar). Aprova a página de início de sessão do TikTok. A tua conta aparece em Connected (ligadas).
8. Usa uma conta do TikTok descartável para testar. As aplicações em sandbox só conseguem publicar em contas privadas (senão dá unaudited_client_can_only_post_to_private_accounts) — e não queres pôr a tua conta verdadeira em privado. Cria uma conta nova do TikTok (com qualquer email), torna-a privada (Profile → ☰ → Settings and privacy → Privacy → Private account), acrescenta o nome de utilizador dela em Target users na sandbox e liga essa conta no Social Quack.
9. Publica um vídeo de teste a partir do Compose. Quando assinalas o canal do TikTok, aparece um painel TikTok options (opções do TikTok) — escolhe quem pode ver a publicação (em sandbox só existe "Only you"), os interruptores de comentários/duet/stitch e se é conteúdo comercial. A publicação sai na conta descartável. A fase 1 está feita.

Depois de a revisão ser aprovada: volta a Edit keys ▾ → Edit app keys, cola a Client key/secret de production da aplicação (em App details, não na sandbox) e clica em Connect — desta vez com a tua conta verdadeira. A partir daí o seletor de privacidade oferece Everyone / Friends / Followers / Only you.

As publicações de fotos precisam de um passo extra: o TikTok vai buscar as fotos a um URL público, por isso configura o Media hosting nas Settings do Social Quack e depois, na tua aplicação do TikTok, abre Content Posting API → URL properties e verifica esse domínio. Os vídeos não precisam disto.

Fase 2 — submeter para revisão (acaba com o limite do só privado)

No portal de programadores abre a tua aplicação → Submit for review. O TikTok pede três coisas: uma explicação de cada produto e scope, um vídeo de demonstração e os dados básicos da aplicação. Tens tudo o que precisas aqui em baixo.

Respostas para copiar e colar

App description (descrição da aplicação)

Personal social-media scheduling tool. I write posts on my own computer (Social Quack, a self-hosted scheduler that runs locally on my Mac/PC) and it publishes them to my own TikTok account at the scheduled time. Single user: me. No data about other TikTok users is collected or stored; nothing runs on a server.

Explain how each product and scope works within your app (explica como funciona cada produto e scope na tua aplicação)

Login Kit — used once to sign in with my own TikTok account so the app can obtain an access token for that account. The token is stored encrypted on my computer only.

Content Posting API (Direct Post) — used to publish videos and photo posts that I create and schedule myself. The app uploads the video file directly (FILE_UPLOAD) at the scheduled time with the caption I wrote, using the privacy level I chose.

user.info.basic — reads my own display name, avatar and username to show which account is connected in the app.

video.upload — uploads the video file to TikTok for a post I scheduled.

video.publish — publishes that upload as a post on my own account, with my caption and privacy setting.

Data handling: the app is local-only software. Access tokens are stored encrypted on my device, never transmitted to any third-party server, and are deleted when I disconnect the account. No content or data from other users is accessed.

Se te perguntarem "Does your app allow users to post publicly?" → Yes — the user chooses the privacy level (public, friends, or private) for each post, matching what they'd pick in the TikTok app.

Se te perguntarem pelo site / como é que os utilizadores acedem à aplicação → Desktop application installed on the user's computer; the website is https://socialquack.com.

O vídeo de demonstração — o que gravar

O TikTok quer ver o fluxo, não um vídeo de marketing. Uma gravação de ecrã de 60–90 segundos é perfeita. Mac: QuickTime → File → New Screen Recording, ou ⌘⇧5. Não precisas de narração; legendas ficam bem, mas são opcionais.

Guião (segue-o por ordem — os revisores procuram exatamente estes momentos):

1. (0:00) Abre o Social Quack. Mostra rapidamente a página Channels.
2. (0:05) Clica em Connect no TikTok. A página de início de sessão do TikTok abre no teu navegador — mostra o ecrã de permissões com os scopes (user info, upload, publish) e clica em Authorize. Mostra que volta ao Social Quack com a tua conta do TikTok já em Connected.
3. (0:25) Vai ao Compose. Escreve uma legenda, clica em Upload e anexa um vídeo curto, assinala o canal do TikTok. Demora-te no painel de opções do TikTok que aparece — os revisores procuram-no: a linha "Posting to TikTok as …", abre o menu Who can see this post e escolhe um valor, mostra os interruptores Allow comments / Duet / Stitch, liga e desliga Disclose commercial content para aparecerem Your brand / Branded content, e deixa ficar visível a linha "By posting, you agree to TikTok's Music Usage Confirmation". Depois escolhe uma hora um ou dois minutos à frente (ou clica em Post now).
4. (0:45) Mostra a publicação na Queue com o estado scheduled e espera que passe a published (com Post now, passa logo a seguir). Clica no link view.
5. (1:00) Mostra a publicação no próprio TikTok — no perfil na web ou no ecrã do telemóvel — para o revisor ver que a legenda e o vídeo chegaram à conta.
6. (1:15, opcional mas convincente) Vai a Channels → Remove no canal do TikTok, para mostrar que desligar revoga o acesso da aplicação.

Grava tudo de uma vez; não é preciso editar. Guarda em MP4 e carrega-o no campo do vídeo de demonstração do formulário de revisão.

Depois de submeteres

• Prazo habitual: 1–5 dias úteis. Recebes um email seja qual for o resultado.
• Se for rejeitada, o motivo costuma ser um destes: o vídeo não mostrou o ecrã de permissões, não mostrou a publicação a aparecer no TikTok, ou a explicação dos scopes não dizia para que serve cada scope. Corrige essa coisa e volta a submeter — pode ser no mesmo dia.
• Entretanto continua a usar a aplicação: as publicações privadas funcionam o tempo todo.
• Depois de aprovada, nada muda no Social Quack — a tua próxima publicação usa simplesmente o nível de privacidade que escolheste.

Se alguma coisa correr mal