Alle handleidingen

TikTok koppelen aan Social Quack — de complete handleiding

TikTok is het enige platform waar koppelen een formulier en een korte schermopname kost, in plaats van twee klikken. Met deze pagina ben je er in zo'n 20 minuten doorheen, met elk antwoord klaar om te plakken. Je doet dit maar één keer.

Sla je de review van TikTok liever over? Koppel dan via Zernio: één sleutel plakken, inloggen, posten — een paar minuten, geen formulier. Zie de Zernio-handleiding. Deze pagina is de doe-het-zelfroute, met je eigen developer-app.

Twee fases, en na fase 1 kun je al posten:

Fase Wat je krijgt Tijd
1. Maak de app aan Koppel je account en post — maar posts zijn privé (alleen jij ziet ze) tot TikTok de app heeft beoordeeld ~10 min
2. Dien in voor review Openbaar posten ~10 min van jouw tijd, daarna 1–5 werkdagen aan de kant van TikTok

Fase 1 — maak je TikTok-developer-app aan

  1. Ga naar https://developers.tiktok.com en log in met je TikTok-account. (Misschien moet je je e-mailadres bevestigen en de developervoorwaarden accepteren.)
  2. Manage apps → Connect an app. Vul in:
    • App name: wat je wilt, bijvoorbeeld My Social Quack
    • App icon: een willekeurige afbeelding van 1024×1024 (je logo of een foto)
    • Category: Productivity (of wat er het dichtst bij komt)
    • Description: plak die uit de kant-en-klare antwoorden hieronder
    • Terms of Service URL: https://socialquack.com/terms · Privacy Policy URL: https://socialquack.com/privacy
    • Platform: vink Desktop aan
  3. Add products (zijbalk links): voeg Login Kit en Content Posting API toe.
    • Zet in Content Posting API de optie Direct Post aan.
  4. Login Kit → Redirect URI: vink Desktop aan en plak het redirect-adres precies zoals Social Quack het toont (Channels → TikTok → Set up keys ▾ → Set up app keys (sleutels instellen → app-sleutels instellen) — het ziet eruit als http://localhost:4400/oauth/tiktok/callback). Opslaan.

    Waarom Desktop en niet Web? Social Quack draait op je eigen computer. Het Desktop-platform van TikTok staat localhost-adressen toe en vraagt niet om een domein te verifiëren. Web wel.

  5. Scopes: controleer of deze drie onder je producten staan: user.info.basic, video.upload, video.publish.
  6. Maak een Sandbox aan — dit is de stap die iedereen mist. Zolang TikTok je app niet heeft beoordeeld, wordt de hoofdsleutel („production") geweigerd met unauthorized_client. Klik op de pagina van je app op Sandbox (rechtsboven) → Create sandbox. Geef hem dezelfde producten (Login Kit, Content Posting API met Direct Post), dezelfde scopes en dezelfde Redirect URI, en voeg onder Target users je eigen TikTok-gebruikersnaam toe.
  7. Sandbox → Client key / Client secret: kopieer ze allebei naar Social Quack (Channels → TikTok → Set up keys ▾ → Set up app keys) en klik op Connect (koppelen). Keur de inlogpagina van TikTok goed. Je account verschijnt onder Connected (gekoppeld).
  8. Test met een wegwerpaccount op TikTok. Sandbox-apps kunnen alleen naar privé-accounts posten (anders krijg je unaudited_client_can_only_post_to_private_accounts) — en je echte account wil je niet op privé zetten. Maak een nieuw TikTok-account aan (met een willekeurig e-mailadres), zet het op privé (Profiel → ☰ → Settings and privacy → Privacy → Private account), voeg de gebruikersnaam toe onder Target users van de sandbox en koppel dat account in Social Quack.
  9. Post een testvideo vanuit Compose (opstellen). Zodra je het TikTok-kanaal aanvinkt, verschijnt een paneel TikTok options (TikTok-opties) — kies wie de post mag zien (in de sandbox is alleen „Only you" beschikbaar), zet de schakelaars voor reacties/duet/stitch, en geef aan of het commerciële content is. De video gaat naar het wegwerpaccount. Fase 1 is klaar.

Na goedkeuring van de review: ga terug naar Edit keys ▾ → Edit app keys (sleutels bewerken → app-sleutels bewerken), plak de production-Client key/secret van de app (uit App details, niet uit de sandbox) en klik op Connect — deze keer met je echte account. Vanaf dan biedt de privacykeuze Everyone / Friends / Followers / Only you.

Fotoposts hebben één extra stap nodig: TikTok haalt foto's op van een openbaar webadres, dus stel Media hosting (mediahosting) in onder Settings (instellingen) in Social Quack, open daarna in je TikTok-app Content Posting API → URL properties en verifieer dat domein. Voor video's is dit niet nodig.

Fase 2 — dien in voor review (daarmee vervalt de privé-beperking)

Open in het developerportaal je app → Submit for review. TikTok vraagt drie dingen: een uitleg van elk product en elke scope, een demovideo en de basisgegevens van de app. Alles wat je nodig hebt, staat hieronder.

Kant-en-klare antwoorden

App description

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

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.

Als er gevraagd wordt „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.

Als er gevraagd wordt naar een website / hoe gebruikers de app openen → Desktop application installed on the user's computer; the website is https://socialquack.com.

De demovideo — wat je opneemt

TikTok wil de stappen zien, geen reclamefilmpje. Een schermopname van 60–90 seconden is perfect. Mac: QuickTime → File → New Screen Recording, of ⌘⇧5. Een voice-over is niet nodig; ondertitels zijn een mooie extra, maar niet verplicht.

Draaiboek (volg het op volgorde — beoordelaars zoeken precies naar deze momenten):

  1. (0:00) Open Social Quack. Laat kort de pagina Channels (kanalen) zien.
  2. (0:05) Klik op Connect bij TikTok. De inlogpagina van TikTok opent in je browser — laat het toestemmingsscherm zien met de scopes (user info, upload, publish) en klik op Authorize. Laat zien dat je terugkomt in Social Quack, met je TikTok-account nu onder Connected.
  3. (0:25) Ga naar Compose. Typ een bijschrift, klik op Upload en voeg een korte video toe, vink het TikTok-kanaal aan. Blijf even hangen bij het paneel TikTok options dat verschijnt — beoordelaars letten erop: de regel „Posting to TikTok as …", open het keuzemenu Who can see this post en kies een waarde, laat de schakelaars Allow comments / Duet / Stitch zien, zet Disclose commercial content aan en weer uit zodat Your brand / Branded content verschijnen, en zorg dat de regel „By posting, you agree to TikTok's Music Usage Confirmation" in beeld is. Kies daarna een tijdstip een minuut of twee vooruit (of klik op Post now).
  4. (0:45) Laat de post zien in de Queue (wachtrij) met status scheduled, en wacht (of na Post now) tot hij op published springt. Klik op de link view.
  5. (1:00) Laat de post op TikTok zelf zien — het webprofiel of je telefoonscherm — zodat de beoordelaar ziet dat bijschrift en video op het account zijn aangekomen.
  6. (1:15, optioneel maar sterk) Ga naar Channels → Remove (verwijderen) bij het TikTok-kanaal, om te laten zien dat ontkoppelen de toegang van de app intrekt.

Neem alles in één keer op; knippen is niet nodig. Sla op als MP4 en upload het in het demovideoveld van het reviewformulier.

Na het indienen

  • Gebruikelijke doorlooptijd: 1–5 werkdagen. Je krijgt hoe dan ook een e-mail.
  • Word je afgewezen, dan is de reden meestal een van deze: de demovideo liet het toestemmingsscherm niet zien, liet niet zien dat de post op TikTok verscheen, of de uitleg van de scopes zei niet waar elke scope voor is. Los dat ene ding op en dien opnieuw in — dezelfde dag kan prima.
  • Blijf de app intussen gewoon gebruiken: privéposts werken de hele tijd.
  • Na goedkeuring verandert er niets in Social Quack — je volgende post gebruikt gewoon het privacyniveau dat je kiest.

Als er iets misgaat

Wat je ziet Wat het betekent Doe dit
unauthorized_client / client_key op de inlogpagina van TikTok Je hebt de production-sleutels gebruikt vóór de review Maak een Sandbox aan, voeg jezelf toe als target user en gebruik de client key/secret van de sandbox
redirect_uri-fout op de inlogpagina van TikTok Het adres in Login Kit komt niet exact overeen Kopieer het opnieuw van de TikTok-kaart in Social Quack, inclusief de poort; controleer of Desktop is aangevinkt
unaudited_client_can_only_post_to_private_accounts Sandbox-app + het gekoppelde account is openbaar Koppel een wegwerpaccount dat op Private staat (stap 8)
„TikTok: choose who can see this post" Er is geen privacyniveau gekozen in het paneel TikTok options Vink het TikTok-kanaal aan in Compose en kies een publiek
De post mislukt met privacy_level_option_mismatch De app is nog niet beoordeeld, dus alleen privé mag Normaal vóór de review — de post is privé; dien in voor review om dit op te heffen
De post mislukt met unaudited_client_can_only_post_to_private_accounts Zelfde als hierboven Zelfde
„TikTok session fully expired" Je hebt een jaar niet gepost; het refresh token is verlopen Channels → Remove → opnieuw Connect
Een fotopost mislukt, video werkt wel Het mediadomein is niet geverifieerd Content Posting API → URL properties → verifieer het domein van je mediahosting

Loop je vast bij een stap? Mail [email protected] en je krijgt antwoord van een mens.