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

Pola webhooka Strony na Facebooku: pełna lista

Referencja Meta dotycząca webhooków Strony dokumentuje 64 pola subskrypcji: feed dla postów, komentarzy i reakcji, mention dla wzmianek o Stronie, pola Messengera, takie jak messages, message_echoes, messaging_postbacks i message_reads, oraz pola profilu, takie jak name, picture, hours i website. Każde z nich wymaga uprawnienia pages_manage_metadata, a aplikacja otrzymuje pole dopiero wtedy, gdy zostanie zasubskrybowane zarówno na poziomie aplikacji, jak i przez Stronę za pośrednictwem subscribed_apps.

easyCoexistence subskrybuje każdą podłączoną Stronę do feed, messages i mention i przekazuje te zdarzenia na Twój endpoint HTTPS w miarę ich nadejścia, podpisane nagłówkiem X-EC-Signature.

64

Pola subskrypcji udokumentowane w referencji Meta dla webhooków Strony, od feed i mention po pola Messengera i profilu.

pages_manage_metadata

Uprawnienie, które administrator Strony z uprawnieniami MODERATE musi nadać, zanim webhooki Strony dotrą do aplikacji.

message_echoes

Osobne pole Messengera dla wiadomości wysyłanych przez Stronę, dostępne wyłącznie dla konwersacji w Messengerze.

ADVERTISE

Zadanie Strony wymagane do subskrypcji leadgen, z uprawnieniami leads_retrieval, ads_management, pages_read_engagement i pages_manage_metadata.

Both levels

Webhooki powstają wyłącznie z pól zasubskrybowanych zarówno na poziomie Strony, jak i aplikacji.

Jak są uporządkowane pola webhooków Strony?

Meta dokumentuje je na jednej stronie referencyjnej dotyczącej obiektu strony, a dzielą się na trzy grupy: aktywność na Stronie i wokół niej, konwersacje w Messengerze oraz zmiany w danych samej Strony. Zmiany w feed, mention i profilu trafiają do entry.changes, gdzie każde zdarzenie nazywa swoje pole, albo jako changed_fields, gdy aplikacja wyłączyła Include Values. Zdarzenia Messengera trafiają do entry.messaging albo, w przypadku aplikacji, która nie jest właścicielem wątku, do entry.standby.

Które pola raportują aktywność na Stronie?

Dwanaście pól obejmuje treści i aktywność, a nie konwersacje. Nowy komentarz, na przykład, trafia do feed jako zmiana z item ustawionym na comment i verb ustawionym na add, obok reakcji, udostępnień i własnych postów Strony. Co dostarcza każde z nich, według referencji Meta:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

Które pola przenoszą zdarzenia Messengera?

Messenger ma najdłuższą listę, a przewodnik Meta po webhookach Messengera opisuje, co wysyła każde pole. Tych trzynaście obejmuje konwersacje Strony. Standby, które przenosi wiadomości do aplikacji niebędącej właścicielem wątku, jest opisane w tym przewodniku, a nie w referencji Strony:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

Jakie są pozostałe pola Messengera?

Dziesięć kolejnych obsługuje konkretne produkty, od połączeń po handel i raportowanie integralności:

  • send_cart: wiadomość zawierająca informacje o koszyku lub zamówieniu; message_context: wykrycia, jakich modele Meta dokonują w wiadomości, z nazwą zdarzenia i wynikiem.
  • calls, call_settings_update i call_permission_reply: połączenia głosowe w Messengerze, zmiany ustawień połączeń Strony oraz odpowiedź osoby na prośbę o zgodę na połączenie.
  • messaging_customer_information: dane wpisane przez osobę na ekranie informacji o kliencie; messaging_in_thread_lead_form_submit: formularz leada wysłany w ramach konwersacji.
  • message_template_status_update: zmiana statusu przeglądu szablonu wiadomości użytkowej.
  • business_integrity i messaging_integrity: aktualizacje integralności, z naruszeniami, ograniczeniami i zdarzeniami działań w business_integrity.

Które pola raportują zmiany w profilu Strony?

Dwadzieścia dziewięć pól raportuje zmiany w danych samej Strony, po jednym polu na każdą informację, a każda zmiana trafia jako change nazywający dane pole:

  • Tożsamość: name, picture, category, która przechowuje do trzech kategorii, oraz description, czyli Story Description.
  • Dane firmy: company_overview, mission, founded, products, general_info, general_manager, members, awards i affiliation.
  • Kontakt i miejsce: email, phone, website, location, hours, current_location, hometown, parking i public_transit.
  • Lokal: price_range, payment_options, attire i culinary_team.
  • Dane osobowe: birthday, personal_info i personal_interests.

Jakie uprawnienie wymaga każde pole?

pages_manage_metadata dla każdego z nich, nadawane przez administratora Strony z uprawnieniami MODERATE, a dla niektórych dodatkowe. Strona jest subskrybowana przez subscribed_apps, a przewodniki Meta określają token i uprawnienia dla każdego rodzaju pola; aby otrzymywać zdarzenia dotyczące osób spoza ról aplikacji, uprawnienia wymagają też Advanced Access:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

Które pola subskrybuje easyCoexistence?

Trzy: feed, messages i mention. Gdy Strona się łączy, easyCoexistence wysyła POST /{page-id}/subscribed_apps z tymi polami i tokenem Strony, a następnie przekazuje każdy wpis dla tej Strony na adres endpointu, który ustawiłeś, podpisany nagłówkiem X-EC-Signature. Reguły komentarzy i automatyzacje działają na nowych komentarzach z feed oraz na wiadomościach, a wzmianki są przekazywane bez zmian. Żadne inne pole nie jest subskrybowane, więc echa, postbacki, potwierdzenia, przekazania, standby i zmiany profilu nie są przekazywane.

Typowe błędy

  • Subskrybowanie Strony do pola, którego aplikacja nie zasubskrybowała. Meta dostarcza tylko pola zasubskrybowane zarówno na poziomie Strony, jak i aplikacji.
  • Parsowanie zdarzeń Messengera jako zmian. Trafiają one do entry.messaging, z jednym obiektem messaging na wpis, a nie do entry.changes.
  • Oczekiwanie odpowiedzi Strony na wiadomości. Wiadomości wysłane przez Stronę trafiają do message_echoes, osobnego pola.
  • Liczenie na feed przy polubieniach dużej Strony. Meta wysyła powiadomienia o polubieniach tylko dla Stron z mniej niż 10 000 polubieniami.
Z EasyCoexistence zrobisz to

Reguły komentarzy i automatyzacje działają na nowych komentarzach i wiadomościach. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Czy pole feed obejmuje komentarze pod reklamami?

Tak. Meta nie wysyła niczego dla samych postów reklamowych, ale komentarze pod nimi trafiają do feed.

Co zmienia ustawienie Include Values?

Gdy jest włączone, zmiana zawiera nowe wartości w changes. Gdy jest wyłączone, Meta wysyła tylko nazwy zmienionych pól, w changed_fields.

Jak sprawdzić, do jakich pól Strona jest zasubskrybowana?

GET /{page-id}/subscribed_apps z tokenem Strony wyświetla aplikacje zainstalowane przez Stronę i dla każdej z nich jej subscribed_fields.

Czy easyCoexistence przekazuje zmiany profilu Strony?

Nie. Strony połączone z easyCoexistence są subskrybowane wyłącznie do feed, messages i mention, więc name, picture i pozostałe pola profilu nie są przekazywane.

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