Tutte le guide

Collegare X (Twitter) a Social Quack

Una tua app nella console di X, qualche dollaro di credito, e i tuoi post escono puntuali — con le chiavi cifrate sul tuo Mac.

X è l'unica piattaforma di Social Quack su cui pubblicare costa qualcosa. Per il resto è semplice: crei una piccola app per sviluppatori tua, incolli due chiavi in Social Quack e approvi il collegamento sulla pagina di X. Lo fai una volta sola — il collegamento di X non scade mai, quindi non c'è niente da rifare ogni poche settimane.

Siccome l'app è tua, le chiavi restano cifrate sul tuo computer e la quota di pubblicazione è soltanto tua. Non condividi un gruppo con gli account di nessun altro, quindi l'attività altrui non può farti limitare.

1. Quanto costa

X non ha più un piano gratuito per pubblicare. Il vecchio accesso Free (Standard Basic) è deprecato: un'app rimasta lì viene rifiutata ogni volta che prova a pubblicare. Per pubblicare tramite l'API di X ti serve un account per sviluppatori sul piano Pay Per Use con un po' di credito caricato. Un post costa pochi centesimi.

Caricare 5–10 $ basta e avanza per iniziare. Vale solo per X: Bluesky, Mastodon e le altre piattaforme di Social Quack sono gratuite.

2. Apri prima la scheda di X in Social Quack

Parti dall'app, così il valore che dovrai copiare è già a schermo:

