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

Dlaczego połączenie ze stroną Facebook przestaje działać i jak je utrzymać w działaniu

Połączenie ze stroną Facebook przestaje działać, gdy Meta przestaje akceptować jego token albo przestaje wysyłać jego zdarzenia: token pochodzi z krótkotrwałego logowania, osoba zmieniła hasło (błąd 190, subkod 460), straciła rolę na stronie (492) albo usunęła aplikację w sekcji Integracje biznesowe (458), uprawnienie nie było używane przez 90 dni, aplikacja była nieaktywna albo Meta ograniczyła stronę.

easyCoexistence pobiera token każdej strony z długotrwałego logowania, sprawdza stronę co 6 godzin i wysyła e-mail, gdy Meta odrzuca token, a jedno logowanie przez Facebooka przywraca stronę jako to samo połączenie, z jej regułami komentarzy i automatyzacjami.

Hours

Czas życia domyślnych tokenów użytkownika i strony Meta; token strony uzyskany z długotrwałego tokenu użytkownika nie ma daty wygaśnięcia.

90 days

Jeśli przez 90 dni nie ma logowań, wywołań API ani webhooków, Meta uznaje aplikację za nieaktywną i unieważnia wszystkie jej tokeny.

Exempt

Uprawnienia strony, takie jak pages_manage_posts i read_insights, nie wygasają wraz z 90-dniowym okresem dostępu do danych.

page_messaging_api

Ograniczenie Page Integrity, które blokuje stronie wysyłanie wiadomości przez Messenger Platform API.

6 hours

Jak często easyCoexistence sprawdza każdą połączoną stronę lekkim wywołaniem Graph i wysyła e-mail do właściciela, jeśli Meta odrzuci token.

Co może spowodować, że połączenie ze stroną przestanie działać?

Przyczyny występują na czterech poziomach: logowanie osoby, uprawnienia i stan aplikacji, sama strona oraz subskrypcja webhooka. Każda z nich objawia się inaczej, a większość zwraca błąd 190 z subkodem wskazującym przyczynę:

Short-lived sign-in190, subcode 463: the Page token expired with the user token it came from
Password change or logout190, subcode 460
Account checkpoint190, subcode 459 or 464: the person must log in at facebook.com
Role removed from the Page190, subcode 492
App removed in Business integrations190, subcode 458, and a call to the deauthorize callback
Permission unused for 90 daysCode 10, or one from 200 to 299, on the calls that need it
App inactive for 90 daysAll of the app's tokens invalidated
Page restricted368, or 10 with subcode 1893063 for messages
Webhooks failing for an hourThe app unsubscribed from the Page's events

Dlaczego token strony może wygasnąć po kilku godzinach?

Ponieważ został odczytany z /me/accounts krótkotrwałym tokenem użytkownika, więc sam też jest krótkotrwały. Domyślne tokeny użytkownika i strony Meta wygasają po kilku godzinach, a krótkotrwały token zwykle po jednej do dwóch. Wymieniony na serwerze za pomocą fb_exchange_token, token użytkownika działa około 60 dni, a token strony odczytany z jego pomocą nie ma daty wygaśnięcia. Meta nie przedłuży tokenu, który już wygasł: błąd brzmi „Sesja wygasła”, z subkodem 463, i osoba musi zalogować się ponownie.

Co się dzieje po zmianie hasła lub kontroli bezpieczeństwa?

Meta unieważnia tokeny tej osoby. Wylogowanie lub zmiana hasła zwraca błąd 190 z subkodem 460, „Sesja jest nieprawidłowa, ponieważ użytkownik się wylogował”, a Meta ostrzega, że zdarzenia bezpieczeństwa mogą unieważnić tokeny przed ich przewidywanym wygaśnięciem. Subkody 459 i 464 oznaczają, że samo konto wymaga uwagi: osoba musi zalogować się na facebook.com, aby rozwiązać problem, a potem ponownie zalogować się w aplikacji. W pozostałych przypadkach wystarczy nowe logowanie tej osoby albo kogoś innego z rolą na stronie.

Co się dzieje, gdy osoba traci rolę na stronie?

Jej token strony przestaje działać z błędem 190 i subkodem 492, który Meta opisuje jako sytuację, w której użytkownik powiązany z tokenem dostępu do strony nie ma odpowiedniej roli na stronie. Tokeny są wydawane dla każdej strony, osoby i aplikacji, więc tokeny innych osób z rolą nadal działają. Rozwiązaniem jest ponowne połączenie strony z konta, które nadal ma pełny dostęp lub dostęp do zadań, najlepiej z konta osoby, która nie zamierza odejść z firmy.

