Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Dlaczego połączenie z Instagram API przestaje działać i jak je utrzymać

Połączenie z Instagram API przestaje działać, gdy Meta nie przyjmuje już jego tokenu albo konto przestaje spełniać wymagania: długotrwały token nieodświeżany przez 60 dni, zmiana hasła, uprawnienie lub cała aplikacja usunięte przez właściciela, przełączenie na konto osobiste albo ograniczenie konta. Każda przyczyna zwraca własny kod błędu, a większość naprawia się, gdy właściciel zaloguje się ponownie.

easyCoexistence czuwa nad każdym połączeniem Instagrama przez całą dobę: odświeża token na długo przed upływem 60 dni, sprawdza konto co 6 godzin, wysyła e-mail raz, gdy Meta odmawia dostępu, i przekazuje platformom channel.disconnected, dzięki czemu zerwane połączenie wraca jednym logowaniem.

60 days

Tokeny Instagrama nieodświeżone w ciągu 60 dni wygasają i nie da się ich już odświeżyć.

460

Podkod Graph API w ramach kodu 190 dla sesji zakończonej zmianą hasła; osoba musi zalogować się ponownie.

1 hour

Nieudanych dostarczeń webhooków wiadomości, zanim Meta je wyłączy i odłączy aplikację od konta.

28 days

Meta może odebrać aplikacji dostęp do uprawnień lub funkcji, z których nie korzystała przez 28 dni.

6 hours

Jak często easyCoexistence sprawdza każde połączone konto Instagram i odnawia jego token na długo przed upływem 60 dni.

Dlaczego połączenie z Instagram API przestaje działać?

Ponieważ Meta przestaje przyjmować token albo konto przestaje kwalifikować się do API. Dokumentacja Meta wymienia przyczyny i przy każdej opisuje, co zwraca API oraz jaki krok przywraca dostęp. Większość z nich najpierw objawia się nieudanym wywołaniem, dlatego poniższe kontrole sprawdzają je według harmonogramu:

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

Kiedy token wygasa i kiedy można go jeszcze odświeżyć?

Przy Instagram Login długotrwały token jest ważny 60 dni od ostatniego odświeżenia. Odświeżenie z grant_type=ig_refresh_token przedłuża go o kolejne 60 dni, pod warunkiem że token ma co najmniej 24 godziny, nie wygasł i właściciel przyznał uprawnienie instagram_business_basic. Po upływie 60 dni wywołania kończą się błędem z kodem 190 i pomaga już tylko nowe logowanie. W Unified Login o tym, czy token w ogóle wygasa, decyduje konfiguracja.

Co robi zmiana hasła i usunięte uprawnienie?

Zmiana hasła może zakończyć sesję, do której należy token. Przewodnik po błędach Graph API opisuje to jako kod 190 z podkodem 460 i wskazuje, że osoba musi zalogować się w aplikacji ponownie. Uprawnienie, którego nigdy nie przyznano albo które usunięto, zwraca kod 10 lub kod z zakresu od 200 do 299. W wiadomościach prywatnych kod 200 z podkodem 2534041 oznacza, że właściciel wyłączył dostęp do wiadomości. Warunki Platformy Meta pozwalają jej też odebrać aplikacji dostęp do uprawnienia lub funkcji nieużywanych przez 28 dni.

Co się dzieje, gdy właściciel usunie aplikację?

Jej dostęp do danych niepublicznych się kończy. Właściciel usuwa aplikację w Instagramie w sekcji Uprawnienia witryn internetowych, Aplikacje i witryny internetowe, Aktywne, a Meta wywołuje adres URL callbacku deauthorize zapisany w ustawieniach logowania aplikacji. Centrum pomocy Instagrama podaje, że usunięta aplikacja może od tej chwili odczytywać wyłącznie publiczne informacje konta, więc połączenie jest zakończone do czasu ponownego logowania przez właściciela.

Co się dzieje, gdy konto zmienia typ albo zostaje ograniczone?

