Guida all'API di Instagram nel 2026: dalla tua app al primo post
Nel 2026 l'API di Instagram porta un'app al suo primo post in sei passaggi: un account professionale, una configurazione del login, un'app Meta, i permessi al livello di accesso corretto, un access token, poi un container multimediale creato con POST /<IG_ID>/media e pubblicato con media_publish. Commenti, DM, webhook, insight e limiti di Meta vengono dopo. Per le nuove app, Meta raccomanda Unified Login.
easyCoexistence trasforma i passaggi da 2 a 5 in un unico accesso con Instagram: la sua app Meta gestisce il login, rinnova il token prima che scada e controlla l'account ogni 6 ore, mentre Claude, ChatGPT o la tua piattaforma pubblicano, programmano, rispondono a commenti e DM e leggono gli insight tramite l'API ufficiale di Meta.
Unified Login, raccomandato per le nuove integrazioni, più Instagram Login e Facebook Login, mantenuti per quelle esistenti.
Le app Meta create di recente non possono configurare l'API di Instagram con Instagram Login, secondo la guida alla migrazione di Meta.
Quanto dura un access token di lunga durata di un utente Instagram; è possibile un rinnovo una volta che ha 24 ore.
Post pubblicati tramite API che un account può fare in un periodo mobile di 24 ore, contando un carosello come uno.
Quanto richiede di solito la App Review, secondo quanto dichiara Meta; di norma una richiesta viene elaborata in meno di una settimana.
Quali sono i passaggi da una nuova app al primo post?
Sei passaggi portano al primo post, e altri quattro determinano cosa fa l'app dopo. L'account deve essere professionale, l'app sceglie una delle tre configurazioni di login di Meta, il titolare dell'account concede i permessi e il server dell'app conserva un token. La pubblicazione richiede poi due chiamate. Seguono commenti, DM, webhook, insight e limiti, e le ultime sezioni indicano la pagina che copre ogni passaggio per intero.
Passaggio 1: quale account Instagram funziona con l'API?
Un account professionale, aziendale o Creator. L'Instagram Platform di Meta serve solo account professionali, e entrambi i tipi funzionano allo stesso modo per pubblicazione, commenti, DM e insight. Un account personale si converte dall'app Instagram, alla voce Tipo di account e strumenti, e un account privato diventa pubblico nel farlo. Instagram Login e Unified Login non richiedono una Pagina collegata, mentre Facebook Login ne richiede una.
Passaggio 2: quale configurazione di login deve usare l'app?
Meta ne documenta tre, e la scelta fissa l'host, il token e i nomi dei permessi. La sua panoramica raccomanda Unified Login per le nuove integrazioni, la sua pagina su Unified Login dice che le nuove funzionalità dell'API di Instagram vengono rilasciate solo lì, e la sua guida alla migrazione dice che le app appena create non possono configurare Instagram Login. Le integrazioni esistenti con Instagram Login continuano a funzionare, senza una data di fine annunciata.
- Unified Login: il cliente accede con Instagram o tramite Facebook Login, sceglie un Business Portfolio e l'app riceve un token Business Integration System User.
- Instagram Login: il titolare accede con Instagram e le chiamate vanno a graph.instagram.com con un token utente Instagram e i permessi instagram_business_*.
- Facebook Login: l'account deve essere collegato a una Pagina che la persona può gestire, con i permessi instagram_* e Pagina.
Passaggio 3: come si crea l'app Meta?
Nella App Dashboard, lungo un percorso che dipende dalla configurazione. La guida di Meta a Unified Login parte da un'app con il caso d'uso Gestisci messaggi e contenuti su Instagram, di proprietà di un Business Portfolio. Sotto la voce API setup with Unified login, l'app crea una configurazione, il cui config_id indica i permessi e gli asset da richiedere, salva un URL di reindirizzamento HTTPS e copia l'URL di login. Un'app Instagram Login esistente conserva API setup with Instagram login, dove vivono il suo ID app Instagram e il suo app secret.
Passaggio 4: quali permessi e quale livello di accesso serve all'app?
Un permesso per funzionalità, concesso dal titolare dell'account al momento dell'accesso. Unified Login usa la famiglia instagram_*, come instagram_content_publish e instagram_manage_comments, e Instagram Login i nomi instagram_business_*. Lo Standard Access, quello predefinito, copre gli account che possiedi o gestisci e le persone con un ruolo sull'app. Servire gli account di altre aziende richiede l'Advanced Access, concesso permesso per permesso tramite App Review, con la Business Verification.
Passaggio 5: come ottiene l'app un access token?
Dall'accesso del titolare, scambiato sul server e mai in un browser o in un'app mobile. Con Instagram Login, il reindirizzamento porta un codice valido per un'ora e utilizzabile una sola volta; diventa un token a breve durata, poi uno a lunga durata che vale 60 giorni e può essere rinnovato una volta che ha un giorno. Con Unified Login, il codice diventa un token Business Integration System User, la cui scadenza dipende dalla configurazione.
Passaggio 6: come si pubblica un primo post?
Con due chiamate. POST /<IG_ID>/media con un image_url pubblico, che Meta recupera da sola, crea un container; POST /<IG_ID>/media_publish con l'ID di quel container come creation_id lo pubblica e restituisce l'ID del media. Le immagini devono essere in JPEG. Per un Reel o un altro video, controlla lo status_code del container finché non riporta FINISHED, perché pubblicare prima fallisce.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }Passaggio 7: come funzionano commenti e DM?
Entrambi partono da qualcun altro. GET /<IG_MEDIA_ID>/comments restituisce fino a 50 commenti di primo livello per richiesta, POST /<IG_COMMENT_ID>/replies risponde a uno pubblicamente, e una risposta privata invia al mittente un solo DM entro 7 giorni dal commento. I DM vanno alle persone che hanno scritto per prime, entro una finestra standard di 24 ore per la maggior parte delle azioni, una volta che il titolare attiva Consenti l'accesso ai messaggi nell'app Instagram.
Passaggio 8: come i webhook dicono all'app cosa è successo?
Meta invia un JSON via POST a un endpoint HTTPS, che si dimostra una sola volta restituendo hub.challenge, e firma ogni evento in X-Hub-Signature-256 con un HMAC-SHA256 del payload, con chiave l'app secret. L'app seleziona campi come comments e messages nella App Dashboard, poi iscrive ogni account tramite il suo edge subscribed_apps. Le notifiche raggiungono solo le app in modalità Live, e le notifiche sui commenti richiedono l'Advanced Access.
Passaggio 9: come l'app legge gli insight?
Da due edge: GET /<IG_ID>/insights per l'account e GET /<IG_MEDIA_ID>/insights per un post, un Reel o una storia. Le metriche dell'account come reach, views e accounts_engaged richiedono period=day con metric_type=total_value. views ha sostituito impressions nel 2025, alcune metriche richiedono almeno 100 follower, e Meta segnala che i dati possono ritardare fino a 48 ore.
Passaggio 10: quali limiti condizionano l'app?
Meta fissa i suoi limiti principali per account, quindi un nuovo account porta la propria quota invece di condividerne una:
- Chiamate: 4.800 volte le impressioni dell'account in un periodo mobile di 24 ore, per app e account, messaggistica esclusa.
- Pubblicazione: 100 post pubblicati tramite API e 400 container multimediali per account in 24 ore.
- Messaggistica: 100 chiamate Send API al secondo per il testo, e 750 risposte private all'ora su post e Reel.
- Container: uno lasciato non pubblicato per 24 ore scade e va creato di nuovo.
Quale pagina copre ogni passaggio in dettaglio?
Ogni passaggio ha una propria pagina di riferimento in questa documentazione, con i campi, gli errori e i casi limite che questa guida tralascia. I percorsi qui sotto stanno sotto l'indirizzo del sito, e la pagina del codice mostra affiancate in Python e Node.js le chiamate per pubblicazione, commenti, insight e webhook:
Qual è il percorso tramite easyCoexistence?
Un unico accesso al posto dei passaggi da 2 a 5 e della configurazione dei webhook. Nella dashboard scegli Nuova connessione, poi Instagram, accedi con l'account aziendale o Creator e approva i suoi cinque permessi instagram_business_*; l'app Meta di easyCoexistence gestisce il login, rinnova il token e controlla l'account ogni 6 ore. Claude, ChatGPT o il tuo agente lavorano poi tramite https://easycoexistence.com/api/mcp, il tuo codice può prendere l'ID dell'account e la base dell'API da get_social_credentials, e i post possono essere programmati fino a 90 giorni in anticipo dalla coda di easyCoexistence.
Errori comuni
- Avviare una nuova app con Instagram Login. La guida alla migrazione di Meta dice che le app appena create non possono configurarlo, e la sua panoramica raccomanda Unified Login per le nuove integrazioni.
- Chiamare un'integrazione Unified Login con un token utente Instagram. La guida ai webhook di Meta dice che quei token e graph.instagram.com non funzionano con Unified Login.
- Pubblicare subito un container video. media_publish fallisce con il subcode 2207027 finché lo status_code del container non riporta FINISHED.
- Fare polling per commenti e DM. Meta raccomanda i webhook, che riducono le chiamate fatte dall'app e il rischio di superare i limiti di frequenza.
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Quanto tempo serve per ottenere l'accesso all'API di Instagram?
Per gli account che possiedi o gestisci, nessuna attesa: lo Standard Access funziona fin dall'inizio. Servire altre aziende richiede l'App Review, che Meta dice richiedere di solito meno di una settimana, e la Business Verification.
Una nuova app Meta può ancora usare Instagram Login?
Non secondo la guida alla migrazione di Meta, che dice che le app appena create non possono configurarlo. Le integrazioni Instagram Login esistenti continuano a funzionare, e Meta non ha annunciato alcuna data di fine.
L'API può pubblicare un file dal mio computer?
Non con Instagram Login, dove Meta recupera ogni immagine o video da un URL pubblico. Meta documenta gli upload riprendibili, che accettano un file video locale, per le configurazioni basate su Facebook Login for Business, incluso Unified Login.
Quanto costa easyCoexistence per un account Instagram?
Ogni account Instagram è una connessione: da US$ 9 a US$ 0,75 per connessione al mese, che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il