X (Twitter) koppelen

Eén eigen app in de console van X, een paar dollar tegoed, en je posts gaan op tijd de deur uit — met de sleutels versleuteld op je eigen Mac.

X is het enige platform in Social Quack waarvoor posten geld kost. Verder is het simpel: je maakt een eigen kleine developer-app aan, plakt twee sleutels in Social Quack en keurt de koppeling goed op de pagina van X zelf. Dat doe je één keer — het soort koppeling van X verloopt nooit, dus er is niets om elke paar weken opnieuw te koppelen.

Omdat de app van jou is, blijven de sleutels versleuteld op je eigen computer en is de posttoelage alleen van jou. Je deelt geen pot met de accounts van anderen, dus niemands activiteit kan jou afgeknepen krijgen.

1. Wat het kost

X heeft geen gratis postniveau meer. De oude toegang Free (Standard Basic) is afgeschaft — een app die daar nog op staat, wordt bij elke postpoging geweigerd. Om via de API van X te posten heb je een developeraccount nodig op het plan Pay Per Use, met wat tegoed erop. Een post kost een paar cent.

$5–10 opladen is ruim genoeg om te beginnen. Dit geldt alleen voor X; Bluesky, Mastodon en de andere platforms in Social Quack zijn gratis.

Begin in de app, dan staat de waarde die je moet kopiëren al op je scherm:

Channels (kanalen) in de zijbalk → de kaart X (Twitter) → Set up app keys (app-sleutels instellen).

(Zodra een workspace sleutels heeft opgeslagen, heet die knop Edit app keys (app-sleutels bewerken) — hij opent hetzelfde venster.)

In dat venster staan de twee velden die je aan het eind invult en, daarboven, het redirect-adres dat X de Callback URI noemt, met een kopieerknop ernaast. Daar zit de poort in waarop deze kopie van Social Quack draait, dus haal hem met de kopieerknop op in plaats van hem over te typen — X weigert hem als er één teken niet klopt. Laat dat venster openstaan.

3. Maak een Pay Per Use-project aan en laad tegoed op

Ga naar https://console.x.com en open Projects. Je hebt een project nodig op het plan Pay Per Use. Heb je alleen een oud Free (Standard Basic)-project, dan werkt dat niet meer — gebruik het Pay Per Use-project, of maak er een aan.
Billing → Credits: laad $5–10 op.

4. Maak de app aan

Binnen het Pay Per Use-project: Apps → Create App.

Heb je al een app in een oud project staan? Dan kun je hem ook verplaatsen, via Project Access → Manage.

5. Zet de permissies en het callback-adres goed

Open de app → Settings, in het blok Authentication settings:

Instelling	Wat erin moet
Permissions	Read and write
Type of App	Web App
Callback URI	het redirect-adres dat Social Quack toont op het scherm Set up app keys — gebruik de kopieerknop en plak het er precies zo in
Website	een willekeurige URL

Opslaan. Doe dit vóór de volgende stap: sleutels die zijn gemaakt voordat je de permissies wijzigde, houden het oude niveau, en de koppeling mislukt dan nadat je bij X hebt goedgekeurd.

6. Kopieer de API Key en het Secret

App → Keys & Tokens → OAuth 1.0 Keys → Regenerate de Consumer Key, en kopieer daarna de twee waarden die je te zien krijgt:

API Key (Consumer Key)
API Key Secret (Consumer Secret)

Het secret wordt één keer getoond. Sluit je de pagina zonder het te kopiëren, genereer dan gewoon opnieuw — en genereer sowieso opnieuw telkens als je de permissies van de app wijzigt.

Opnieuw genereren vervangt het oude paar overal: X ondertekent elk van je posts met deze sleutels, dus zodra je opnieuw genereert, zijn de oude dood. Heb je ze in meer dan één workspace geplakt, open dan in elk van die workspaces het venster Set up app keys en plak het nieuwe paar daar ook — bij het opslaan gaat de autorisatiepagina van X weer open, en met goedkeuren wordt dat account er bovenop opnieuw gekoppeld, met behoud van alles in de wachtrij. Een workspace die op de oude sleutels blijft staan, kan niet meer posten.

7. Plak ze erin en koppel

Terug in Social Quack, op datzelfde venster Set up app keys: plak ze in API Key (Consumer Key) en API Key Secret (Consumer Secret) en klik op Save (opslaan). Verder hoef je nergens op te drukken — met het opslaan van de sleutels gaat de autorisatiepagina van X meteen open in je browser. Keur hem goed voor het account waar je vanaf wilt posten. De browser komt daarna op een Connected!-pagina die je vraagt het tabblad te sluiten en terug te gaan naar Social Quack. Doe dat: het account staat al klaar op de pagina Channels.

