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.
Pola subskrypcji udokumentowane w referencji Meta dla webhooków Strony, od feed i mention po pola Messengera i profilu.
Uprawnienie, które administrator Strony z uprawnieniami MODERATE musi nadać, zanim webhooki Strony dotrą do aplikacji.
Osobne pole Messengera dla wiadomości wysyłanych przez Stronę, dostępne wyłącznie dla konwersacji w Messengerze.
Zadanie Strony wymagane do subskrypcji leadgen, z uprawnieniami leads_retrieval, ads_management, pages_read_engagement i pages_manage_metadata.
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:
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:
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_updateicall_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_integrityimessaging_integrity: aktualizacje integralności, z naruszeniami, ograniczeniami i zdarzeniami działań wbusiness_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 ipublic_transit. - Lokal:
price_range,payment_options, attire iculinary_team. - Dane osobowe: birthday,
personal_infoipersonal_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:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
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.
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