How-to guide

Come programmare post su un'istanza di Mastodon

Last updated: 2026-05-23 · Mastodon · By SocialKit Team

A differenza delle reti centralizzate, Mastodon non ha un unico server — il tuo account vive su un'istanza specifica, e ogni programmatore di terze parti deve connettersi a quell'istanza individualmente. Questa guida percorre il flusso esatto in SocialKit: autorizzare il tuo server di origine, gestire il limite di caratteri e le impostazioni di visibilità, programmare in anticipo con i dati del momento migliore, e gestire più istanze da un unico calendario.

Prima di iniziare

Hai bisogno di un account SocialKit — la prova gratuita di 7 giorni (0,00 € oggi) è sufficiente per connettere la tua prima istanza di Mastodon e programmare il tuo primo post.

Hai anche bisogno delle tue credenziali Mastodon e del nome di dominio esatto della tua istanza (ad esempio, mastodon.social, fosstodon.org, infosec.exchange o qualsiasi altro server). Il dominio è visibile nel tuo identificatore di account: la parte dopo il @ è l'URL della tua istanza. Annotalo prima di iniziare — il flusso OAuth di SocialKit ti chiede di inserirlo per instradare l'autorizzazione al server corretto.

Nota: un piccolo numero di amministratori di istanze Mastodon configura i propri server per bloccare o limitare i token di applicazioni di terze parti. Se incontri un errore dopo l'autorizzazione, contatta l'amministratore della tua istanza per confermare che la pubblicazione tramite API è consentita per il tuo livello di account. Questo è raro sulle istanze di uso generale, ma vale la pena verificarlo su server specializzati o su invito.

