AccediInizia la prova gratuita
easyCoexistence API ufficiali

Errori dell'API di Instagram: cosa significano i codici comuni

Gli errori più comuni dell'API di Instagram sono 190 per un token scaduto o non valido, 4, 17 e 80002 per i limiti di frequenza, 9004 per i media che Meta non riesce a recuperare, 9007 per un video ancora in elaborazione, 9 per il tetto giornaliero di pubblicazione e 10 con sottocodice 2534022 per un DM fuori dalla finestra di messaggistica. Ciascuno arriva come JSON con un codice, spesso un sottocodice che indica il caso preciso, e un messaggio.

easyCoexistence si occupa della parte di connessione di questi errori: rinnova l'accesso a Instagram prima che scada, controlla l'account ogni 6 ore e ti invia un'email quando serve ricollegarlo.

190

Codice dell'API Graph per un token di accesso scaduto, revocato o comunque non valido.

80002

Codice di errore per il limite di frequenza Business Use Case di Instagram.

2207042

Sottocodice, sotto il codice 9, per un account che ha raggiunto il limite giornaliero di pubblicazione via API.

2207052

Sottocodice, sotto il codice 9004, per media che Meta non può recuperare dall'URL indicato.

2534041

Sottocodice, sotto il codice 200, quando l'account ha disattivato l'accesso ai suoi messaggi Instagram.

Come si legge un errore dell'API di Instagram?

Ogni errore è un oggetto JSON dentro error. code indica la categoria generale, error_subcode identifica il caso specifico ed è di solito il più utile dei due, mentre message lo descrive. Molti errori contengono anche error_user_title ed error_user_msg, testi destinati alla persona, e is_transient. fbtrace_id identifica la richiesta per il supporto di Meta e scade poco dopo, quindi registralo nel momento in cui l'errore si verifica.

Cosa significano gli errori di accesso e di permesso?

Errori su chi può fare cosa, con la correzione per ciascuno:

  • 190: il token di accesso è scaduto, revocato o comunque non valido; il sottocodice 463 indica scaduto, 467 non valido e 460 una password modificata. Un nuovo token risolve il problema, che per un account connesso significa ricollegarlo.
  • 10: permesso negato. Un permesso non è mai stato concesso o è stato rimosso in seguito.
  • Da 200 a 299: manca un permesso specifico, ad esempio 200 con sottocodice 2534041 quando l'account ha disattivato l'accesso ai suoi messaggi.
  • 25, sottocodice 2207050: l'account è limitato, inattivo o bloccato per un controllo di sicurezza; il titolare deve accedere all'app Instagram e completare ciò che viene richiesto.

Cosa significano gli errori di limite di frequenza?

Rallentamenti, tutti temporanei:

  • 4: troppe chiamate dall'app; attendi e riprova, oppure riduci il volume di richieste.
  • 17: troppe chiamate per l'utente; vale lo stesso rimedio.
  • 80002: il limite Business Use Case di Instagram, calcolato per app e account in base alle impressioni dell'account: 4.800 chiamate per impressione in 24 ore.
  • 613, sottocodice 2534040: troppe chiamate di messaggistica; fermati e riprova più tardi.

Cosa significano gli errori di pubblicazione legati al media?

Errori sul file e sul punto in cui è ospitato; allo stato attuale vale la pena riprovare solo il timeout:

  • 9004, sottocodice 2207052: Meta non può recuperare il media dall'URL; assicurati che sia valido e pubblico.
  • -2, sottocodice 2207003: il download ha richiesto troppo tempo; questo caso vale la pena riprovarlo.
  • 36000, sottocodice 2207004: l'immagine supera gli 8 MB.
  • 36001, sottocodice 2207005: il formato dell'immagine non è supportato; usa JPEG.
  • 36003, sottocodice 2207009: il rapporto d'aspetto è fuori dall'intervallo da 4:5 a 1.91:1.
  • 352, sottocodice 2207026: il formato video non è supportato; usa MOV o MP4.

Cosa significano gli errori di pubblicazione legati a tempi e limiti?