Co się dzieje, gdy ktoś usunie aplikację w Integracjach biznesowych?

Meta unieważnia tokeny dostępu użytkownika, które aplikacja miała dla tej osoby, a tokeny stron odczytane przy ich pomocy także przestają działać, z błędem 190 i subkodem 458: użytkownik nie autoryzował aplikacji. Osoby usuwają aplikację w ustawieniach Facebooka, w sekcji Integracje biznesowe, a Meta wywołuje wtedy callback deautoryzacji aplikacji. Token użytkownika systemowego zostaje zakończony w ten sam sposób w Menedżerze firm, w sekcji Ustawienia firmy, Integracje, Połączone aplikacje, a aplikacja może zakończyć własny dostęp poleceniem DELETE /{user-id}/permissions.

Czy uprawnienia stron wygasają po 90 dniach?

Istnieją dwie różne zasady 90-dniowe i tylko jedna dotyczy uprawnień stron. Wygasanie dostępu do danych, które odcina aplikację 90 dni po ostatniej aktywności osoby, nie dotyczy pages_show_list, pages_manage_posts, pages_messaging, read_insights ani pozostałych uprawnień stron, które Meta wymienia jako nie wygasające. Wygasanie uprawnień już tak: uprawnienie, którego aplikacja nie użyła przez 90 dni, może wygasnąć, nawet jeśli zostało zatwierdzone w App Review, i trzeba je nadać ponownie. Wywołania, które go wymagają, kończą się błędem 10 albo kodem z zakresu 200, aż nowe logowanie ponownie je przyzna.

Czy cała aplikacja może stracić dostęp?

Tak, na trzy udokumentowane sposoby, o których Meta ostrzega pilnym powiadomieniem w skrzynce alertów panelu aplikacji. Aplikacja bez logowań, bez wywołań Graph API lub Marketing API i bez powiadomień z webhooków przez 90 dni jest uznawana za nieaktywną, a Meta unieważnia wszystkie jej tokeny. Przywrócenie jej w panelu aplikacji aktualizuje ją do najnowszej wersji, ale stare tokeny pozostają nieważne, a uprawnienia wycofane z powodu nieużywania wracają przez App Review. Trzeba też wypełnić coroczną Data Use Checkup, a naruszenie warunków lub zasad Meta może ograniczyć dostęp do API albo odebrać uprawnienia.

Co się dzieje, gdy Meta ogranicza stronę?

Ograniczone działania kończą się błędem: 368, tymczasowo zablokowane z powodu naruszenia zasad, albo dla wiadomości kodem 10 z subkodem 1893063. Interfejs Page Integrity API wskazuje, które: GET /{page-id}/page_status, z uprawnieniem pages_manage_metadata, zwraca status ok, warning, restricted lub suspended, każde aktywne ograniczenie, na przykład page_publish, page_read_only, page_messaging albo page_messaging_api, z polem expiration_time, oraz zalecane działania, na przykład FILE_APPEAL. Pole webhooka business_integrity zgłasza zmiany w miarę ich wystąpienia.

Dlaczego zdarzenia ustają, a wywołania API nadal działają?

Ponieważ webhooki zawodzą na własnych zasadach. Po godzinie nieudanych dostarczeń Meta wysyła alert Webhooks Disabled i anuluje subskrypcję aplikacji na stronie, dopóki aplikacja nie zasubskrybuje jej ponownie. Meta nie wysyła nic dla strony, która wyłączyła platformę aplikacji w swoich ustawieniach aplikacji. Token może pozostać ważny w obu przypadkach, więc po awarii sprawdź GET /{page-id}/subscribed_apps, a gdy endpoint znowu odpowie, wyślij do niego POST z tokenem strony.

Jak wykryć zerwane połączenie, zanim publikacja się nie powiedzie?

Sprawdzając zgodnie z harmonogramem, ponieważ Meta nie powiadamia aplikacji, gdy token przestaje być ważny. Lekkie wywołanie, takie jak GET /{page-id}?fields=id,name z tokenem strony, zawodzi tak samo jak publikacja. debug_token, wywołany z ID aplikacji i jej sekretem jako tokenem dostępu, zwraca is_valid, expires_at i przyznane zakresy, a dla tokenu, który już nie działa, także kod błędu i subkod. page_status zgłasza ograniczenia, a callback deautoryzacji informuje o usuniętej aplikacji.