Step by step

  1. Trova il dominio esatto della tua istanza Mastodon

    Il tuo handle Mastodon ha il formato @nomeutente@istanza.dominio — la seconda parte, dopo l'ultimo @, è il server di cui hai bisogno. Accedi all'interfaccia web Mastodon di quel server e conferma l'URL nella barra degli indirizzi del browser: è il dominio base senza percorso (es. fosstodon.org, non fosstodon.org/@tuonome). Copialo esattamente — un singolo carattere errato fa fallire il reindirizzamento OAuth.

    Tip: Se hai account su più istanze Mastodon, gestiscile una alla volta. Annota ogni dominio prima di iniziare a connetterti per evitare confusione nei passaggi di autorizzazione.

  2. Connetti il tuo account Mastodon in SocialKit

    In SocialKit, apri le impostazioni del tuo spazio di lavoro e vai alla sezione account o connessioni. Scegli Mastodon dall'elenco delle piattaforme. SocialKit ti chiederà di inserire il dominio della tua istanza — incolla il dominio copiato nel passaggio precedente. Dopo la conferma, SocialKit ti reindirizza alla schermata di consenso OAuth di quell'istanza (ospitata sul tuo server, non sul dominio di SocialKit), dove autorizzi SocialKit a leggere e scrivere post per tuo conto. Approva le autorizzazioni richieste e tornerai a SocialKit con l'account connesso. A giugno 2026, SocialKit utilizza il flusso standard di autorizzazione app OAuth 2.0 di Mastodon; la tua password non viene mai inviata a o archiviata da SocialKit.

    Tip: Hai già effettuato l'accesso con l'account Mastodon sbagliato nel tuo browser? Apri prima una finestra privata/in incognito in modo che la pagina di autorizzazione mostri l'account corretto al caricamento.

  3. Verifica il limite di caratteri della tua istanza prima di scrivere

    Il limite di caratteri predefinito di Mastodon è di 500 per post, ma gli amministratori delle istanze possono aumentare (o teoricamente ridurre) questo valore. A giugno 2026, alcune istanze consentono 1.000, 5.000 o più caratteri per post. Prima di scrivere contenuti lunghi, controlla il limite effettivo della tua istanza: di solito è indicato nella pagina «Informazioni» dell'istanza, o puoi trovarlo guardando il contatore di caratteri nel compositore web nativo di Mastodon. Il compositore di SocialKit rifletterà il limite dell'istanza connessa — osserva il contatore di caratteri in tempo reale mentre scrivi.

    Tip: Se hai intenzione di condividere lo stesso testo su Bluesky (300 grafemi) o X (280 caratteri standard), redigi secondo il limite più restrittivo e poi espandi la versione specifica per Mastodon. La personalizzazione per piattaforma di SocialKit ti consente di adattare lo stesso post per ogni destinazione senza riscrivere da zero.

  4. Scrivi il tuo post e imposta visibilità e avviso di contenuto

    Nel compositore di SocialKit, scrivi il testo del tuo post e aggiungi immagini, video o link che vuoi includere. A giugno 2026, Mastodon supporta quattro livelli di visibilità: Pubblico (appare nella timeline pubblica e nel feed federato), Non in elenco (visibile a chiunque abbia il link ma non nelle timeline pubbliche), Solo follower (visibile solo ai tuoi follower) e Diretto (messaggio privato agli account menzionati). Seleziona la visibilità appropriata nelle impostazioni del compositore. Se il tuo contenuto è sensibile, nascosto dietro uno spoiler, o riguarda argomenti che la comunità della tua istanza solitamente contrassegna — come politica, discussioni sui media o salute personale — puoi aggiungere un Avviso di Contenuto (CW). Il CW diventa un'intestazione espandibile nei feed; il corpo del post è nascosto finché il lettore non lo espande. Questa è una forte norma culturale su molte istanze Mastodon, non solo un'opzione tecnica.

    Tip: Mastodon non ha un feed algoritmico — i post appaiono in ordine cronologico inverso. Ciò significa che il momento della pubblicazione conta più che sulle piattaforme ordinate per algoritmo: un post pubblicato quando il tuo pubblico è online viene visto; uno pubblicato alle 3 di notte del loro fuso orario viene rapidamente sepolto.

  5. Aggiungi testo alternativo alle immagini

    La comunità di Mastodon ha una forte norma sull'accessibilità delle immagini: i post con immagini senza testo alternativo vengono a volte potenziati (retwittati) meno volentieri dagli altri utenti, e alcune istanze hanno requisiti per il testo alternativo. Nel compositore di SocialKit, clicca su ogni immagine caricata per aggiungere una descrizione — una o due frasi che descrivono cosa mostra l'immagine sono sufficienti. Il testo alternativo è archiviato nei metadati dell'allegato multimediale e viene letto dai lettori di schermo quando il post raggiunge altre istanze. A giugno 2026, il testo alternativo è supportato tramite l'API di Mastodon e pubblicato con l'immagine.

  6. Scegli un orario di pubblicazione usando i dati del momento migliore

    Scegli una data e un orario specifici nel pianificatore di SocialKit, o lascia che la funzione di momento migliore di SocialKit suggerisca una finestra ottimale in base all'attività del tuo pubblico. Poiché Mastodon è in ordine cronologico inverso, pubblicare quando i tuoi follower sono attivi è il principale leva di portata. A giugno 2026, le ricerche generali suggeriscono che i giorni feriali a tarda mattinata e nel primo pomeriggio nel fuso orario del tuo pubblico hanno prestazioni costanti, ma le tue analisi saranno più accurate delle medie del settore — consulta la pagina /best-time-to-post/mastodon come punto di partenza, poi rivedi le tue analisi di SocialKit dopo alcune settimane.

    Tip: Se i tuoi follower sono distribuiti in fusi orari molto diversi, considera di pubblicare lo stesso contenuto due volte — alle 9 di mattina in un fuso orario e di nuovo in una fascia serale per l'altro — con testo leggermente variato per evitare che lo stesso duplicato appaia due volte nel feed dello stesso follower.

  7. Programma e conferma il post

    Rivedi il post nell'anteprima di SocialKit — controlla il conteggio dei caratteri, l'impostazione di visibilità, l'avviso di contenuto se applicabile, e il testo alternativo su tutte le immagini. Imposta la data e l'orario, poi clicca su Programma. A giugno 2026, SocialKit pubblica automaticamente i post Mastodon all'orario programmato tramite l'API di Mastodon — non è richiesto alcun passaggio manuale da parte tua. Vedrai il post nel tuo calendario SocialKit e potrai modificarlo o riprogrammarlo cliccandoci sopra prima dell'orario di pubblicazione.

    Tip: Programma un post di test a basso rischio pochi minuti dopo aver connesso il tuo account per la prima volta, per confermare che il flusso end-to-end funziona per la tua istanza specifica prima di programmare una settimana di contenuti.

  8. Aggiungi e gestisci istanze Mastodon aggiuntive

    Se hai account su più server Mastodon — ad esempio, un account personale su mastodon.social e un account professionale su un'istanza di nicchia — ripeti il flusso di connessione per ogni istanza usando il suo dominio specifico. SocialKit ti consente di gestire tutte le istanze connesse dallo stesso dashboard e calendario. Puoi programmare per una, più o tutte in un'unica sessione del compositore selezionando a quali account è destinato ogni post. Ogni istanza ha il proprio contatore di caratteri, opzioni di visibilità e cronologia dei post nel tuo spazio di lavoro SocialKit.

