Tutte le guide

Collegare TikTok a Social Quack — la guida completa

TikTok è l'unica piattaforma in cui collegarsi richiede un modulo e una breve registrazione dello schermo, invece di due clic. Questa pagina ti accompagna in circa 20 minuti, con ogni risposta pronta da incollare. Lo fai una volta sola.

Preferisci saltare la revisione di TikTok? Collegati tramite Zernio: incolli una chiave, accedi, pubblichi — pochi minuti, nessun modulo. Vedi la guida a Zernio. Questa pagina è la strada fai-da-te, con una tua app per sviluppatori.

Due fasi, e puoi iniziare a pubblicare già dopo la fase 1:

Fase Cosa ottieni Tempo
1. Crea l'app Colleghi il tuo account e pubblichi — ma i post sono privati (li vedi solo tu) finché TikTok non ha revisionato l'app ~10 min
2. Invia per la revisione Pubblicazione pubblica ~10 min del tuo tempo, poi 1–5 giorni lavorativi da parte di TikTok

Fase 1 — crea la tua app per sviluppatori TikTok

  1. Vai su https://developers.tiktok.com e accedi con il tuo account TikTok. (Può darsi che ti chieda di verificare l'email e di accettare i termini per sviluppatori.)
  2. Manage apps → Connect an app. Compila:
    • App name: quello che vuoi, per esempio My Social Quack
    • App icon: un'immagine qualsiasi di 1024×1024 (il tuo logo o una foto)
    • Category: Productivity (o la voce più simile)
    • Description: incolla quella delle risposte da copiare e incollare qui sotto
    • Terms of Service URL: https://socialquack.com/terms · Privacy Policy URL: https://socialquack.com/privacy
    • Platform: spunta Desktop
  3. Add products (barra laterale a sinistra): aggiungi Login Kit e Content Posting API.
    • In Content Posting API, attiva Direct Post.
  4. Login Kit → Redirect URI: spunta Desktop e incolla l'URI di reindirizzamento esattamente come lo mostra Social Quack (Channels → TikTok → Set up keys ▾ → Set up app keys (configura le chiavi → configura le chiavi dell'app) — ha un aspetto tipo http://localhost:4400/oauth/tiktok/callback). Salva.

    Perché Desktop e non Web? Social Quack gira sul tuo computer. La piattaforma Desktop di TikTok accetta i reindirizzamenti verso localhost e non ti chiede di verificare un dominio. Web sì.

  5. Scopes: controlla che questi tre compaiano sotto i tuoi prodotti: user.info.basic, video.upload, video.publish.
  6. Crea una Sandbox — è il passaggio che tutti dimenticano. Finché TikTok non ha revisionato la tua app, la sua client key principale ("production") viene rifiutata con unauthorized_client. Nella pagina della tua app clicca Sandbox (in alto a destra) → Create sandbox. Dalle gli stessi prodotti (Login Kit, Content Posting API con Direct Post), gli stessi scope e lo stesso Redirect URI, e sotto Target users aggiungi il tuo nome utente TikTok.
  7. Sandbox → Client key / Client secret: copiali entrambi in Social Quack (Channels → TikTok → Set up keys ▾ → Set up app keys) e clicca Connect (collega). Approva la pagina di login di TikTok. Il tuo account compare sotto Connected (collegati).
  8. Per i test usa un account TikTok usa e getta. Le app in sandbox possono pubblicare solo su account privati (altrimenti ottieni unaudited_client_can_only_post_to_private_accounts) — e non vuoi rendere privato il tuo account vero. Crea un account TikTok nuovo (con qualsiasi email), rendilo privato (Profilo → ☰ → Settings and privacy → Privacy → Private account), aggiungi il suo nome utente sotto Target users della sandbox e collega quell'account in Social Quack.
  9. Pubblica un video di prova da Compose (Componi). Quando spunti il canale TikTok compare un pannello TikTok options (opzioni TikTok): scegli chi può vedere il post (in sandbox c'è solo "Only you"), gli interruttori per commenti/duet/stitch e se si tratta di contenuto commerciale. Il video esce sull'account usa e getta. La fase 1 è fatta.

Dopo l'approvazione della revisione: torna su Edit keys ▾ → Edit app keys (modifica le chiavi → modifica le chiavi dell'app), incolla la Client key/secret di production dell'app (da App details, non dalla sandbox) e clicca Connect — questa volta con il tuo account vero. Da lì in poi il selettore della privacy offre Everyone / Friends / Followers / Only you.

I post con foto richiedono un passaggio in più: TikTok va a prendere le foto da un URL pubblico, quindi configura il Media hosting nelle Settings (Impostazioni) di Social Quack, poi nella tua app TikTok apri Content Posting API → URL properties e verifica quel dominio. Per i video non serve.

