AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Warum eine Instagram-API-Verbindung ausfällt und wie Sie sie am Laufen halten

Eine Instagram-API-Verbindung hört auf zu funktionieren, wenn Meta ihren Token nicht mehr akzeptiert oder das Konto die Voraussetzungen nicht mehr erfüllt: ein langlebiger Token, der 60 Tage lang nicht erneuert wurde, eine Passwortänderung, eine Berechtigung oder die ganze App, die der Inhaber entfernt hat, ein Wechsel zu einem persönlichen Konto oder eine Einschränkung des Kontos. Jede Ursache liefert einen eigenen Fehler, und die meisten werden behoben, indem der Inhaber sich erneut anmeldet.

easyCoexistence überwacht jede Instagram-Verbindung rund um die Uhr: Es erneuert den Token lange bevor die 60 Tage ablaufen, prüft das Konto alle 6 Stunden und benachrichtigt Sie einmal per E-Mail, wenn Meta den Zugriff verweigert.

60 days

Instagram-Token, die nicht innerhalb von 60 Tagen erneuert werden, laufen ab und lassen sich danach nicht mehr erneuern.

460

Graph-API-Subcode unter Code 190 für eine Sitzung, die durch eine Passwortänderung beendet wurde; die Person meldet sich erneut an.

1 hour

Nach fehlgeschlagenen Webhook-Zustellungen für Nachrichten deaktiviert Meta diese und meldet die App vom Konto ab.

28 days

Meta kann den Zugriff einer App auf Berechtigungen oder Funktionen beenden, die sie innerhalb von 28 Tagen nicht genutzt hat.

6 hours

Wie oft easyCoexistence jedes verbundene Instagram-Konto prüft, wobei der Token lange vor Ablauf der 60 Tage erneuert wird.

Warum funktioniert eine Instagram-API-Verbindung nicht mehr?

Weil Meta den Token nicht mehr akzeptiert oder das Konto die Voraussetzungen für die API nicht mehr erfüllt. Die Dokumentation von Meta nennt die Ursachen, jeweils mit der Antwort der API und dem Schritt, der den Zugriff wiederherstellt. Die meisten zeigen sich zuerst als fehlgeschlagener Aufruf, weshalb die Prüfungen weiter unten nach einem Zeitplan danach suchen:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA 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 offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

Wann läuft ein Token ab, und wann kann er noch erneuert werden?

Bei Instagram Login gilt ein langlebiger Token 60 Tage ab der letzten Erneuerung. Eine Erneuerung mit grant_type=ig_refresh_token verlängert ihn um weitere 60 Tage, sofern er mindestens 24 Stunden alt ist, noch nicht abgelaufen ist und der Inhaber instagram_business_basic gewährt hat. Nach Ablauf der 60 Tage schlagen Aufrufe mit Code 190 fehl, und nur eine neue Anmeldung hilft. Bei Unified Login legt die Konfiguration fest, ob der Token überhaupt abläuft.

Was bewirken eine Passwortänderung und eine entzogene Berechtigung?

Eine Passwortänderung kann die Sitzung beenden, zu der der Token gehört: Der Fehlerleitfaden der Graph API meldet sie als Code 190 mit Subcode 460 und besagt, dass sich die Person erneut in der App anmelden muss. Eine Berechtigung, die nie erteilt wurde oder entzogen ist, liefert Code 10 oder einen Code von 200 bis 299; bei Direktnachrichten bedeutet Code 200 mit Subcode 2534041, dass der Inhaber den Zugriff auf Nachrichten abgeschaltet hat. Die Plattformbedingungen von Meta erlauben es Meta außerdem, den Zugriff einer App auf eine Berechtigung oder Funktion zu beenden, die 28 Tage ungenutzt blieb.

Was passiert, wenn der Inhaber die App entfernt?

Ihr Zugriff auf nicht öffentliche Daten endet. Der Inhaber entfernt die App in Instagram unter Berechtigungen für Websites, Apps und Websites, Aktiv, und Meta ruft die Deauthorize-Callback-URL auf, die in den Business-Login-Einstellungen der App gespeichert ist. Das Hilfe-Center von Instagram sagt, dass eine entfernte App von da an nur noch die öffentlichen Informationen des Kontos abrufen kann. Die Verbindung ist also beendet, bis der Inhaber sich erneut anmeldet.

Was passiert, wenn das Konto den Typ wechselt oder eingeschränkt wird?