Zodra de sleutels zijn opgeslagen, start de knop Connect (koppelen) op de X-kaart diezelfde autorisatie zelf — die gebruik je een andere keer, om een tweede account toe te voegen of er een opnieuw te koppelen.

Je kunt via dezelfde app meerdere accounts koppelen: één per workspace, als je merken gescheiden houdt. Elke workspace bewaart zijn eigen kopie van de sleutels, dus wissel van workspace in de zijbalk en plak dezelfde twee waarden in het venster Set up app keys van die workspace — ook daar gaat bij het opslaan de autorisatiepagina open. Eén app in X volstaat voor allemaal.

8. Wat je naar X kunt posten


Postlengte	280 tekens
Threads	Ja — elk deel gaat als reactie op het vorige de deur uit
Afbeeldingen	Maximaal 4, bij het eerste deel van een thread, met alt-tekst
Video	Ja

Foto's die groter zijn dan X accepteert, of in een formaat dat het niet aanneemt, worden voor je verkleind en omgezet voor ze de deur uit gaan — je hoeft zelf niets voor te bereiden.

Als er iets misgaat

Wat je ziet	Wat het betekent	Doe dit
De post mislukt met een 403 en `client-not-enrolled`	De app zit niet in een Pay Per Use-project — de oude gratis toegang werkt niet meer	Maak de app aan binnen het Pay Per Use-project, of verplaats hem daarheen met Project Access → Manage
X token exchange failed, op een Connection failed-pagina nadat je bij X hebt goedgekeurd	Meestal zijn de sleutels gemaakt voordat je de permissies van de app wijzigde, dus dragen ze nog het oude niveau. Het kunnen ook sleutels van een andere app zijn, of een secret dat bij het kopiëren is afgekapt	Keys & Tokens → OAuth 1.0 Keys → Regenerate, kopieer beide waarden opnieuw, plak het nieuwe paar in Set up app keys en klik op Save — de autorisatiepagina gaat weer open
X users/me failed, op diezelfde Connection failed-pagina	De app hangt niet aan een project met API-toegang	Controleer of de app echt in je Pay Per Use-project zit
X API Key / Secret not configured	Die workspace heeft geen sleutels opgeslagen — elke workspace bewaart zijn eigen kopie	Wissel in de zijbalk naar die workspace en ga dan naar Channels → X → Set up app keys, plak beide waarden en klik op Save
Posts naar één X-account beginnen te mislukken (X rejected the post, 401) nadat je de sleutels opnieuw hebt gegenereerd	Het nieuwe paar is alleen in de workspace terechtgekomen waar je op dat moment was; de andere workspaces houden de oude, nu dode sleutels vast	In elk van de andere: Set up app keys, plak het nieuwe paar, Save, opnieuw goedkeuren bij X. Het account wordt er bovenop opnieuw gekoppeld en de posts in de wachtrij blijven staan — verwijder het kanaal nooit, dat zou zijn posts wissen
De autorisatiepagina van X toont een foutmelding, Social Quack toont een foutmelding in plaats van hem te openen, of je komt op een pagina met de kop Connection failed	Meestal komt de Callback URI in X niet overeen met die Social Quack toont	Kopieer het redirect-adres opnieuw uit het venster Set up app keys, plak het bij App → Settings → Callback URI, sla op en klik daarna op Connect op de X-kaart in Social Quack
De browser blijft staan op een Connected!-pagina en brengt je niet terug	Er is niets mis — Social Quack opent X in je gewone browser, en een browser kan niet terugspringen in de app	Sluit het tabblad en ga terug naar Social Quack; het account staat al op de pagina Channels
Posts beginnen na een tijdje te mislukken, terwijl jij niets hebt veranderd	Je tegoed is op — elke post kost een paar cent	Billing → Credits, bijvullen
De post mislukt met een 429, of een foutmelding in de 500-serie	X knijpt je af of heeft een slecht moment	Niets — Social Quack ziet dit als tijdelijk en probeert de post vanzelf opnieuw
Je bent het API Key Secret kwijt	Het wordt maar één keer getoond	Regenerate de Consumer Key, plak het nieuwe paar in Set up app keys en klik op Save — in elke workspace die X gebruikt, want het oude paar werkt overal niet meer

Kom je er nog niet uit? [email protected].

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

X (Twitter) koppelen aan Social Quack