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

Webhook wzmianki na Facebooku: kiedy ktoś oznacza Twoją Stronę

Pole mention w webhookach Strony na Facebooku powiadamia aplikację, gdy ktoś oznaczy Stronę w poście lub komentarzu. Meta wysyła obiekt change z polem field ustawionym na mention, którego wartość (value) może zawierać post_id, comment_id dla komentarza, tekst w polu message, dołączone linki i media oraz item i verb, w żądaniu POST podpisanym nagłówkiem X-Hub-Signature-256.

easyCoexistence subskrybuje każdą połączoną Stronę do pola mention, obok feed i messages, i przekazuje jej zdarzenia wzmianek na Twój endpoint HTTPS w chwili ich nadejścia.

mention

Pole webhooka Strony dla nowych wzmianek o Stronie, także w komentarzach i postach.

pages_manage_metadata

Uprawnienie, które administrator Strony z uprawnieniami MODERATE musi przyznać, zanim webhooki Strony dotrą pod adres callback URL aplikacji.

@ + name

Jak ludzie wzmiankują Stronę w poście lub komentarzu: wpisują @ i nazwę Strony, a potem ją wybierają.

36 hours

Jak długo Meta ponawia nieudane powiadomienie o Stronie, z coraz rzadszymi próbami, zanim je porzuci.

tagged_time

Pole, które krawędź /{page-id}/tagged dodaje do każdego publicznego posta, w którym oznaczono Stronę.

Co uruchamia webhook wzmianki?

Ktoś, kto wzmiankuje Stronę w poście lub komentarzu. Na Facebooku wzmiankę tworzy się, wpisując @ i nazwę Strony oraz wybierając ją z podpowiedzi. Dokumentacja Meta opisuje to pole jako nowe wzmianki o Stronie, także w komentarzach i postach. Centrum Pomocy Facebooka zauważa, że ustawienia Strony mogą uniemożliwić jej wzmiankowanie.

Jak wygląda powiadomienie o wzmiance?

Żądanie POST z object ustawionym na page i jednym wpisem dla wzmiankowanej Strony: jej identyfikator, czas oraz tablica changes, której pole field to mention. Dokumentacja Meta wymienia pola wartości, ale nie podaje przykładu, więc poniższa wzmianka w poście została ułożona według tej listy:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

Co oznacza każde pole wzmianki?

To pola wartości z dokumentacji Meta. Które z nich przychodzą w powiadomieniu, zależy od posta lub komentarza:

  • post_id: identyfikator posta, który wzmiankował Stronę.
  • comment_id: identyfikator komentarza, gdy wzmianka jest w komentarzu; parent_id: identyfikator jego elementu nadrzędnego.
  • message: tekst zawierający wzmiankę.
  • link, photo, photos i video: linki do treści załączonych do posta lub komentarza.
  • item i verb: rodzaj obiektu i to, co się z nim stało, z tych samych list, których używa pole feed.
  • created_time: czas utworzenia posta lub komentarza.
  • from i message_tags: autor oraz profile oznaczone w tekście, oba oznaczone jako tylko Workplace.
  • Wymienione też: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id i open_graph_story_id.

Jakie uprawnienie potrzebuje pole wzmianki?

pages_manage_metadata, które Meta wymaga, by administrator Strony z uprawnieniami MODERATE przyznał, zanim webhooki Strony dotrą do aplikacji. Strona jest subskrybowana przez POST /{page-id}/subscribed_apps z mention wśród subscribed_fields, przy użyciu tokenu Strony od osoby z zadaniem CREATE_CONTENT, MANAGE lub MODERATE, z pages_manage_metadata i pages_show_list. Aplikacja również subskrybuje mention, bo dostarczane są tylko pola subskrybowane na obu poziomach, a Strony prowadzone przez osoby bez roli w aplikacji potrzebują tych uprawnień w Advanced Access.

Jak odczytać post lub komentarz, który wzmiankuje Stronę?

