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

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.

Both levels

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.

CREATE_CONTENT, MANAGE or MODERATE

Zadania Strony, z których jedno musi mieć osoba stojąca za tokenem, aby odczytać lub utworzyć subskrypcję.

messaging_success

Zwracane obok success, gdy aplikacja usuwa subskrypcję webhooka ze Strony za pomocą DELETE.

App access token

Czego wymaga /{app-id}/subscriptions, by odczytać, utworzyć lub usunąć subskrypcję na poziomie aplikacji.

1 hour

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:

Subscribing a Page to three fields
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 oraz pages_manage_metadata z pages_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_engagement i ads_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:

Reading a Page's subscriptions
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.
Z EasyCoexistence zrobisz to

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