Perché una connessione API di Instagram smette di funzionare e come mantenerla attiva
Una connessione API di Instagram smette di funzionare quando Meta non accetta più il suo token oppure l'account non ne soddisfa più i requisiti: un token a lunga durata non rinnovato per 60 giorni, un cambio di password, un permesso o l'intera app rimossi dal proprietario, il passaggio a un account personale o una restrizione sull'account. Ognuno restituisce un errore proprio, e la maggior parte si risolve con il proprietario che accede di nuovo.
easyCoexistence controlla ogni connessione Instagram in ogni momento: rinnova il token ben prima che scadano i 60 giorni, verifica l'account ogni 6 ore, ti scrive una sola email quando Meta rifiuta l'accesso e invia alle piattaforme channel.disconnected, così una connessione caduta torna attiva con un solo accesso.
I token di Instagram non rinnovati entro 60 giorni scadono e non possono più essere rinnovati.
Sottocodice dell'API Graph, sotto il codice 190, per una sessione terminata da un cambio di password; la persona deve accedere di nuovo.
Delle consegne fallite dei webhook di messaggistica prima che Meta le disattivi e annulli l'iscrizione dell'app dall'account.
Meta può interrompere l'accesso di un'app ai permessi o alle funzioni che non ha usato entro un periodo di 28 giorni.
Con quale frequenza easyCoexistence controlla ogni account Instagram collegato, rinnovando il token ben prima che scadano i 60 giorni.
Perché una connessione API di Instagram smette di funzionare?
Perché Meta smette di accettare il token, oppure l'account smette di soddisfare i requisiti dell'API. La documentazione di Meta indica le cause, ciascuna con ciò che l'API restituisce e il passaggio che ripristina l'accesso. La maggior parte si manifesta prima come una chiamata fallita, ed è per questo che i controlli più avanti le cercano con una pianificazione:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A new sign-in, if the owner wants it back |
| Switched to a personal account | (#10) Access is denied because the instagram account type is not business or creator. | Back to Business or Creator, then a new sign-in |
| Allow access to messages off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A working endpoint, then a new subscription |
Quando scade un token e quando può essere ancora rinnovato?
Con Instagram Login, un token a lunga durata vale 60 giorni dall'ultimo rinnovo. Un rinnovo con grant_type=ig_refresh_token gli concede altri 60 giorni, a condizione che abbia almeno 24 ore, non sia scaduto e il proprietario abbia concesso instagram_business_basic. Trascorsi i 60 giorni, le chiamate falliscono con il codice 190 e solo un nuovo accesso aiuta. Con Unified Login, la configurazione stabilisce se il token scade.
Cosa fanno un cambio di password e un permesso rimosso?
Un cambio di password può terminare la sessione a cui appartiene il token: la guida agli errori dell'API Graph di Meta lo riporta come codice 190 con sottocodice 460 e indica che la persona deve accedere di nuovo all'app. Un permesso mai concesso o rimosso restituisce il codice 10, oppure un codice da 200 a 299; sui DM, il codice 200 con sottocodice 2534041 significa che il proprietario ha disattivato l'accesso ai messaggi. Le Condizioni della piattaforma di Meta permettono inoltre di interrompere l'accesso di un'app a un permesso o a una funzione non usati per 28 giorni.
Cosa succede quando il proprietario rimuove l'app?
Il suo accesso ai dati non pubblici termina. Il proprietario rimuove l'app in Instagram alla voce Autorizzazioni del sito web, App e siti web, Attive, e Meta richiama l'URL di callback di deautorizzazione salvato nelle impostazioni di accesso aziendale dell'app. Il Centro assistenza di Instagram precisa che un'app rimossa può accedere, da quel momento, solo alle informazioni pubbliche dell'account, quindi la connessione è chiusa finché il proprietario non accede di nuovo.
Cosa succede quando l'account cambia tipo o viene limitato?
Entrambi portano l'account fuori da ciò che l'API serve. L'API di Meta lavora solo con account professionali, e la tabella di risoluzione dei problemi di Unified Login riporta il messaggio (#10) Access is denied because the instagram account type is not business or creator per un account passato a personale: il proprietario torna indietro, poi si ricollega. Un account limitato, inattivo o sottoposto a checkpoint restituisce il codice 25 con sottocodice 2207050, che il proprietario risolve nell'app Instagram.
Come smettono di arrivare i webhook?
Attraverso un endpoint che fallisce. Meta ritenta una notifica di Instagram per fino a 36 ore, ma le consegne di messaggistica sono più severe: dopo 15 minuti di errori, un avviso arriva all'account sviluppatore, e dopo un'ora Meta invia un avviso Webhooks Disabled e annulla l'iscrizione dell'app dall'account. Quando l'endpoint torna a funzionare, POST /<IG_ID>/subscribed_apps con gli stessi campi riattiva le notifiche.
Come si nota un calo prima che se ne accorgano gli utenti?
Controllando la connessione a intervalli regolari invece di aspettare che un post fallisca:
- Salva
expires_inda ogni scambio e rinnovo del token, ben prima del giorno 60, una volta che il token ha un giorno. - Esegui una chiamata autenticata economica a intervalli regolari, come GET /me?fields=
user_id,username, e tratta il codice 190 o 102 come un segnale di riconnessione. - Implementa il callback di deautorizzazione, così la rimozione nelle impostazioni di Instagram ti raggiunge subito.
- Leggi gli Avvisi per sviluppatori e l'email aziendale collegata all'app, dove Meta invia avvisi su webhook e revisioni.
- Registra codice, sottocodice e
fbtrace_iddi ogni errore per account, così una restrizione si distingue da una richiesta errata.
Come si riconnette ogni caso?
La maggior parte delle cause si risolve con lo stesso passaggio, un nuovo accesso da parte del proprietario dell'account, che emette un nuovo codice e un nuovo token. Le eccezioni sono impostazioni che il proprietario modifica nell'app Instagram:
- Token scaduto, cambio di password, app o permesso rimossi: fai accedere di nuovo il proprietario e fagli approvare i permessi.
- Account personale: torna su Aziendale o Creator nell'app Instagram, poi accedi di nuovo.
- Messaggi disattivati: attiva Consenti l'accesso ai messaggi in Strumenti connessi; non serve un nuovo accesso.
- Account limitato: completa ciò che chiede l'app Instagram; un nuovo accesso non cambia nulla.
- Webhook disattivati: correggi l'endpoint, poi reiscrivi l'account.
Cosa fa easyCoexistence per mantenere attiva una connessione?
Controlla ogni account Instagram collegato in ogni momento. Rinnova il token non appena restano meno di 20 dei suoi 60 giorni, verifica l'account ogni 6 ore con GET /me e segna la connessione per la riconnessione nel momento in cui Meta rifiuta il token, sia in quel controllo sia in una chiamata di uno strumento. Risponde subito alle consegne dei webhook di Meta e le inoltra in seguito; quando il proprietario rimuove l'app dalle impostazioni di Instagram, il callback di deautorizzazione di Meta chiude la connessione e la toglie dalla fatturazione.
Come ti avvisa easyCoexistence e come ti riconnetti?
Una volta sola, via email, indicando l'account, con un pulsante che porta alla pagina del canale; le piattaforme ricevono anche un evento channel.disconnected firmato. Finché il proprietario non interviene, list_social_accounts mostra lo stato e l'ultimo errore di Meta, e gli strumenti rispondono che l'account va ricollegato. La riconnessione è un unico accesso con lo stesso account Instagram, che riattiva la stessa connessione con le sue impostazioni.
Errori comuni
- Rinnovare un token solo dopo che una chiamata è fallita. Una volta scaduto, Meta rifiuta il rinnovo, quindi programma i rinnovi finché è ancora valido.
- Rimandare un account limitato al login. Il codice 25 con sottocodice 2207050 descrive lo stato dell'account, che il proprietario risolve nell'app Instagram.
- Lasciare non impostato il callback di deautorizzazione. Una rimozione nelle impostazioni di Instagram emerge allora solo quando fallisce la chiamata successiva.
- Correggere un endpoint guasto e aspettare. Dopo un avviso Webhooks Disabled, le notifiche restano spente finché l'account non viene reiscritto con POST /<IG_ID>/subscribed_apps.
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.
Domande frequenti
Usare un token Instagram gli impedisce di scadere?
No. Solo un rinnovo estende un token a lunga durata, e uno che passa 60 giorni senza rinnovo scade, comunque lo si sia usato.
Instagram rimuove un'app aziendale dopo 90 giorni di inattività?
No. Il Centro assistenza di Instagram afferma che le app con permessi per gestire account aziendali e creator non scadono dopo 90 giorni di inattività.
Un account disconnesso conta ancora in fattura su easyCoexistence?
Sì, finché non lo riconnetti o non lo rimuovi. Un account il cui proprietario ha rimosso l'app dalle impostazioni di Instagram esce dal conteggio non appena Meta segnala la rimozione.
Quanto costa a easyCoexistence monitorare un account Instagram?
Il monitoraggio è incluso in ogni connessione: da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.
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