Marketing Digitale · 6 min read · 19 novembre 2026

API Meta v21: stop il 21 gennaio

Meta ritira la Graph API v21 il 21 gennaio 2027. Feed Instagram, lead ads, catalogo: cosa devono controllare le aziende di Monaco prima della scadenza.

API Meta v21: stop il 21 gennaio

Il 21 gennaio 2027 Meta ritira la versione 21.0 della sua Graph API, l'interfaccia con cui siti web e strumenti aziendali dialogano con Facebook e Instagram. Il changelog ufficiale di Meta indica la v21.0 come disponibile «until January 21, 2027». La v22.0 seguirà il 20 maggio 2027 e la v23.0 l'8 ottobre 2027.

Il vostro sito non smetterà di funzionare da un giorno all'altro. Il vero rischio è che continui a funzionare in modo diverso. Secondo la guida al versioning di Meta, quando una versione non è più utilizzabile, le chiamate rivolte a quella versione vengono instradate verso la versione disponibile più vecchia successiva. Integrazioni che nessuno tocca dal 2024 passano così a regole nuove senza alcun avviso. Di solito non succede nulla di visibile. A volte però un feed Instagram resta vuoto, un modulo contatti smette di alimentare il CRM o un catalogo prodotti non si sincronizza più, e passano settimane prima che qualcuno se ne accorga.

A Monaco Instagram è un vero canale di vendita per immobiliare, ospitalità, yachting e commercio di lusso. Conviene verificare prima della pausa natalizia.

Cosa cambia in concreto

Meta pubblica una nuova versione della Graph API circa due volte l'anno. Ogni versione è garantita per almeno due anni, poi viene rimossa. Il calendario attuale, secondo la documentazione per sviluppatori di Meta:

  • v21.0, uscita a ottobre 2024, disponibile fino al 21 gennaio 2027
  • v22.0, uscita a gennaio 2025, fino al 20 maggio 2027
  • v23.0, uscita a maggio 2025, fino all'8 ottobre 2027
  • v25.0, uscita a febbraio 2026, fino al 29 luglio 2028
  • v27.0, la più recente, uscita il 4 novembre 2026

La Marketing API, usata per gestire le inserzioni e i relativi report, ha un versioning separato, con aggiornamenti automatici introdotti da Meta a luglio 2026. Se gestite le campagne tramite uno strumento di terze parti, la responsabilità è del fornitore, ma fatevi confermare per iscritto che è aggiornato.

Un consiglio pratico: se uno sviluppatore aggiorna ora, passare alla v22 o alla v23 è fatica sprecata, perché scadono entrambe nel 2027. Chiedete la v25 o successive.

Chi è interessato a Monaco

Probabilmente non dovete fare nulla se pubblicate su Instagram e Facebook solo dalle app o da Meta Business Suite e il vostro sito si limita a rimandare ai vostri profili.

Controllate con più attenzione se usate uno di questi elementi:

  • Un feed Instagram incorporato nel sito. Molti di questi plugin e widget sono stati configurati una volta, anni fa, con una propria app Meta e un proprio token di accesso.
  • Inserzioni con modulo (lead ads) su Facebook o Instagram che inviano automaticamente i contatti a un CRM, a un foglio di calcolo o a uno strumento di e-mail marketing. È molto diffuso nell'immobiliare e nei servizi privati, dove un guasto silenzioso significa richieste perse.
  • La sincronizzazione del catalogo prodotti tra il negozio online e Instagram o Facebook Shops, oppure un pixel Meta e una Conversions API installati da uno sviluppatore invece che dall'app ufficiale della vostra piattaforma.
  • Il pulsante «Accedi con Facebook» in un'area riservata, in un motore di prenotazione o su un sito per eventi.
  • Dashboard o report su misura che recuperano da Meta follower, rendimento dei post o spesa pubblicitaria.

Se il vostro negozio è su Shopify o WooCommerce con l'app Meta ufficiale, in genere è la piattaforma a gestire gli aggiornamenti. Il rischio si concentra su codice personalizzato, plugin datati e integrazioni realizzate da un freelance che non è più reperibile.

Come verificare in un pomeriggio

  1. Aprite Meta for Developers (developers.facebook.com) con l'account che gestisce le risorse aziendali e guardate l'elenco «Le mie app». La dashboard di ogni app mostra quali versioni dell'API vengono chiamate. Un'app che non riconoscete è già di per sé una scoperta.
  2. Chiedete a ogni fornitore collegato a Meta (agenzia web, fornitore del CRM, motore di prenotazione, plugin del feed) quale versione della Graph API utilizza. Pretendete un numero di versione, non un generico «siamo aggiornati».
  3. Testate ciò che si vede. Inviate un contatto di prova dal modulo e verificate che arrivi nel CRM. Caricate il feed Instagram del sito. Modificate un prezzo e controllate che si aggiorni nello shop Instagram.
  4. Mettete tutto per iscritto. Una pagina con gli strumenti collegati a Meta, chi li gestisce e quale versione usano vi farà risparmiare tempo alla prossima scadenza, a maggio.

Correggere ciò che emerge

Nella maggior parte dei casi l'intervento è minimo: aggiornare un plugin, ricollegare un account per ottenere un nuovo token di accesso, oppure far cambiare a uno sviluppatore il numero di versione e testare. Il lavoro aumenta se un'integrazione dipende da un campo o da un endpoint che Meta nel frattempo ha eliminato. In quel caso è meglio scoprirlo a dicembre che da un cliente.

È anche il momento giusto per fare pulizia. Una vecchia app Meta con un token attivo è un rischio per la sicurezza, e ogni integrazione inutilizzata è una cosa in più da mantenere. I clienti della nostra gestione social media ricevono questo controllo di serie, e la parte tecnica rientra nei nostri servizi di manutenzione e assistenza del sito.

Una nota sulla protezione dei dati a Monaco

Lead ads, pixel e Conversions API trasferiscono dati personali tra la vostra azienda e Meta. A Monaco il quadro di riferimento è la Legge n. 1.565 del 3 dicembre 2024, sotto la vigilanza dell'APDP. Monaco non è uno Stato membro dell'UE e il GDPR non vi si applica in quanto tale. Se dalla verifica emergono integrazioni sconosciute o flussi verso Meta che la vostra informativa privacy non menziona, aggiornate registri e informativa. Gli obblighi precisi dipendono dalla vostra attività: fateli confermare da un consulente qualificato. La nostra pagina sulla protezione dei dati APDP spiega come gestiamo l'aspetto tecnico.

In sintesi

  • Scadenza: 21 gennaio 2027 per la Graph API v21.0, confermata dal changelog per sviluppatori di Meta. La v22.0 segue il 20 maggio 2027.
  • Rischio: le chiamate scadute passano senza avviso a una versione più recente. I guasti sono silenziosi e parziali, non evidenti.
  • Azione: censite gli strumenti collegati a Meta, chiedete a ogni fornitore il numero di versione, testate moduli, feed e catalogo e passate alla v25 o successive.

Non siete sicuri di cosa dipendano il vostro sito o il vostro CRM? Possiamo occuparci noi della verifica prima della scadenza. Contattateci.

metainstagramfacebookapimanutenzione sitomonaco

BSS Digital Agency

Agenzia digitale con sede a Monaco. Web, app, IA, marketing.

Contattaci