Webhook feedu strony na Facebooku: zdarzenia komentarzy, postów i reakcji
Pole feed webhooków stron na Facebooku zgłasza niemal wszystkie zmiany w feedzie strony w momencie ich wystąpienia. Każda zmiana zawiera pole item, np. post, komentarz lub reakcja, oraz pole verb, np. add, edit lub remove, a także powiązane identyfikatory, autora w polu from i tekst w polu message. Meta wysyła to jako JSON podpisany nagłówkiem X-Hub-Signature-256.
easyCoexistence subskrybuje każdą połączoną przez Ciebie stronę do pola feed i przekazuje jej zmiany na Twój endpoint HTTPS w miarę ich nadejścia, podpisane sekretem tej strony, a reguły komentarz-do-DM i automatyzacje działają na nowych komentarzach.
Powiadomienia z feedu o polubieniach strony są wysyłane wyłącznie dla stron z mniejszą liczbą polubień niż ten próg.
Pole feed nie wysyła niczego dla samych postów reklamowych, ale wysyła komentarze pod nimi.
Uprawnienie, jakie musi nadać administrator strony z uprawnieniami MODERATE, aby webhooki strony dotarły do aplikacji.
Większość aktualizacji Meta grupuje w jedną dostawę webhooka, choć nie gwarantuje grupowania.
Czas, przez jaki Meta ponawia nieudaną dostawę do endpointu aplikacji, z malejącą częstotliwością.
Co raportuje pole feed?
Niemal wszystkie zmiany w feedzie strony w ujęciu Meta, np. posty, komentarze, reakcje i udostępnienia; zawartość zmiany zależy od jej rodzaju. Meta nie wysyła niczego dla samych postów reklamowych, choć komentarze pod nimi docierają, a powiadomienia o polubieniach strony wysyła tylko wtedy, gdy strona ma mniej niż 10 000 polubień.
Co oznaczają item i verb?
Dwa pola w wartości każdej zmiany mówią, co się wydarzyło:
- item: co się zmieniło, z listy Meta, która obejmuje post, status, photo, video, link, share, comment, reaction i album.
- verb: co się z tym stało: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute lub update.
- Nowy komentarz przychodzi z item comment i verb add, czyli dokładnie tym, czego szukają reguły komentarz-do-DM.
- Reakcja ma item reaction oraz pole
reaction_type, które ją określa.
Jak wygląda zmiana w feedzie?
POST, którego JSON ma pole object ustawione na page oraz wpis dla każdej strony, zawierający ID strony, czas i tablicę zmian. To przykład podany przez Meta: osoba publikuje na stronie:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Jakie pola może mieć zmiana?
Dokumentacja Meta wymienia wśród pól wartości zmiany w feedzie te, które występują zależnie od rodzaju zmiany:
post_id,comment_idiparent_id: post, komentarz i to, do czego należy.- from: ID i nazwa tego, kto dokonał zmiany.
- message: tekst, z link, photo, photos lub video dla dołączonych treści.
created_time, a dla edycjiedited_time.reaction_typedla reakcji orazis_hiddenokreślające, czy post jest ukryty.- post: szczegóły, takie jak
status_type,is_published,updated_timeipermalink_url.
Jak strona zostaje zasubskrybowana?
Aplikacja wysyła POST /{page-id}/subscribed_apps z polem subscribed_fields=feed i tokenem strony, od kogoś, kto może wykonać zadanie CREATE_CONTENT, MANAGE lub MODERATE, z nadanymi uprawnieniami pages_manage_metadata i pages_show_list. Meta wysyła powiadomienia tylko wtedy, gdy strona ma zainstalowaną aplikację i nie wyłączyła platformy aplikacji w swoich ustawieniach. easyCoexistence subskrybuje każdą stronę do feedu, messages i mention w chwili połączenia.
Jak zdarzenia z feedu docierają do endpointu?
Meta dostarcza je do aplikacji easyCoexistence, która sprawdza X-Hub-Signature-256, od razu odpowiada Meta i przekazuje każdy wpis dla połączonej strony na endpoint HTTPS, który dla niej ustawisz. Przekazanie zawiera nagłówek X-EC-Signature, czyli HMAC-SHA256 z znacznika czasu i surowej treści żądania, liczony kluczem sekretnym tej strony. Jest wysyłane jednorazowo, bez zachowywania kopii i bez ponowień. Endpoint ustawiasz przez set_social_webhook_destination lub PUT /channels/:id/webhook w Partner API.
Które zmiany w feedzie uruchamiają reguły komentarzy i automatyzacje?
Tylko nowe komentarze: zmiana z item comment i verb add w jednym z postów strony. Reguły komentarz-do-DM sprawdzają jego treść pod kątem słów kluczowych i pomijają komentarze napisane przez samą stronę, a automatyzacje obejmują komentarze, na które żadna reguła nie odpowiedziała. Edycje, ukrycia, reakcje i posty trafiają prosto na Twój endpoint, jeśli go ustawisz.
Typowe błędy
- Traktowanie każdej zmiany w feedzie jak nowego komentarza. Sprawdź item i verb: reakcje, edycje, ukrycia i usunięcia przychodzą w tym samym polu feed.
- Odpowiadanie na własne komentarze strony. Jej odpowiedzi wracają jako zmiany w feedzie, więc pomijaj te, których from.id to ID strony.
- Zakładanie jednej zmiany na dostawę. Meta może grupować do 1 000 aktualizacji, więc przeglądaj każdy wpis i każdą zmianę w nim.
- Odczytywanie entry.time jako chwili zmiany. Meta ustawia je na moment wysłania powiadomienia, a created_time w wartości to chwila utworzenia obiektu.
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, z pierwsze 3 dni bezpłatnie.
Najczęściej zadawane pytania
Czy webhook feedu zawiera komentarze?
Tak. Nowy komentarz przychodzi jako zmiana w feedzie z item comment i verb add, z comment_id, post_id, from i message.
Czy dostaję webhooki o polubieniach strony?
Tylko dla stron z mniej niż 10 000 polubień, według dokumentacji Meta dotyczącej webhooków stron.
Czy posty reklamowe są w webhooku feedu?
Same posty reklamowe nie, ale komentarze pod nimi są wysyłane.
Czy potrzebuję własnej aplikacji Meta, żeby dostawać zdarzenia z feedu strony?
Nie. Meta dostarcza je do aplikacji easyCoexistence, która przekazuje każde zdarzenie na endpoint ustawiony dla tej strony.
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