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

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.

10K likes

Powiadomienia z feedu o polubieniach strony są wysyłane wyłącznie dla stron z mniejszą liczbą polubień niż ten próg.

Ad posts

Pole feed nie wysyła niczego dla samych postów reklamowych, ale wysyła komentarze pod nimi.

pages_manage_metadata

Uprawnienie, jakie musi nadać administrator strony z uprawnieniami MODERATE, aby webhooki strony dotarły do aplikacji.

1,000

Większość aktualizacji Meta grupuje w jedną dostawę webhooka, choć nie gwarantuje grupowania.

36 hours

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:

A feed change, as Meta sends it
{
  "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_id i parent_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 edycji edited_time.
  • reaction_type dla reakcji oraz is_hidden określające, czy post jest ukryty.
  • post: szczegóły, takie jak status_type, is_published, updated_time i permalink_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.
Z EasyCoexistence zrobisz to

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