Channels (Canali) nella barra laterale → la scheda X (Twitter) → Set up app keys (configura le chiavi dell'app).

(Quando uno spazio di lavoro ha già le chiavi salvate, quel pulsante diventa Edit app keys (modifica le chiavi dell'app) e apre lo stesso pannello.)

In quel pannello ci sono le due caselle che riempirai alla fine e, sopra di esse, l'URL di reindirizzamento che X chiama Callback URI, con accanto un pulsante per copiarlo. Contiene la porta su cui gira questa copia di Social Quack, quindi prendilo dal pulsante invece di scriverlo a mano — X lo rifiuta se anche un solo carattere è sbagliato. Lascia quella finestra aperta.

3. Crea un progetto Pay Per Use e carica il credito

  1. Vai su https://console.x.com e apri Projects. Ti serve un progetto sul piano Pay Per Use. Se hai solo un vecchio progetto Free (Standard Basic), non funziona più: usa quello Pay Per Use, oppure creane uno.
  2. Billing → Credits: carica 5–10 $.

4. Crea l'app

Dentro il progetto Pay Per Use: Apps → Create App.

Hai già un'app in un vecchio progetto? Puoi spostarla, invece di crearne una, da Project Access → Manage.

5. Imposta i permessi e l'URL di callback

Apri l'app → Settings, nella sezione Authentication settings:

Impostazione Cosa mettere
Permissions Read and write
Type of App Web App
Callback URI l'URL di reindirizzamento che Social Quack mostra nella schermata Set up app keys — usa il suo pulsante per copiarlo e incollalo esattamente
Website un URL qualsiasi

Salva. Fallo prima del passo successivo: le chiavi create prima di un cambio di permessi mantengono il vecchio livello, e il collegamento poi fallisce dopo che hai approvato su X.

6. Copia API Key e Secret

App → Keys & Tokens → OAuth 1.0 Keys → Regenerate la Consumer Key, poi copia i due valori che ti mostra:

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

Il secret viene mostrato una volta sola. Se chiudi la pagina senza copiarlo, rigeneralo e basta — e rigeneralo ogni volta che cambi i permessi dell'app.

Rigenerare sostituisce la vecchia coppia dappertutto: X firma ogni tuo post con queste chiavi, quindi appena rigeneri le vecchie sono morte. Se le avevi incollate in più di uno spazio di lavoro, apri il pannello Set up app keys di ciascuno di quelli e incolla anche lì la coppia nuova — salvando si riapre la pagina di autorizzazione di X, e approvando quell'account si ricollega al suo posto, conservando tutto quello che ha in coda. Uno spazio di lavoro rimasto con le vecchie chiavi smette di poter pubblicare.

7. Incollale e collegati

Torna in Social Quack, sullo stesso pannello Set up app keys: incollale in API Key (Consumer Key) e API Key Secret (Consumer Secret) e clicca Save (salva). Non c'è altro da premere — salvando le chiavi si apre subito la pagina di autorizzazione di X nel tuo browser. Approvala per l'account da cui vuoi pubblicare. Il browser arriva poi su una pagina Connected! che ti dice di chiudere la scheda e tornare in Social Quack. Fallo: l'account ti aspetta già nella pagina Channels.

Una volta salvate le chiavi, il pulsante Connect (collega) sulla scheda di X avvia da solo quella stessa autorizzazione — è quello da usare un altro giorno, per aggiungere un secondo account o per ricollegarne uno.

Puoi collegare più account con la stessa app: uno per spazio di lavoro, se tieni i brand separati. Ogni spazio di lavoro conserva la sua copia delle chiavi, quindi cambia spazio di lavoro nella barra laterale e incolla gli stessi due valori nel pannello Set up app keys di quello spazio — salvando lì si apre la pagina di autorizzazione anche per lui. Una sola app su X li copre tutti.

8. Cosa puoi pubblicare su X

Lunghezza del post 280 caratteri
Thread Sì — ogni parte esce come risposta a quella precedente
Immagini Fino a 4, sul primo post di un thread, con testo alternativo
Video Sì

Le foto più grandi di quanto X accetti, o in un formato che non prende, vengono ridimensionate e convertite per te prima di uscire: non devi preparare niente.

Se qualcosa non funziona

Cosa vedi Che cosa significa Cosa fare
Il post fallisce con un 403 e client-not-enrolled L'app non è in un progetto Pay Per Use — il vecchio accesso gratuito non funziona più Crea l'app dentro il progetto Pay Per Use, oppure spostala lì con Project Access → Manage
X token exchange failed, su una pagina Connection failed dopo che hai approvato su X Di solito le chiavi sono state create prima che cambiassi i permessi dell'app, quindi portano ancora il vecchio livello. Possono anche essere le chiavi di un'altra app, o un secret troncato mentre lo copiavi Keys & Tokens → OAuth 1.0 Keys → Regenerate, ricopia entrambi i valori, incolla la nuova coppia in Set up app keys e clicca Save — la pagina di autorizzazione si riapre
X users/me failed, sulla stessa pagina Connection failed L'app non è collegata a un progetto con accesso all'API Controlla che l'app stia davvero dentro il tuo progetto Pay Per Use
X API Key / Secret not configured Quello spazio di lavoro non ha chiavi salvate — ognuno conserva la sua copia Passa a quello spazio di lavoro nella barra laterale, poi Channels → X → Set up app keys, incolla entrambe e clicca Save
I post di un account X iniziano a fallire (X rejected the post, 401) dopo che hai rigenerato le chiavi La coppia nuova è finita solo nello spazio di lavoro in cui eri; gli altri hanno ancora le vecchie chiavi, ormai morte In ognuno degli altri: Set up app keys, incolla la coppia nuova, Save, approva di nuovo su X. L'account si ricollega al suo posto e i suoi post in coda restano — non rimuovere mai il canale, cancellerebbe i suoi post
La pagina di autorizzazione di X mostra un errore, Social Quack mostra un errore invece di aprirla, oppure arrivi su una pagina intitolata Connection failed Di solito il Callback URI su X non coincide con quello che mostra Social Quack Ricopia l'URL di reindirizzamento dal pannello Set up app keys, incollalo in App → Settings → Callback URI, salva, poi clicca Connect sulla scheda di X in Social Quack
Il browser si ferma su una pagina Connected! e non ti riporta indietro Non c'è niente che non va — Social Quack apre X nel tuo browser normale, e un browser non può rientrare dentro l'app Chiudi la scheda e torna in Social Quack: l'account è già nella pagina Channels
Dopo un po' i post iniziano a fallire, senza che tu abbia cambiato niente Il credito è finito — ogni post costa qualche centesimo Billing → Credits, ricarica
Il post fallisce con un 429, o con un errore intorno al 500 X ti sta limitando o sta avendo un momento no Niente — Social Quack li considera problemi temporanei e riprova da solo
Hai perso l'API Key Secret Viene mostrato una volta sola Regenerate la Consumer Key, incolla la coppia nuova in Set up app keys e clicca Save — in ogni spazio di lavoro che usa X, perché la vecchia coppia smette di funzionare dappertutto

Ancora bloccato? [email protected].

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