Oba przypadki wyprowadzają konto poza to, co obsługuje API. API Meta działa wyłącznie z kontami profesjonalnymi, a tabela rozwiązywania problemów Unified Login podaje dla konta przełączonego na osobiste komunikat (#10): dostęp zabroniony, ponieważ typ konta Instagram nie jest firmowy ani twórcy. Właściciel przełącza konto z powrotem, a następnie łączy je ponownie. Konto ograniczone, nieaktywne lub objęte weryfikacją zwraca kod 25 z podkodem 2207050, który właściciel rozwiązuje w aplikacji Instagram.

Jak przestają docierać webhooki?

Przez nieudany endpoint. Meta ponawia powiadomienie z Instagrama przez do 36 godzin, ale dostarczenia wiadomości są surowsze: po 15 minutach niepowodzeń powiadomienie trafia na konto dewelopera, a po godzinie Meta wysyła powiadomienie Webhooks Disabled i odłącza aplikację od konta. Gdy endpoint znów działa, POST /<IG_ID>/subscribed_apps z tymi samymi polami ponownie włącza powiadomienia.

Jak zauważyć spadek, zanim zrobią to użytkownicy?

Sprawdzając połączenie według harmonogramu, zamiast czekać, aż publikacja się nie uda:

  • Zapisuj expires_in z każdej wymiany i odświeżaj token na długo przed 60. dniem, gdy ma już dzień.
  • Wykonuj tanie uwierzytelnione wywołanie według harmonogramu, np. GET /me?fields=user_id,username, i traktuj kod 190 lub 102 jako sygnał do ponownego połączenia.
  • Obsługuj callback deauthorize, aby usunięcie w ustawieniach Instagrama dotarło do Ciebie od razu.
  • Czytaj powiadomienia dla deweloperów oraz firmowy e-mail przypisany do aplikacji, gdzie Meta wysyła informacje o webhookach i przeglądach.
  • Zapisuj kod, podkod i fbtrace_id każdego błędu osobno dla każdego konta, aby ograniczenie odróżniało się od złego żądania.

Jak ponownie połączyć każdy przypadek?

Większość przyczyn kończy się tym samym krokiem: nowym logowaniem właściciela konta, które wydaje świeży kod i token. Wyjątkiem są ustawienia, które właściciel zmienia w aplikacji Instagram:

  • Wygasły token, zmiana hasła, usunięta aplikacja lub uprawnienie: wyślij właściciela ponownie przez logowanie i pozwól mu zatwierdzić uprawnienia.
  • Konto osobiste: przełącz je na konto firmowe lub twórcy w aplikacji Instagram, a następnie zaloguj się ponownie.
  • Wiadomości wyłączone: włącz opcję „Zezwalaj na dostęp do wiadomości” w sekcji Połączone narzędzia; nowe logowanie nie jest potrzebne.
  • Konto ograniczone: wykonaj to, o co prosi aplikacja Instagram; nowe logowanie niczego nie zmieni.
  • Wyłączone webhooki: napraw endpoint, a następnie ponownie zasubskrybuj konto.

Co easyCoexistence robi, aby utrzymać połączenie?

Czuwa nad każdym połączonym kontem Instagram przez całą dobę. Odświeża token, gdy zostaje mniej niż 20 z 60 dni, sprawdza konto co 6 godzin przez GET /me i oznacza połączenie do ponownego połączenia w chwili, gdy Meta odrzuci token, czy to w tej kontroli, czy w wywołaniu narzędzia. Odpowiada na dostarczenia webhooków Meta od razu, a przekazuje je dalej później. Gdy właściciel usunie aplikację w ustawieniach Instagrama, callback deauthorize Meta kończy połączenie i zdejmuje je z rachunku.

Jak easyCoexistence informuje i jak się ponownie połączyć?

Raz, e-mailem, z podaniem konta i przyciskiem prowadzącym do strony kanału. Platformy otrzymują też podpisane zdarzenie channel.disconnected. Dopóki właściciel nie zadziała, list_social_accounts pokazuje status i ostatni błąd Meta, a narzędzia odpowiadają, że konto trzeba połączyć ponownie. Ponowne połączenie to jedno logowanie tym samym kontem Instagram, które przywraca to samo połączenie wraz z ustawieniami.

Typowe błędy

  • Odświeżanie tokenu dopiero po nieudanym wywołaniu. Gdy token wygaśnie, Meta odrzuca odświeżenie, więc planuj odnowienia, dopóki token jest jeszcze ważny.
  • Wysyłanie ograniczonego konta z powrotem przez logowanie. Kod 25 z podkodem 2207050 opisuje stan konta, który właściciel naprawia w aplikacji Instagram.
  • Brak ustawionego callbacku deauthorize. Usunięcie w ustawieniach Instagrama wychodzi wtedy na jaw dopiero przy kolejnym nieudanym wywołaniu.
  • Naprawianie nieudanego endpointu i czekanie. Po powiadomieniu Webhooks Disabled pozostaje ono wyłączone, dopóki konto nie zostanie ponownie zasubskrybowane przez POST /<IG_ID>/subscribed_apps.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Czy używanie tokenu Instagrama zapobiega jego wygasaniu?

Nie. Tylko odświeżenie przedłuża długotrwały token, a token, który przez 60 dni nie został odświeżony, wygasa bez względu na to, jak często był używany.

Czy Instagram usuwa aplikację firmową po 90 dniach bez użycia?

Nie. Centrum pomocy Instagrama podaje, że aplikacje z uprawnieniami do zarządzania kontami firmowymi i twórców nie wygasają po 90 dniach nieaktywności.

Czy odłączone konto nadal liczy się do rachunku easyCoexistence?

Tak, do czasu ponownego połączenia lub usunięcia. Konto, którego właściciel usunął aplikację w ustawieniach Instagrama, znika z liczby, gdy tylko Meta zgłosi usunięcie.

Ile kosztuje monitorowanie konta Instagram w easyCoexistence?

Monitorowanie jest w cenie każdego połączenia: od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w