Po jego identyfikatorze, tokenem Strony, tam gdzie Meta na to pozwala. Token Strony odczytuje posty opublikowane na Stronie lub przez nią; publicznie udostępnione posty innych Stron wymagają pages_manage_posts i funkcji Page Public Content Access, przy tokenie administratora Strony. Meta wiąże też odczyt własnego posta danej osoby z jej uprawnieniem user_posts.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

Gdzie jeszcze Strona może znaleźć swoje wzmianki?

W krawędzi tagged. GET /{page-id}/tagged zwraca publiczne posty, w których oznaczono Stronę, każdy z tagged_time, co obejmuje także posty sprzed ustawienia webhooka. Wymaga tokenu Strony od osoby z zadaniem CREATE_CONTENT, MANAGE lub MODERATE, z pages_read_user_content i pages_show_list, a Meta podaje, że może być potrzebna funkcja Page Public Content Access. Przy poście osoby Meta zwraca pole from wyłącznie osobie, która go napisała.

Jak easyCoexistence dostarcza zdarzenia wzmianek?

Subskrybuje każdą Stronę do mention, obok feed i messages, gdy Strona się łączy. Jego aplikacja sprawdza X-Hub-Signature-256 przy każdym dostarczeniu, od razu odpowiada Meta i wysyła POST każdego wpisu dotyczącego Strony, bez zmian, na adres HTTPS, który ustawiasz przez set_social_webhook_destination lub PUT /channels/:id/webhook w Partner API:

  • X-EC-Signature zawiera t=<unix>,v1=<hex>: HMAC-SHA256 znacznika czasu, kropki i surowego ciała, z kluczem będącym sekretem podpisu Strony.
  • Sekret zaczyna się od whsec_ i jest pokazywany jeden raz; ponowne ustawienie adresu wydaje nowy, a adres null zatrzymuje przekazywanie.
  • Każdy wpis wychodzi jednorazowo, z czasem oczekiwania do 8 sekund, na adres HTTPS rozwiązujący się do publicznego IP, bez podążania za przekierowaniami i bez zachowywania kopii.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

Typowe błędy

  • Traktowanie entry.time jako chwili wzmianki. Meta ustawia je na moment wysłania powiadomienia, a created_time w wartości datuje post lub komentarz.
  • Uznawanie nieudanego wyszukania za błędne zdarzenie. Meta ostrzega, że niektórych wartości post_id i comment_id w powiadomieniach o wzmiankach nie da się odpytać z powodu braku uprawnień lub prywatności, więc zachowaj treść z pola message z samego zdarzenia.
  • Pobieranie posta przed odpowiedzią na przekazanie. Przekazania nie są ponawiane, więc od razu zwróć 2xx, a post wyszukaj później.
Z EasyCoexistence zrobisz to

Są podpisane sekretem dla tej Strony i nie zachowujemy ich kopii, dzięki czemu Twój agent wie o każdej wzmiance w chwili, gdy się pojawia. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami w bezpłatnym okresie próbnym.

Najczęściej zadawane pytania

Czy webhook wzmianki mówi, kto wzmiankował Stronę?

Nie dla Strony: dokumentacja Meta oznacza from jako tylko Workplace. Wyszukanie posta lub komentarza po identyfikatorze może zwrócić jego autora, o ile uprawnienia Meta na to pozwalają.

Czy mogę dostać wzmianki sprzed subskrypcji Strony?

Nie z webhooka, bo Meta nie prowadzi historii powiadomień do odpytania. Krawędź tagged wylicza publiczne posty, w których oznaczono Stronę.

Czym pole mention różni się od feed?

feed raportuje zmiany we własnym feedzie Strony, czyli w postach, komentarzach i reakcjach. mention raportuje, że Strona została wzmiankowana w poście lub komentarzu. Każde pole subskrybuje się osobno.

Czy reguły komentarzy easyCoexistence działają na wzmianki?

Nie. Reguły i automatyzacje działają na komentarzach z pola feed oraz na wiadomościach Messengera. Zmiany dotyczące mention są przekazywane na Twój endpoint dokładnie tak, jak wysłała je Meta.

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