Inspect a Page token with debug_token
curl -G "https://graph.facebook.com/v26.0/debug_token" \
  --data-urlencode "input_token=$PAGE_TOKEN" \
  --data-urlencode "access_token=$APP_ID|$APP_SECRET"

# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops working

Jak ponownie połączyć stronę?

Tym samym przepływem, który ją połączył, prowadzonym przez osobę, która nadal ma rolę na stronie, po usunięciu przyczyny, jeśli jest znana: konto objęte kontrolą bezpieczeństwa loguje się na facebook.com, ograniczenie zostaje obsłużone przez zalecane działanie, a endpoint, który zawodził, znów odpowiada kodem 200. Nowe logowanie zwraca nowe ciągi tokenów, więc zastąp zapisane, zamiast zachowywać oba:

1Fix the causeCheckpoint, restriction or endpoint first
2Sign in againFacebook Login for Business, code exchanged on the server
3Long-lived tokenfb_exchange_token, about 60 days
4New Page tokenRead /me/accounts and replace the stored one
5Subscribe againPOST /{page-id}/subscribed_apps if events had stopped

Co robi easyCoexistence, gdy połączenie ze stroną się zerwie?

Obserwuje zerwania, które potrafi zobaczyć, i informuje o nich. Co 6 godzin sprawdza każdą połączoną stronę wywołaniem GET /{page-id}?fields=id,name, a gdy Meta odrzuca token błędem 190 lub 102, podczas tego sprawdzenia albo w dowolnym wywołaniu narzędzia, strona dostaje status Reconnect needed, jej właściciel otrzymuje jeden e-mail, a platforma partnerska otrzymuje channel.disconnected. Inne odmowy, na przykład brak uprawnienia czy blokada z powodu zasad, wracają w wyniku narzędzia wraz z kodem i komunikatem Meta.

Gdy ktoś usunie aplikację w Integracjach biznesowych, callback deautoryzacji Meta trafia do easyCoexistence, który usuwa strony połączone przez tę osobę, kasuje ich tokeny i miejsca docelowe zdarzeń, zdejmuje je z rachunku i wysyła channel.removed. Ponowne zalogowanie z panelu przywraca stronę jako to samo połączenie, z jej regułami komentarzy i automatyzacjami, ponownie zasubskrybowane na feed, messages i mention. Po statusie Reconnect needed miejsce docelowe zdarzeń również pozostaje; po usunięciu ustawia je ponownie set_social_webhook_destination, z nowym sekretem.

Typowe błędy

  • Ponawianie błędu 190. Odrzucony token zawodzi tak samo przy każdym wywołaniu, a działający powstaje tylko po nowym logowaniu osoby z rolą na stronie.
  • Ponowne połączenie, żeby zdjąć ograniczenie. Nowy token nie zmienia statusu strony; zmieniają go zalecane działania z page_status, na przykład odwołanie.
  • Żądanie uprawnienia, którego produkt używa rzadko. Nieużywane przez 90 dni może wygasnąć, a wywołania, które go wymagają, zawiodą; proś o nie, gdy funkcja zostaje wdrożona.
  • Zachowanie starego tokenu po ponownym połączeniu. Nowe logowanie zwraca inny ciąg tokenu, a zadanie, które nadal trzyma stary, będzie zawodzić z błędem 190.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Czy token strony przestaje działać, gdy wygasa 60-dniowy token użytkownika?

Nie, jeśli został odczytany z /me/accounts tym długotrwałym tokenem użytkownika: taki token strony nie ma daty wygaśnięcia, choć przyczyny opisane na tej stronie nadal mogą go unieważnić.

Czy Meta powie mi, kiedy token strony przestanie działać?

Nie w przypadku tokenu, który staje się nieważny: o problemie dowiesz się z błędu przy następnym wywołaniu. Meta wywołuje callback deautoryzacji, gdy ktoś usunie aplikację, i ostrzega o ryzykach dla całej aplikacji w skrzynce alertów panelu aplikacji.

Czy token innej osoby może utrzymać stronę połączoną?

Tak. Tokeny stron są wydawane dla każdej strony, osoby i aplikacji, więc token od innej osoby, która nadal ma rolę na stronie, działa dalej, gdy dostęp jednej osoby się kończy.

Ile kosztuje easyCoexistence dla strony na Facebooku?

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, zależnie od liczby połączeń. Każda strona liczy się jako jedno połączenie, a pierwsze 3 dni są bezpłatne.

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