Waarom een Instagram API-verbinding stopt en hoe je die actief houdt
Een Instagram API-verbinding stopt met werken wanneer Meta het token niet meer accepteert of het account niet langer in aanmerking komt: een langlevend token dat 60 dagen niet is vernieuwd, een wachtwoordwijziging, een recht of de hele app verwijderd door de eigenaar, een wissel naar een persoonlijk account, of een beperking op het account. Elke oorzaak geeft een eigen foutmelding, en de meeste worden verholpen doordat de eigenaar opnieuw inlogt.
easyCoexistence bewaakt elke Instagram-verbinding de klok rond: het vernieuwt het token ruim voordat de 60 dagen verstrijken, controleert het account elke 6 uur en mailt je één keer wanneer Meta de toegang weigert.
Instagram-tokens die binnen 60 dagen niet zijn vernieuwd, verlopen en kunnen daarna niet meer worden vernieuwd.
Graph API-subcode onder code 190 voor een sessie die is beëindigd door een wachtwoordwijziging; de persoon logt opnieuw in.
Na mislukte webhook-afleveringen voor berichten schakelt Meta ze uit en ontkoppelt het de app van het account.
Meta kan de toegang van een app tot rechten of functies beëindigen die binnen een periode van 28 dagen niet zijn gebruikt.
easyCoexistence controleert elk verbonden Instagram-account regelmatig en vernieuwt het token ruim voordat de 60 dagen verstrijken.
Waarom stopt een Instagram API-verbinding met werken?
Omdat Meta het token niet meer accepteert, of omdat het account niet meer in aanmerking komt voor de API. De documentatie van Meta noemt de oorzaken, elk met wat de API teruggeeft en de stap die de toegang herstelt. De meeste laten zich eerst zien als een mislukte aanroep, daarom kijken de controles verderop op een schema naar deze signalen:
| 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 |
Wanneer verloopt een token, en wanneer kan het nog worden vernieuwd?
Met Instagram Login geldt een langlevend token 60 dagen vanaf de laatste vernieuwing. Een vernieuwing met grant_type=ig_refresh_token geeft er weer 60 dagen bij, mits het token minstens 24 uur oud is, niet verlopen is en de eigenaar instagram_business_basic heeft toegekend. Na de 60 dagen mislukken aanroepen met code 190 en helpt alleen een nieuwe login. Bij Unified Login bepaalt de configuratie of het token überhaupt verloopt.
Wat doen een wachtwoordwijziging en een ingetrokken recht?
Een wachtwoordwijziging kan de sessie beëindigen waartoe het token behoort: de foutgids van de Graph API meldt dit als code 190 met subcode 460 en zegt dat de persoon opnieuw moet inloggen bij de app. Een recht dat nooit is toegekend of is ingetrokken geeft code 10 of een code van 200 tot 299; bij DM's betekent code 200 met subcode 2534041 dat de eigenaar de toegang tot berichten heeft uitgeschakeld. De Platform Terms van Meta staan Meta ook toe de toegang van een app tot een recht of functie te beëindigen die 28 dagen niet is gebruikt.
Wat gebeurt er wanneer de eigenaar de app verwijdert?
De toegang tot niet-openbare gegevens eindigt. De eigenaar verwijdert de app in Instagram onder Website-rechten, Apps en websites, Actief, en Meta roept de deauthorize-callback-URL aan die is opgeslagen in de login-instellingen van de app. Het Helpcentrum van Instagram zegt dat een verwijderde app vanaf dat moment alleen nog de openbare informatie van het account kan zien, dus de verbinding is voorbij totdat de eigenaar opnieuw inlogt.
Wat gebeurt er wanneer het account van type verandert of wordt beperkt?
Beide halen het account buiten wat de API bedient. De API van Meta werkt alleen met professionele accounts, en de tabel voor het oplossen van problemen bij Unified Login geeft voor een account dat naar persoonlijk is gewisseld de melding (#10) dat toegang wordt geweigerd omdat het accounttype geen zakelijk of creator-account is. De eigenaar zet het type terug en verbindt daarna opnieuw. Een beperkt, inactief of gecontroleerd account geeft code 25 met subcode 2207050, en dat lost de eigenaar op in de Instagram-app.
Hoe stoppen webhooks met binnenkomen?
Via een falend endpoint. Meta probeert een Instagram-melding tot 36 uur opnieuw, maar afleveringen voor berichten zijn strenger: na 15 minuten fouten gaat er een waarschuwing naar het developeraccount, en na een uur stuurt Meta een waarschuwing Webhooks uitgeschakeld en ontkoppelt het de app van het account. Zodra het endpoint weer werkt, zet POST /<IG_ID>/subscribed_apps met dezelfde velden de meldingen weer aan.
Hoe merk je een uitval op voordat gebruikers dat doen?
Door de verbinding volgens een schema te controleren, in plaats van te wachten tot een bericht mislukt:
- Sla
expires_inop bij elke tokenuitwisseling en vernieuw ruim voor dag 60, zodra het token een dag oud is. - Doe op een schema een goedkope geauthenticeerde aanroep, zoals GET /me?fields=
user_id,username, en behandel code 190 of 102 als een signaal om opnieuw te verbinden. - Bied de deauthorize-callback aan, zodat een verwijdering in de Instagram-instellingen meteen bij je aankomt.
- Lees de Developer Alerts en het zakelijke e-mailadres van de app, waar Meta webhook- en beoordelingsmeldingen naartoe stuurt.
- Log per account de code, subcode en
fbtrace_idvan elke fout, zodat een beperking los staat van een slecht verzoek.
Hoe verbind je elk geval opnieuw?
De meeste oorzaken eindigen in dezelfde stap: een nieuwe login door de accounteigenaar, die een nieuwe code en een nieuw token uitgeeft. Uitzonderingen zijn instellingen die de eigenaar in de Instagram-app wijzigt:
- Verlopen token, wachtwoordwijziging, verwijderde app of recht: stuur de eigenaar opnieuw door de login en laat hem de rechten goedkeuren.
- Persoonlijk account: schakel terug naar Zakelijk of Creator in de Instagram-app en log daarna opnieuw in.
- Berichten uitgeschakeld: zet Toegang tot berichten toestaan aan onder Verbonden tools; een nieuwe login is niet nodig.
- Beperkt account: doe wat de Instagram-app vraagt; een nieuwe login verandert niets.
- Uitgeschakelde webhooks: los het endpoint op en abonneer het account daarna opnieuw.
Wat doet easyCoexistence om een verbinding in leven te houden?
Het bewaakt elk verbonden Instagram-account de klok rond. Het vernieuwt het token zodra er minder dan 20 van de 60 dagen over zijn, controleert het account elke 6 uur met GET /me, en zet de verbinding op opnieuw verbinden op het moment dat Meta het token weigert, of dat nu in die controle is of bij een toolaanroep. Meta's webhook-afleveringen worden meteen beantwoord en daarna doorgestuurd. Wanneer de eigenaar de app verwijdert in de Instagram-instellingen, beëindigt Meta's deauthorize-callback de verbinding en haalt die van de factuur.
Hoe laat easyCoexistence het weten, en hoe verbind je opnieuw?
Eenmaal, per e-mail, met de naam van het account en een knop naar de pagina van het kanaal; platforms ontvangen ook een ondertekende channel.disconnected-gebeurtenis. Tot de eigenaar actie onderneemt, toont list_social_accounts de status en de laatste fout van Meta, en antwoorden de tools dat het account opnieuw moet worden verbonden. Opnieuw verbinden is één login met hetzelfde Instagram-account, die dezelfde verbinding herstelt met haar instellingen.
Veelgemaakte fouten
- Een token pas vernieuwen nadat een aanroep mislukt. Zodra het verlopen is, weigert Meta de vernieuwing, dus plan vernieuwingen terwijl het token nog geldig is.
- Een beperkt account opnieuw door de login sturen. Code 25 met subcode 2207050 is de staat van het account, en die lost de eigenaar op in de Instagram-app.
- De deauthorize-callback niet instellen. Een verwijdering in de Instagram-instellingen komt dan pas aan bij de volgende mislukte aanroep.
- Een falend endpoint repareren en wachten. Na een waarschuwing Webhooks uitgeschakeld blijven meldingen uit tot het account opnieuw is geabonneerd met POST /<IG_ID>/subscribed_apps.
Platforms krijgen channel.disconnected, zodat een weggevallen verbinding met één login weer werkt. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Veelgestelde vragen
Houdt het gebruik van een Instagram-token het verlopen tegen?
Nee. Alleen een vernieuwing verlengt een langlevend token, en een token dat 60 dagen zonder vernieuwing blijft, verloopt hoe vaak het ook is gebruikt.
Verwijdert Instagram een zakelijke app na 90 dagen zonder gebruik?
Nee. Het Helpcentrum van Instagram zegt dat apps met rechten voor het beheren van zakelijke en creator-accounts na 90 dagen inactiviteit niet verlopen.
Telt een losgekoppeld account nog mee op de factuur van easyCoexistence?
Ja, tot je het opnieuw verbindt of verwijdert. Een account waarvan de eigenaar de app in de Instagram-instellingen heeft verwijderd, verdwijnt uit de telling zodra Meta de verwijdering meldt.
Wat kost het om een Instagram-account te bewaken met easyCoexistence?
Bewaking zit bij elke verbinding: US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op