Best practices

  • Inserisci il dominio esatto della tua istanza senza barra finale o sottopercorso quando ti connetti — un dominio digitato erroneamente fa fallire il reindirizzamento OAuth con un errore confuso che sembra un problema di SocialKit ma è in realtà un problema di instradamento.
  • Controlla il limite di caratteri della tua istanza prima di scrivere post lunghi: il default di 500 caratteri è comune ma molte istanze lo estendono, e scrivere al limite sbagliato significa modifiche dell'ultimo minuto al momento della programmazione.
  • Aggiungi sempre il testo alternativo alle immagini prima di programmare — è una forte norma comunitaria sulla maggior parte delle istanze Mastodon e migliora l'accessibilità per gli utenti di lettori di schermo che incontrano il tuo post attraverso la federazione.
  • Usa gli avvisi di contenuto (CW) per i post che trattano argomenti che la comunità della tua istanza solitamente contrassegna — commenti politici, spoiler sui media e argomenti personali sensibili sono convenzioni CW comuni; non usarli può generare engagement negativo da parte di pubblici altrimenti ricettivi.
  • Il feed cronologico di Mastodon significa che il momento della pubblicazione conta più che sulle piattaforme ordinate per algoritmo — usa i dati di /best-time-to-post/mastodon come punto di partenza e affina in base alle tue analisi SocialKit dopo 2–3 settimane.
  • Dopo qualsiasi cambio di password dell'account Mastodon o evento di sicurezza dell'istanza, riautorizza la tua connessione SocialKit: i token OAuth sono legati alla concessione originale e possono essere invalidati dai reset di sicurezza lato server.

Good to know

Come il modello federato di Mastodon influisce sulla programmazione

La maggior parte delle piattaforme social funziona su un unico server, quindi "connettere il tuo account" significa un singolo handshake OAuth con un unico dominio. Mastodon è diverso: ogni istanza è un server operato in modo indipendente, e la tua connessione SocialKit deve puntare al server specifico su cui vive il tuo account.

Ecco perché il passaggio di inserimento del dominio dell'istanza è importante: SocialKit usa il dominio per costruire l'URL di autorizzazione OAuth per quel server. Se inserisci mastodon.social ma il tuo account è su fosstodon.org, la richiesta di autorizzazione va al server sbagliato e non si connette nulla.

Una volta connesso, la federazione lavora a tuo favore per la programmazione: un post pubblicato sulla tua istanza si propaga automaticamente alle timeline federate di altre istanze, quindi un post ben programmato raggiunge i lettori in tutto il fediverse senza alcuna configurazione aggiuntiva da parte tua.

I limiti di caratteri variano per istanza — non dare per scontato 500

Il software Mastodon viene fornito con un default di 500 caratteri, ma gli amministratori delle istanze possono modificare questo valore a livello di server. A giugno 2026, mastodon.social usa 500 caratteri; fosstodon.org, infosec.exchange e molti altri usano anch'essi 500; tuttavia, alcune istanze — in particolare quelle che eseguono Hometown o altri fork di Mastodon — consentono limiti significativamente più alti.

Il compositore di SocialKit legge il limite di caratteri dai metadati API della tua istanza connessa e lo riflette nel contatore in tempo reale, quindi il numero che vedi nel compositore è specifico al server di origine del tuo account, non un generico 500. Se condividi lo stesso post anche su Bluesky o X insieme a Mastodon, ricorda che queste piattaforme hanno limiti più restrittivi (Bluesky: 300 grafemi; X: 280 caratteri standard a giugno 2026) — la personalizzazione per piattaforma di SocialKit ti consente di regolare ogni versione separatamente.

Do it in SocialKit

SocialKit si connette a qualsiasi istanza Mastodon, rispetta i limiti di caratteri per server e pubblica automaticamente all'orario programmato — senza passaggi manuali. Gestisci più istanze insieme alle tue altre 11 piattaforme social da un unico calendario. Prova gratuita di 7 giorni, 0,00 € oggi.

Programma i tuoi post Mastodon con SocialKit
All 11 platforms included

Try it free

Schedule and cross-post to all 11 networks from one calendar on one flat plan. 7-day free trial — €0.00 due today.

Inizia la mia prova gratuita

0,00 € oggi · disdici quando vuoi · garanzia di rimborso di 7 giorni

FAQ

Frequently asked questions

The questions people ask before they schedule — answered honestly, hedged where platform behavior changes.

Inizia la mia prova gratuita

0,00 € oggi · disdici quando vuoi · garanzia di rimborso di 7 giorni