Podłączanie TikToka do Social Quack — kompletny przewodnik
TikTok to jedyna platforma, na której podłączenie wymaga formularza i krótkiego nagrania ekranu zamiast dwóch kliknięć. Ta strona przeprowadzi cię przez to w około 20 minut, z każdą odpowiedzią gotową do wklejenia. Robisz to tylko raz.
Wolisz pominąć weryfikację TikToka? Połącz się przez Zernio: wklejasz jeden klucz, logujesz się i publikujesz — kilka minut, bez formularza. Zobacz przewodnik po Zernio. Ta strona opisuje drogę „zrób to sam” z własną aplikacją deweloperską.
Dwa etapy — publikować możesz już po etapie 1:
| Etap | Co dostajesz | Czas |
|---|---|---|
| 1. Utwórz aplikację | Podłączasz konto i publikujesz — ale posty są prywatne (widzisz je tylko ty), dopóki TikTok nie zweryfikuje aplikacji | ~10 min |
| 2. Wyślij do weryfikacji | Publiczne posty | ~10 min twojego czasu, potem 1–5 dni roboczych po stronie TikToka |
Etap 1 — utwórz aplikację deweloperską TikToka
- Wejdź na https://developers.tiktok.com i zaloguj się swoim kontem TikTok. (Możesz zostać poproszony o potwierdzenie adresu e-mail i zaakceptowanie warunków dla deweloperów.)
- Manage apps → Connect an app. Wypełnij:
- App name: cokolwiek, np.
My Social Quack - App icon: dowolny obraz 1024×1024 (twoje logo albo zdjęcie)
- Category: Productivity (albo najbliższa pasująca)
- Description: wklej opis z gotowych odpowiedzi poniżej
- Terms of Service URL:
https://socialquack.com/terms· Privacy Policy URL:https://socialquack.com/privacy - Platform: zaznacz Desktop
- App name: cokolwiek, np.
- Add products (panel boczny po lewej): dodaj Login Kit i Content Posting API.
- W Content Posting API włącz Direct Post.
- Login Kit → Redirect URI: zaznacz Desktop i wklej adres przekierowania dokładnie taki, jaki pokazuje Social Quack (Channels → TikTok → Set up keys ▾ → Set up app keys — wygląda jak
http://localhost:4400/oauth/tiktok/callback). Zapisz.Dlaczego Desktop, a nie Web? Social Quack działa na twoim własnym komputerze. Platforma Desktop w TikToku dopuszcza przekierowania na
localhosti nie wymaga weryfikacji domeny. Web by jej wymagała. - Scopes (uprawnienia): upewnij się, że przy twoich produktach widnieją te trzy:
user.info.basic,video.upload,video.publish. - Utwórz Sandbox — to krok, który wszyscy pomijają. Dopóki TikTok nie zweryfikuje twojej aplikacji, jej główny („produkcyjny”) client key jest odrzucany z błędem
unauthorized_client. Na stronie aplikacji kliknij Sandbox (prawy górny róg) → Create sandbox. Daj mu te same produkty (Login Kit, Content Posting API z Direct Post), te same scopes i ten sam Redirect URI, a w Target users dodaj swoją nazwę użytkownika na TikToku. - Sandbox → Client key / Client secret: skopiuj obie wartości do Social Quack (Channels („Kanały”) → TikTok → Set up keys ▾ → Set up app keys („Skonfiguruj klucze → Skonfiguruj klucze aplikacji”)) i kliknij Connect („Połącz”). Zatwierdź stronę logowania TikToka. Twoje konto pojawi się w sekcji Connected.
- Do testów użyj konta jednorazowego. Aplikacje w sandboksie mogą publikować tylko na kontach prywatnych (inaczej dostaniesz
unaudited_client_can_only_post_to_private_accounts) — a przecież nie chcesz przestawiać swojego prawdziwego konta na prywatne. Załóż nowe konto TikTok (na dowolny e-mail), ustaw je jako prywatne (Profile → ☰ → Settings and privacy → Privacy → Private account), dodaj jego nazwę użytkownika w Target users sandboksa i podłącz w Social Quacku właśnie to konto. - Opublikuj testowy film z Compose („Tworzenie posta”). Gdy zaznaczysz kanał TikToka, pojawi się panel TikTok options („Opcje TikToka”) — wybierz, kto może zobaczyć post (w sandboksie dostępne jest tylko „Only you”), ustaw przełączniki komentarzy/duetów/stitchy i zaznacz, czy to treść komercyjna. Film trafi na konto jednorazowe. Etap 1 zrobiony.
Po zatwierdzeniu weryfikacji: wróć do Edit keys ▾ → Edit app keys („Edytuj klucze → Edytuj klucze aplikacji”), wklej produkcyjny Client key/secret aplikacji (z App details, nie z sandboksa) i kliknij Connect — tym razem ze swoim prawdziwym kontem. Od tej chwili wybór prywatności oferuje Everyone / Friends / Followers / Only you.
Posty ze zdjęciami wymagają jednego dodatkowego kroku: TikTok pobiera zdjęcia z publicznego adresu URL, więc skonfiguruj Media hosting w ustawieniach Social Quack (Settings), a potem w swojej aplikacji TikToka otwórz Content Posting API → URL properties i zweryfikuj tę domenę. Filmy tego nie potrzebują.
Etap 2 — wyślij do weryfikacji (znosi ograniczenie do postów prywatnych)
W portalu dla deweloperów otwórz swoją aplikację → Submit for review. TikTok pyta o trzy rzeczy: wyjaśnienie każdego produktu i scope'a, film demonstracyjny i podstawowe informacje o aplikacji. Wszystko, czego potrzebujesz, jest poniżej.
Gotowe odpowiedzi do wklejenia
App description („Opis aplikacji”)
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 („Wyjaśnij, jak każdy produkt i scope działa w twojej aplikacji”)
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.
Jeśli padnie pytanie „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.
Jeśli pytają o stronę internetową / o to, jak użytkownicy korzystają z aplikacji → Desktop application installed on the user's computer; the website is https://socialquack.com.
Film demo — scenariusz nagrania
TikTok chce zobaczyć cały przebieg, a nie film reklamowy. Idealne jest 60–90 sekund nagrania ekranu. Mac: QuickTime → File → New Screen Recording albo ⌘⇧5. Lektor nie jest potrzebny; napisy to miły dodatek, ale nieobowiązkowy.
Scenariusz (trzymaj się kolejności — recenzenci szukają dokładnie tych momentów):
- (0:00) Otwórz Social Quack. Pokaż przez chwilę stronę Channels.
- (0:05) Kliknij Connect przy TikToku. W przeglądarce otworzy się strona logowania TikToka — pokaż ekran uprawnień z listą scopes (user info, upload, publish) i kliknij Authorize. Pokaż, że wracasz do Social Quack, a twoje konto TikTok jest teraz na liście Connected.
- (0:25) Przejdź do Compose. Wpisz opis, kliknij Upload i dołącz krótki film, zaznacz kanał TikToka. Zatrzymaj się dłużej na panelu opcji TikToka, który się pojawi — recenzenci go sprawdzają: linijka „Posting to TikTok as …”, otwórz listę Who can see this post i wybierz wartość, pokaż przełączniki Allow comments / Duet / Stitch, włącz i wyłącz Disclose commercial content, żeby odsłonić Your brand / Branded content, i niech będzie widoczna linijka „By posting, you agree to TikTok's Music Usage Confirmation”. Potem wybierz godzinę minutę lub dwie do przodu (albo kliknij Post now).
- (0:45) Pokaż post w Queue ze statusem scheduled, a potem poczekaj (albo po Post now), aż zmieni się na published. Kliknij link view.
- (1:00) Pokaż post na samym TikToku — na profilu w przeglądarce albo na ekranie telefonu — żeby recenzent zobaczył, że opis i film trafiły na konto.
- (1:15, opcjonalnie, ale mocno pomaga) Przejdź do Channels → Remove przy kanale TikToka i pokaż, że odłączenie odbiera aplikacji dostęp.
Nagraj wszystko w jednym ujęciu; montaż nie jest potrzebny. Zapisz jako MP4 i wgraj w polu na film demonstracyjny w formularzu weryfikacji.
Po wysłaniu
- Zwykły czas oczekiwania: 1–5 dni roboczych. E-mail dostaniesz w obu przypadkach.
- Jeśli wniosek zostanie odrzucony, powód to zwykle jeden z trzech: film nie pokazał ekranu uprawnień, nie pokazał posta pojawiającego się na TikToku albo wyjaśnienie scopes nie mówiło, do czego służy każdy z nich. Popraw tę jedną rzecz i wyślij ponownie — nawet tego samego dnia.
- W międzyczasie korzystaj z aplikacji normalnie: prywatne posty działają przez cały czas.
- Po zatwierdzeniu w Social Quacku nic się nie zmienia — twój następny post po prostu dostanie wybrany przez ciebie poziom prywatności.
Jeśli coś pójdzie nie tak
| Co widzisz | Co to znaczy | Co zrobić |
|---|---|---|
unauthorized_client / client_key na stronie logowania TikToka |
Użyłeś kluczy produkcyjnych przed weryfikacją | Utwórz Sandbox, dodaj siebie jako target user i użyj client key/secret z sandboksa |
Błąd redirect_uri na stronie logowania TikToka |
Adres w Login Kit nie zgadza się co do znaku | Skopiuj go jeszcze raz z karty TikToka w Social Quacku, razem z portem; upewnij się, że zaznaczone jest Desktop |
unaudited_client_can_only_post_to_private_accounts |
Aplikacja jest w sandboksie, a podłączone konto jest publiczne | Podłącz konto jednorazowe ustawione jako Private (krok 8) |
| „TikTok: choose who can see this post” | W panelu opcji TikToka nie wybrano poziomu prywatności | Zaznacz kanał TikToka w Compose i wybierz odbiorców |
Post nie wychodzi, błąd privacy_level_option_mismatch |
Aplikacja nie jest jeszcze zweryfikowana, więc dozwolone są tylko posty prywatne | Tak ma być przed weryfikacją — post jest prywatny; wyślij aplikację do weryfikacji, żeby to znieść |
Post nie wychodzi, błąd unaudited_client_can_only_post_to_private_accounts |
To samo co wyżej | To samo |
| „TikTok session fully expired” | Nie publikowałeś od roku i token odświeżania wygasł | Channels → Remove → Connect jeszcze raz |
| Post ze zdjęciem nie wychodzi, a film tak | Domena hostingu multimediów nie jest zweryfikowana | Content Posting API → URL properties → zweryfikuj domenę swojego hostingu multimediów |