Subskrybowanie Strony na Facebooku do webhooków: krawędź subscribed_apps
Stronę na Facebooku subskrybuje się do webhooków aplikacji za pomocą POST /{page-id}/subscribed_apps, przekazując subscribed_fields, takie jak feed,messages, oraz token dostępu Strony od osoby z zadaniem CREATE_CONTENT, MANAGE lub MODERATE, z przyznanymi uprawnieniami pages_manage_metadata i pages_show_list. Meta wysyła zdarzenia danego pola tylko wtedy, gdy aplikacja także je subskrybuje; GET wyświetla subskrypcję, a DELETE ją usuwa.
easyCoexistence subskrybuje każdą połączoną przez Ciebie Stronę do feed, messages i mention przez subscribed_apps, anuluje subskrypcję, gdy ją usuwasz, i przekazuje zdarzenia Strony na Twój endpoint HTTPS, podpisane sekretem przypisanym do tej Strony, przez jeden konektor MCP albo Partner API.
Tylko pola zasubskrybowane zarówno na poziomie Strony, jak i aplikacji generują webhooki; Strona może mieć na liście więcej pól niż aplikacja.
Zadania Strony, z których jedno musi mieć osoba stojąca za tokenem, aby odczytać lub utworzyć subskrypcję.
Zwracane obok success, gdy aplikacja usuwa subskrypcję webhooka ze Strony za pomocą DELETE.
Czego wymaga /{app-id}/subscriptions, by odczytać, utworzyć lub usunąć subskrypcję na poziomie aplikacji.
Nieudanych dostaw Messengera, po których Meta anuluje subskrypcję aplikacji na Stronie, dopóki ta jej nie ponowi.
Co robi krawędź subscribed_apps?
Instaluje aplikację na Stronie i określa, które pola webhooków Strony otrzymuje aplikacja. Meta wysyła powiadomienia tylko wtedy, gdy Strona ma zainstalowaną aplikację i nie wyłączyła platformy aplikacji w swoich ustawieniach, oraz wyłącznie dla pól zasubskrybowanych na obu poziomach: Strony, przez tę krawędź, oraz aplikacji, ustawionych w App Dashboard lub przez /{app-id}/subscriptions. Strona może być zasubskrybowana do większej liczby pól niż aplikacja.
Jak zasubskrybować Stronę?
Wysyłając POST na tę krawędź z subscribed_fields, w którym pola są rozdzielone przecinkami, oraz tokenem dostępu Strony. Poprawne wywołanie zwraca success true, a wywołanie z listą messages wymaga też pages_messaging w tokenie:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Jakiego tokenu, zadań i uprawnień potrzebuje?
Tokenu dostępu Strony, który wiąże wywołanie z jedną Stroną, od osoby mogącej działać w imieniu tej Strony. Wymagania ustalają referencje i przewodniki Meta:
- Dowolne pole: osoba z zadaniem
CREATE_CONTENT, MANAGE lub MODERATE orazpages_manage_metadatazpages_show_list. - messages i pozostałe pola Messengera: dodatkowo
pages_messaging, na tokenie od osoby mogącej wykonać zadanie MESSAGING. - leadgen: zadanie ADVERTISE wraz z
leads_retrieval,pages_read_engagementiads_management. - Odczyt subskrypcji przez GET wymaga tych samych zadań i uprawnień co jej utworzenie.
Jakiego poziomu dostępu wymagają pola?
Zaawansowanego dostępu, dla Stron i osób spoza ról w aplikacji. Przy Standardowym dostępie powiadomienia Messengera przychodzą tylko od osób mających rolę w aplikacji, takich jak administratorzy, deweloperzy i testerzy. Zaawansowany dostęp, przyznawany dla każdego uprawnienia przez App Review i wymagający weryfikacji firmy, otwiera je dla klientów aplikacji. Przewodnik Meta po Messengerze wymienia też publikację aplikacji wśród warunków wstępnych.
Czym jest subskrypcja na poziomie aplikacji?
To druga połowa: pola, których słucha sama aplikacja, wraz z jej adresem wywołania zwrotnego. Ustawia się ją w App Dashboard lub przez POST /{app-id}/subscriptions z tokenem dostępu aplikacji, przekazując object=page, callback_url, fields, include_values i verify_token, co uruchamia żądanie weryfikacyjne Meta. GET na tej samej krawędzi pokazuje callback_url, fields każdego obiektu i to, czy subskrypcja jest aktywna. Nowy POST zmienia pola bez nadpisywania pozostałych, a DELETE usuwa wszystkie albo wskazane pola.
Jak sprawdzić, do czego Strona jest zasubskrybowana?
GET na tę samą krawędź z tokenem Strony. Tablica data zawiera każdą aplikację zainstalowaną na Stronie, z jej nazwą, ID i subscribed_fields, a gdy Strona nie ma zainstalowanych aplikacji, wynik jest pusty:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}Jak usunąć subskrypcję?
DELETE /{page-id}/subscribed_apps odłącza aplikację od Strony. Aplikacja może usunąć własną subskrypcję tokenem dostępu aplikacji, a odpowiedź zawiera success i messaging_success. Meta usuwa ją też sama: po godzinie nieudanych dostaw Messengera aplikacja zostaje odsubskrybowana od Strony i musi zasubskrybować się ponownie, gdy jej endpoint zacznie działać.
Co easyCoexistence robi przy połączeniu?
Subskrybuje każdą Stronę, którą wybierze osoba, zaraz po zapisaniu tokenu tej Strony: POST /{page-id}/subscribed_apps z subscribed_fields ustawionym na feed,messages,mention. Jeśli Meta odmówi, Strona pozostaje połączona, a list_social_accounts pokazuje powód w last_error. Usunięcie Strony wysyła DELETE /{page-id}/subscribed_apps przed usunięciem tokenu, a żadne narzędzie nie obsługuje ścieżek subscribed_apps ani tokenów, więc subskrypcją zarządza wyłącznie easyCoexistence.
Typowe błędy
- Wywołanie krawędzi tokenem dostępu użytkownika. Wymaga ona tokenu dostępu Strony, która ma być zasubskrybowana.
- Zasubskrybowanie Strony bez aplikacji. Pole trafia do adresu wywołania zwrotnego tylko wtedy, gdy subskrypcja aplikacji również je obejmuje.
- Pominięcie pages_messaging przy subskrybowaniu messages. Meta go wymaga, na tokenie od osoby mogącej wykonać zadanie MESSAGING.
- Brak ponownej subskrypcji po awarii. Godzina nieudanych dostaw Messengera odsubskrybowuje aplikację, a zdarzenia ustają, dopóki nie zostanie wysłany ponownie POST.
US$ 9 do US$ 0,75 za połączenie miesięcznie, z obniżką w miarę dodawania połączeń, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy muszę subskrybować każdą Stronę osobno?
Tak. subscribed_apps działa dla każdej Strony osobno, z jej własnym tokenem, a subskrypcja na poziomie aplikacji dla obiektu page dotyczy Stron, na których zainstalowano aplikację.
Dlaczego subscribed_apps zwraca błąd 200?
Meta podaje 200 jako błąd uprawnień dla tej krawędzi. Sprawdź, czy token ma pages_manage_metadata i pages_show_list oraz pochodzi od osoby z CREATE_CONTENT, MANAGE lub MODERATE.
Czy można zasubskrybować Stronę z Graph API Explorer?
Tak. Przewodnik Meta wybiera aplikację, pobiera token użytkownika z pages_manage_metadata, wymienia go na token Strony i wysyła POST na {page-id}/subscribed_apps.
Czy mogę dodać pola webhooków do Strony połączonej z easyCoexistence?
Nie przez jego narzędzia: żadne nie obsługuje ścieżek subscribed_apps, a Strona pozostaje zasubskrybowana do feed, messages i mention, czyli pól, które easyCoexistence przekazuje.
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