Podłączanie X (Twittera) do Social Quack
Własna aplikacja w konsoli X, kilka dolarów doładowania i twoje posty wychodzą o czasie — a klucze zostają zaszyfrowane na twoim Macu.
X to jedyna platforma w Social Quacku, za publikowanie w której trzeba zapłacić. Poza tym wszystko jest proste: tworzysz własną, niewielką aplikację deweloperską, wklejasz do Social Quack dwa klucze i zatwierdzasz połączenie na stronie samego X. Robisz to raz — połączenie tego typu nigdy nie wygasa, więc nie ma czego odnawiać co kilka tygodni.
Ponieważ aplikacja jest twoja, klucze zostają zaszyfrowane na twoim komputerze, a limit publikowania należy tylko do ciebie. Nie dzielisz puli z cudzymi kontami, więc niczyja aktywność nie może ci ściąć przepustowości.
1. Ile to kosztuje
X nie ma już darmowego progu publikowania. Dawny dostęp Free (Standard Basic) jest wycofany — aplikacja, która wciąż na nim siedzi, dostaje odmowę przy każdej próbie publikacji. Żeby publikować przez API X, potrzebujesz konta deweloperskiego w planie Pay Per Use z doładowanym saldem. Jeden post kosztuje centy.
Doładowanie 5–10 $ spokojnie wystarczy na start. Dotyczy to wyłącznie X; Bluesky, Mastodon i pozostałe platformy w Social Quacku są darmowe.
2. Otwórz najpierw kartę X w Social Quacku
Zacznij w aplikacji, żeby wartość, którą trzeba skopiować, była już na ekranie:
Channels („Kanały”) w panelu bocznym → karta X (Twitter) → Set up app keys („Skonfiguruj klucze aplikacji”).
(Kiedy przestrzeń robocza ma już zapisane klucze, ten przycisk nazywa się Edit app keys („Edytuj klucze aplikacji”) — otwiera to samo okno.)
W tym oknie są dwa pola, które wypełnisz na końcu, a nad nimi adres przekierowania, który X nazywa Callback URI, z przyciskiem kopiowania obok. Zawiera port, na którym działa ta kopia Social Quack, więc bierz go z przycisku kopiowania zamiast przepisywać — X odrzuci go, jeśli nie zgodzi się choć jeden znak. Zostaw to okno otwarte.
3. Utwórz projekt Pay Per Use i doładuj konto
- Wejdź na https://console.x.com i otwórz Projects. Potrzebujesz projektu w planie Pay Per Use. Jeśli masz tylko stary projekt Free (Standard Basic), ten już nie działa — użyj projektu Pay Per Use albo go utwórz.
- Billing → Credits: doładuj 5–10 $.
4. Utwórz aplikację
Wewnątrz projektu Pay Per Use: Apps → Create App.
Masz już aplikację w starym projekcie? Możesz ją zamiast tego przenieść, przez Project Access → Manage.
5. Ustaw uprawnienia i adres zwrotny
Otwórz aplikację → Settings, w sekcji Authentication settings:
| Ustawienie | Co wpisać |
|---|---|
| Permissions | Read and write |
| Type of App | Web App |
| Callback URI | adres przekierowania, który Social Quack pokazuje na ekranie Set up app keys — użyj przycisku kopiowania i wklej dokładnie |
| Website | dowolny adres URL |
Zapisz. Zrób to przed następnym krokiem: klucze utworzone przed zmianą uprawnień zachowują stary poziom, a połączenie kończy się wtedy błędem już po zatwierdzeniu w X.
6. Skopiuj API Key i Secret
Aplikacja → Keys & Tokens → OAuth 1.0 Keys → Regenerate przy Consumer Key, a potem skopiuj dwie wyświetlone wartości:
- API Key (Consumer Key)
- API Key Secret (Consumer Secret)
Sekret pokazuje się tylko raz. Jeśli zamkniesz stronę bez skopiowania go, po prostu wygeneruj klucze ponownie — i rób to zawsze, gdy zmienisz uprawnienia aplikacji.
Wygenerowanie na nowo zastępuje starą parę wszędzie: X podpisuje tymi kluczami każdy twój post, więc po regeneracji stare są martwe. Jeśli wkleiłeś je do więcej niż jednej przestrzeni roboczej, otwórz w każdej z nich okno Set up app keys i wklej tam również nową parę — zapisanie otwiera ponownie stronę autoryzacji X, a zatwierdzenie podłącza to konto na nowo w to samo miejsce, zachowując wszystko, co ma w kolejce. Przestrzeń robocza zostawiona ze starymi kluczami przestaje móc publikować.
7. Wklej je i połącz się
Z powrotem w Social Quacku, w tym samym oknie Set up app keys: wklej je w pola API Key (Consumer Key) oraz API Key Secret (Consumer Secret) i kliknij Save („Zapisz”). Nic więcej nie trzeba naciskać — zapisanie kluczy od razu otwiera w przeglądarce stronę autoryzacji X. Zatwierdź ją dla konta, z którego chcesz publikować. Przeglądarka wyląduje wtedy na stronie Connected!, która mówi, żeby zamknąć kartę i wrócić do Social Quack. Zrób to: konto już czeka na stronie Channels.
Kiedy klucze są zapisane, przycisk Connect („Połącz”) na karcie X sam uruchamia tę samą autoryzację — to z niego korzystaj innym razem, żeby dodać drugie konto albo podłączyć jakieś ponownie.
Przez tę samą aplikację możesz podłączyć kilka kont: po jednym na przestrzeń roboczą, jeśli prowadzisz osobne marki. Każda przestrzeń robocza trzyma własną kopię kluczy, więc przełącz ją w panelu bocznym i wklej te same dwie wartości w oknie Set up app keys tej przestrzeni — zapisanie otworzy stronę autoryzacji także dla niej. Jedna aplikacja w X obsłuży je wszystkie.
8. Co możesz publikować na X
| Długość posta | 280 znaków |
| Wątki | Tak — każda część wychodzi jako odpowiedź na poprzednią |
| Obrazy | Do 4, na pierwszym poście wątku, z tekstem alternatywnym |
| Film | Tak |
Zdjęcia większe, niż przyjmuje X, albo w formacie, którego nie obsługuje, są przed wysłaniem automatycznie przeskalowane i przekonwertowane — niczego nie musisz przygotowywać.
Jeśli coś pójdzie nie tak
| Co widzisz | Co to znaczy | Co zrobić |
|---|---|---|
Post nie wychodzi, błąd 403 i client-not-enrolled |
Aplikacja nie jest w projekcie Pay Per Use — stary darmowy dostęp już nie działa | Utwórz aplikację wewnątrz projektu Pay Per Use albo przenieś ją tam przez Project Access → Manage |
| X token exchange failed, na stronie Connection failed po zatwierdzeniu w X | Zwykle klucze powstały przed zmianą uprawnień aplikacji, więc wciąż mają stary poziom. Bywa też, że to klucze z innej aplikacji albo sekret, który przy kopiowaniu został ucięty | Keys & Tokens → OAuth 1.0 Keys → Regenerate, skopiuj obie wartości jeszcze raz, wklej nową parę w Set up app keys i kliknij Save — strona autoryzacji otworzy się ponownie |
| X users/me failed, na tej samej stronie Connection failed | Aplikacja nie jest podpięta do projektu z dostępem do API | Sprawdź, czy aplikacja naprawdę siedzi w twoim projekcie Pay Per Use |
| X API Key / Secret not configured | Ta przestrzeń robocza nie ma zapisanych kluczy — każda trzyma własną kopię | Przełącz się na nią w panelu bocznym, potem Channels → X → Set up app keys, wklej obie wartości i kliknij Save |
| Posty na jedno konto X zaczynają się nie udawać (X rejected the post, 401) po wygenerowaniu kluczy na nowo | Nowa para trafiła tylko do przestrzeni roboczej, w której wtedy byłeś; pozostałe wciąż mają stare, już martwe klucze | W każdej z pozostałych: Set up app keys, wklej nową parę, Save, zatwierdź w X ponownie. Konto podłącza się na nowo w to samo miejsce, a jego posty z kolejki zostają — nigdy nie usuwaj kanału, bo skasowałbyś jego posty |
| Strona autoryzacji X pokazuje błąd, Social Quack pokazuje błąd zamiast ją otworzyć albo lądujesz na stronie zatytułowanej Connection failed | Zwykle Callback URI w X nie zgadza się z tym, który pokazuje Social Quack | Skopiuj adres przekierowania z okna Set up app keys jeszcze raz, wklej go w aplikacji w Settings → Callback URI, zapisz, a potem kliknij Connect na karcie X w Social Quacku |
| Przeglądarka zatrzymuje się na stronie Connected! i nie wraca do aplikacji | Nic złego się nie dzieje — Social Quack otwiera X w twojej zwykłej przeglądarce, a przeglądarka nie potrafi wskoczyć z powrotem do aplikacji | Zamknij kartę i przełącz się do Social Quack; konto jest już na stronie Channels |
| Po jakimś czasie posty przestają wychodzić, choć nic u ciebie się nie zmieniło | Skończyło się doładowanie — każdy post kosztuje centy | Billing → Credits, doładuj |
| Post nie wychodzi, błąd 429 albo coś z pięćsetek | X nakłada limit albo ma gorszy moment | Nic — Social Quack traktuje to jako chwilowe i sam ponawia post |
| Zgubiłeś API Key Secret | Pokazuje się tylko raz | Regenerate przy Consumer Key, wklej nową parę w Set up app keys i kliknij Save — w każdej przestrzeni roboczej, która korzysta z X, bo stara para przestaje działać wszędzie |
Nadal nie wychodzi? [email protected].