Errori su quando e quanto, risolti quasi sempre con un'attesa o ricominciando da capo:

  • 9007, sottocodice 2207027: il media non è ancora pronto; attendi che lo status_code del container risulti FINISHED.
  • 24, sottocodice 2207008: il container non esiste o è scaduto; riprova una o due volte tra 30 secondi e 2 minuti, poi creane uno nuovo.
  • -2, sottocodice 2207020: il media è scaduto; crea un nuovo container.
  • 9, sottocodice 2207042: l'account ha raggiunto il limite giornaliero di pubblicazione; riprova il giorno successivo.
  • 100, sottocodice 2207028: un carosello richiede da 2 a 10 elementi.
  • 36004, sottocodice 2207010: la didascalia è troppo lunga; i limiti di Meta sono 2.200 caratteri e 20 tag @, e il suo riferimento elenca 30 hashtag, anche se Instagram ne consente 5 per post.
  • 4, sottocodice 2207051: Instagram ha limitato l'azione perché sospettata di spam.

Cosa significano gli errori di messaggistica?

Errori dai DM e dalle risposte private:

  • 10, sottocodice 2534022: il messaggio è stato inviato fuori dalla finestra consentita; attendi che la persona scriva di nuovo.
  • 100, sottocodice 2534014: nessun utente Instagram corrispondente; usa l'ID con ambito Instagram dal webhook, non un ID utente Instagram.
  • 100, sottocodice 2534025: il commento non può ricevere una risposta privata.
  • 100, sottocodice 2534037: un'altra app, compresa la Business AI di Meta, controlla la conversazione.
  • 551, sottocodice 1545041: la persona non è disponibile in questo momento.

Cosa significano gli errori delle statistiche?

Le richieste di statistiche falliscono in tre modi documentati:

  • 10, spettatori insufficienti perché il media mostri le statistiche: una metrica delle Storie sotto 5.
  • Una metrica ritirata, come le impressioni dal 21 aprile 2025, restituisce un errore; chiedi invece le visualizzazioni.
  • Un errore sconosciuto quando una delle metriche richieste non supporta la suddivisione richiesta.

Quali errori vale la pena riprovare?

Solo quelli temporanei: i codici 1 e 2, gli errori del server di Instagram 2207001 e 2207032, il timeout di download 2207003, il container temporaneamente assente 2207008 e i limiti di frequenza una volta trascorsa l'attesa. Tutto il resto dà la stessa risposta finché non cambia qualcosa, che sia il file, l'URL, un permesso, lo stato dell'account o la finestra della persona, e riprovare significa solo consumare il limite di frequenza.

Errori comuni

  • Riprovare un errore di formato o di dimensione. 2207004, 2207005, 2207009 e 2207026 falliscono allo stesso modo finché il media non cambia.
  • Considerare 9007 come un fallimento. Il video è ancora in elaborazione; pubblica quando il container risulta FINISHED.
  • Leggere solo il codice. Codici come 10 e 100 coprono molti casi, e il sottocodice è ciò che individua quello preciso.
  • Eliminare fbtrace_id dai log. Il supporto di Meta lo chiede, e scade poco dopo l'errore.
Farlo con EasyCoexistence

Claude, ChatGPT o il tuo codice poi chiamano l'API ufficiale di Meta con un token sempre aggiornato. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Cosa significa l'errore 190 su Instagram?

Il token di accesso è scaduto, revocato o comunque non valido, ad esempio dopo un cambio di password. Un nuovo token lo risolve e, per un account connesso, significa ricollegarlo.

Perché la pubblicazione fallisce con 9004?

Meta non può recuperare il media dall'URL indicato, sottocodice 2207052. Verifica che il link sia valido e pubblico, senza accesso con login, nel momento in cui pubblichi.

Cos'è l'errore 9007?

Il video nel container è ancora in elaborazione, sottocodice 2207027. Controlla lo status_code del container e pubblica quando risulta FINISHED.

Cos'è fbtrace_id in un errore dell'API di Instagram?

Un identificativo della richiesta non riuscita, che il supporto di Meta chiede quando segnali un problema. Scade poco dopo l'errore, quindi scrivilo nei log nel momento in cui accade.

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