Beides bringt das Konto außerhalb dessen, was die API bedient. Die API von Meta arbeitet nur mit professionellen Konten, und die Fehlertabelle zu Unified Login nennt für ein auf privat umgestelltes Konto die Meldung „(#10) Access is denied because the instagram account type is not business or creator“. Der Inhaber wechselt dann zurück und verbindet erneut. Ein eingeschränktes, inaktives oder mit einer Sicherheitsprüfung versehenes Konto liefert Code 25 mit Subcode 2207050, was der Inhaber in der Instagram-App behebt.

Wie hören Webhooks auf, anzukommen?

Über einen fehlschlagenden Endpoint. Meta wiederholt eine Instagram-Benachrichtigung bis zu 36 Stunden lang, doch Nachrichtenzustellungen sind strenger: Nach 15 Minuten Fehlern geht ein Alarm an das Developer-Konto, und nach einer Stunde sendet Meta einen Webhooks-Deaktiviert-Alarm und meldet die App vom Konto ab. Sobald der Endpoint wieder funktioniert, schaltet POST /<IG_ID>/subscribed_apps mit denselben Feldern die Benachrichtigungen wieder ein.

Wie bemerken Sie einen Ausfall, bevor es Ihre Nutzer tun?

Indem Sie die Verbindung nach einem Zeitplan prüfen, statt darauf zu warten, dass ein Beitrag fehlschlägt:

  • Speichern Sie expires_in aus jedem Token-Austausch und jeder Erneuerung, und erneuern Sie den Token lange vor Tag 60, sobald er einen Tag alt ist.
  • Führen Sie nach Zeitplan einen günstigen authentifizierten Aufruf aus, etwa GET /me?fields=user_id,username, und behandeln Sie Code 190 oder 102 als Grund für eine erneute Verbindung.
  • Betreiben Sie den Deauthorize-Callback, damit eine Entfernung in den Einstellungen von Instagram Sie sofort erreicht.
  • Lesen Sie die Developer Alerts und die Business-E-Mail der App, an die Meta Hinweise zu Webhooks und Prüfungen sendet.
  • Protokollieren Sie Code, Subcode und fbtrace_id jedes Fehlers pro Konto, damit sich eine Einschränkung von einer fehlerhaften Anfrage unterscheiden lässt.

Wie verbinden Sie jeden Fall erneut?

Die meisten Ursachen enden im selben Schritt, einer neuen Anmeldung durch den Kontoinhaber, die einen frischen Code und Token ausstellt. Ausnahmen sind Einstellungen, die der Inhaber in der Instagram-App ändert:

  • Abgelaufener Token, Passwortänderung, entfernte App oder Berechtigung: Schicken Sie den Inhaber erneut durch die Anmeldung und lassen Sie ihn die Berechtigungen bestätigen.
  • Privates Konto: In der Instagram-App zurück zu Business oder Creator wechseln und dann erneut anmelden.
  • Nachrichten deaktiviert: Unter Verbundene Tools die Option Zugriff auf Nachrichten zulassen einschalten; eine neue Anmeldung ist nicht nötig.
  • Eingeschränktes Konto: Erledigen Sie, was die Instagram-App verlangt; eine neue Anmeldung ändert nichts.
  • Deaktivierte Webhooks: Beheben Sie den Endpoint und abonnieren Sie das Konto dann erneut.

Was tut easyCoexistence, um eine Verbindung am Leben zu halten?

Es überwacht jedes verbundene Instagram-Konto rund um die Uhr. Es erneuert den Token, sobald weniger als 20 der 60 Tage übrig sind, prüft das Konto alle 6 Stunden mit GET /me und markiert die Verbindung zur erneuten Anmeldung in dem Moment, in dem Meta den Token ablehnt, sei es bei dieser Prüfung oder bei einem Tool-Aufruf. Die Webhook-Zustellungen von Meta beantwortet es sofort und leitet sie anschließend weiter. Entfernt der Inhaber die App in den Einstellungen von Instagram, beendet der Deauthorize-Callback von Meta die Verbindung und nimmt sie von der Rechnung.

Wie informiert easyCoexistence Sie, und wie verbinden Sie erneut?

Einmal per E-Mail mit dem Namen des Kontos und einem Button zur Seite des Kanals; Plattformen erhalten außerdem ein signiertes channel.disconnected-Ereignis. Bis der Inhaber handelt, zeigt list_social_accounts den Status und den letzten Fehler von Meta, und die Tools antworten, dass das Konto erneut verbunden werden muss. Die erneute Verbindung ist eine Anmeldung mit demselben Instagram-Konto, die dieselbe Verbindung mit ihren Einstellungen wiederbelebt.

Häufige Fehler

  • Einen Token erst erneuern, nachdem ein Aufruf fehlschlägt. Ist er abgelaufen, lehnt Meta die Erneuerung ab, also planen Sie Erneuerungen, solange er noch gültig ist.
  • Ein eingeschränktes Konto erneut durch die Anmeldung schicken. Code 25 mit Subcode 2207050 beschreibt den Zustand des Kontos, den der Inhaber in der Instagram-App behebt.
  • Den Deauthorize-Callback nicht setzen. Eine Entfernung in den Einstellungen von Instagram zeigt sich dann erst, wenn der nächste Aufruf fehlschlägt.
  • Einen fehlgeschlagenen Endpoint beheben und dann warten. Nach einem Webhooks-Deaktiviert-Alarm bleiben Benachrichtigungen aus, bis das Konto mit POST /<IG_ID>/subscribed_apps erneut abonniert wird.
Mit EasyCoexistence

Plattformen erhalten channel.disconnected, sodass eine abgebrochene Verbindung mit einer einzigen Anmeldung wiederhergestellt ist. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.

Häufig gestellte Fragen

Verhindert die Nutzung eines Instagram-Tokens, dass er abläuft?

Nein. Nur eine Erneuerung verlängert einen langlebigen Token, und einer, der 60 Tage ohne Erneuerung bleibt, läuft ab, egal wie oft er genutzt wurde.

Entfernt Instagram eine Business-App nach 90 Tagen ohne Nutzung?

Nein. Das Hilfe-Center von Instagram sagt, dass Apps mit Berechtigungen zur Verwaltung von Business- und Creator-Konten nach 90 Tagen Inaktivität nicht ablaufen.

Zählt ein getrenntes Konto weiterhin auf der easyCoexistence-Rechnung?

Ja, bis Sie es erneut verbinden oder entfernen. Ein Konto, dessen Inhaber die App in den Einstellungen von Instagram entfernt hat, verlässt die Zählung, sobald Meta die Entfernung meldet.

Was kostet easyCoexistence die Überwachung eines Instagram-Kontos?

Die Überwachung ist in jeder Verbindung enthalten: US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am