Fase 2 — invia per la revisione (toglie il limite dei soli post privati)

Nel portale per sviluppatori apri la tua app → Submit for review. TikTok chiede tre cose: una spiegazione di ogni prodotto e scope, un video dimostrativo e i dati di base dell'app. Tutto quello che ti serve è qui sotto.

Risposte da copiare e incollare

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.

Se ti chiede "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 ti chiede di un sito web / di come gli utenti accedono all'app → Desktop application installed on the user's computer; the website is https://socialquack.com.

Il video dimostrativo — cosa registrare

TikTok vuole vedere il flusso, non un video promozionale. Una registrazione dello schermo di 60–90 secondi è perfetta. Mac: QuickTime → File → New Screen Recording, oppure ⌘⇧5. Non serve la voce fuori campo; i sottotitoli sono un bel tocco, ma facoltativi.

Copione (seguilo in ordine — chi revisiona cerca proprio questi passaggi):

  1. (0:00) Apri Social Quack. Mostra per un attimo la pagina Channels (Canali).
  2. (0:05) Clicca Connect su TikTok. La pagina di login di TikTok si apre nel browser — mostra la schermata delle autorizzazioni con l'elenco degli scope (user info, upload, publish) e clicca Authorize. Mostra che torni in Social Quack con il tuo account TikTok ora elencato sotto Connected.
  3. (0:25) Vai su Compose. Scrivi una didascalia, clicca Upload e allega un video breve, spunta il canale TikTok. Soffermati sul pannello TikTok options che compare — chi revisiona lo controlla: la riga "Posting to TikTok as …", apri il menu Who can see this post e scegli un valore, mostra gli interruttori Allow comments / Duet / Stitch, attiva e disattiva Disclose commercial content per far comparire Your brand / Branded content, e lascia visibile la riga "By posting, you agree to TikTok's Music Usage Confirmation". Poi scegli un orario uno o due minuti più avanti (oppure clicca Post now).
  4. (0:45) Mostra il post nella Queue (Coda) con lo stato scheduled, poi aspetta (o dopo Post now) che passi a published. Clicca il link view.
  5. (1:00) Mostra il post su TikTok stesso — il profilo web o lo schermo del telefono — così chi revisiona vede che didascalia e video sono arrivati sull'account.
  6. (1:15, facoltativo ma convincente) Vai su Channels → Remove (rimuovi) il canale TikTok, per mostrare che scollegarlo revoca l'accesso dell'app.

Fai tutto in una sola ripresa; non serve montare niente. Salva in MP4 e caricalo nel campo del video dimostrativo del modulo di revisione.

Dopo l'invio

  • Tempi tipici: 1–5 giorni lavorativi. Ricevi un'email in ogni caso.
  • Se viene rifiutata, il motivo di solito è uno di questi: il video non mostrava la schermata delle autorizzazioni, non mostrava il post comparire su TikTok, oppure la spiegazione degli scope non diceva a cosa serve ciascuno. Sistema quella sola cosa e invia di nuovo — anche lo stesso giorno va bene.
  • Nel frattempo continua a usare l'app: i post privati funzionano per tutto il tempo.
  • Dopo l'approvazione in Social Quack non cambia niente — il tuo prossimo post usa semplicemente il livello di privacy che hai scelto.

Se qualcosa non funziona

Cosa vedi Che cosa significa Cosa fare
unauthorized_client / client_key sulla pagina di login di TikTok Hai usato le chiavi di production prima della revisione Crea una Sandbox, aggiungiti come target user e usa la client key/secret della sandbox
Errore redirect_uri sulla pagina di login di TikTok L'URI in Login Kit non coincide esattamente Ricopialo dalla scheda TikTok di Social Quack, porta compresa; controlla che Desktop sia spuntato
unaudited_client_can_only_post_to_private_accounts App in sandbox + l'account collegato è pubblico Collega un account usa e getta impostato come Private (passo 8)
"TikTok: choose who can see this post" Non hai scelto il livello di privacy nel pannello TikTok options Spunta il canale TikTok in Compose e scegli un pubblico
Il post fallisce con privacy_level_option_mismatch App non ancora revisionata, quindi è ammesso solo il privato Normale prima della revisione — il post è privato; invia per la revisione per togliere il limite
Il post fallisce con unaudited_client_can_only_post_to_private_accounts Come sopra Come sopra
"TikTok session fully expired" Non pubblichi da un anno e il refresh token è scaduto Channels → Remove → collega di nuovo
Il post con foto fallisce, il video funziona Dominio dei media non verificato Content Posting API → URL properties → verifica il dominio del tuo hosting dei media

Bloccato su un passaggio? Scrivi a [email protected] e ti risponde una persona vera.