Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Facebook mention webhook: kapag may nag-mention sa iyong Page

Ang mention field ng webhook ng Page sa Facebook ay nagbibigay-abiso sa isang app kapag may nag-@mention sa Page sa isang post o comment. Nagpapadala ang Meta ng change na ang field ay nakatakda sa mention, at ang value nito ay maaaring maglaman ng post_id, ang comment_id para sa comment, ang text sa message, mga naka-attach na link at media, at ang item at verb, sa isang POST na pirmado ng X-Hub-Signature-256.

Ina-subscribe ng easyCoexistence ang bawat Page na ikinokonekta ninyo sa mention field, kasama ng feed at messages, at ipinapasa ang mga mention event nito sa inyong HTTPS endpoint habang dumarating, pirmado gamit ang secret para sa Page na iyon at walang kopyang itinatago, para malaman ng inyong agent ang bawat mention habang nangyayari ito.

mention

Field ng Page webhook para sa mga bagong mention ng isang Page, kasama ang mga mention sa comment at post.

pages_manage_metadata

Permission na dapat ibigay ng Page admin na may MODERATE privileges bago maabot ng Page webhooks ang callback URL ng isang app.

@ + name

Paraan ng pag-mention sa Page sa post o comment: i-type ang @ at ang pangalan ng Page, saka piliin ito.

36 hours

Gaano katagal nire-retry ng Meta ang hindi naipadalang Page notification, na bumababa ang dalas, bago ito tanggalin.

tagged_time

Field na idinadagdag ng /{page-id}/tagged edge sa bawat pampublikong post kung saan na-tag ang Page.

Ano ang nagpapagana sa mention webhook?

Kapag may nag-mention sa Page sa post o comment. Sa Facebook, ginagawa ang mention sa pamamagitan ng pag-type ng @ at pangalan ng Page at pagpili nito mula sa suggestions, at inilalarawan ng reference ng Meta ang field bilang mga bagong mention ng Page, kasama ang mga mention sa comment at post. Sinasabi ng Help Center ng Facebook na maaaring pigilan ng settings ng Page ang mga tao na i-mention ito.

Ano ang itsura ng mention notification?

Isang POST na may object na page at isang entry para sa Page na na-mention: ang ID nito, oras, at changes array na ang field ay mention. Nakalista sa reference ng Meta ang mga field ng value pero walang sample, kaya hinubog ang mention sa post na ito batay sa listahang iyon:

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>"
          }
        }
      ]
    }
  ]
}

Ano ang ibig sabihin ng bawat field ng mention?

Ito ang mga field ng value sa reference ng Meta; alin sa mga ito ang dala ng notification ay nakadepende sa post o comment:

  • post_id: ang ID ng post na nag-mention sa Page.
  • comment_id: ang ID ng comment, kapag nasa comment ang mention; parent_id: ang ID ng parent nito.
  • message: ang text na may dalang mention.
  • link, photo, photos at video: mga link sa naka-attach sa post o comment.
  • item at verb: ang uri ng object at kung ano ang nangyari dito, mula sa parehong listahan na ginagamit ng feed field.
  • created_time: kailan ginawa ang post o comment.
  • from at message_tags: ang author at ang mga profile na naka-tag sa text, parehong para lang sa Workplace ang nakamarka.
  • Nakalista rin: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id at open_graph_story_id.

Aling permission ang kailangan ng mention field?

pages_manage_metadata, na kailangang ibigay ng Page admin na may MODERATE privileges bago maabot ng Page webhooks ang isang app. Ina-subscribe ang Page sa pamamagitan ng POST /{page-id}/subscribed_apps na may mention sa subscribed_fields, gamit ang Page token mula sa taong may CREATE_CONTENT, MANAGE o MODERATE task, kasama ang pages_manage_metadata at pages_show_list. Kailangan ding i-subscribe ng app ang mention, dahil tanging mga field na naka-subscribe sa dalawang antas ang naihahatid, at ang mga Page na pinapatakbo ng taong walang role sa app ay nangangailangan ng mga permission na iyon sa Advanced Access.

Paano basahin ang post o comment na nag-mention sa Page?

Sa pamamagitan ng ID nito, gamit ang token ng Page, kung pinapayagan ng Meta. Nababasa ng Page token ang mga post na na-publish sa o ng Page; ang mga pampublikong ibinahaging post ng ibang Page ay nangangailangan ng pages_manage_posts at ng Page Public Content Access feature, gamit ang token mula sa Page admin; at iniuugnay ng Meta ang pagbasa sa post ng isang tao sa user_posts permission ng taong iyon.

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>

Saan pa makikita ng Page ang mga mention nito?

Sa tagged edge. Inililista ng GET /{page-id}/tagged ang mga pampublikong post kung saan na-tag ang Page, bawat isa may tagged_time, na sumasaklaw din sa mga post bago i-set up ang webhook. Kailangan ito ng Page token mula sa taong may CREATE_CONTENT, MANAGE o MODERATE task, kasama ang pages_read_user_content at pages_show_list, at sinasabi ng Meta na maaaring kailanganin ang Page Public Content Access feature. Sa post ng isang tao, ibinabalik ng Meta ang from sa taong sumulat lang nito.

Paano ipinapadala ng easyCoexistence ang mention events?

Ina-subscribe nito ang bawat Page sa mention, kasama ng feed at messages, kapag nakakonekta ang Page. Sinusuri ng app nito ang X-Hub-Signature-256 sa bawat delivery, sumasagot agad sa Meta, at ipinapadala ang bawat entry para sa Page, hindi binago, sa HTTPS endpoint na itinakda ninyo gamit ang set_social_webhook_destination o PUT /channels/:id/webhook sa Partner API:

  • X-EC-Signature ay may dalang t=<unix>,v1=<hex>: ang HMAC-SHA256 ng timestamp, tuldok, at raw body, na ginamitan ng signing secret ng Page.
  • Nagsisimula sa whsec_ ang secret at ipinapakita nang isang beses; ang pagtatakda muli ng URL ay naglalabas ng bago, at ang null na URL ay humihinto sa pagpapasa.
  • Bawat entry ay ipinapadala nang isang beses, naghihintay nang hanggang 8 segundo, sa HTTPS address na nagre-resolve sa public IP, walang sinusundang redirect at walang kopyang itinatago.
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>"
        }
      }
    ]
  }
}

Mga karaniwang pagkakamali

  • Pagbabasa sa entry.time bilang oras ng mention. Itinatakda ito ng Meta sa oras ng pagpapadala ng notification; ang created_time sa value ang nagpe-petsa sa post o comment.
  • Pag-treat sa lookup na pumalya bilang sirang event. Binabalaan ng Meta na may ilang post_id at comment_id sa mention notifications na hindi maaaring i-query dahil sa kakulangan ng permission o dahil sa privacy, kaya itago ang text ng message mula mismo sa event.
  • Pagkuha ng post bago sumagot sa forward. Hindi nire-retry ang mga forward, kaya magbalik agad ng 2xx at hanapin ang post pagkatapos.
Ginagawa ito gamit ang EasyCoexistence

Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Sinasabi ba ng mention webhook kung sino ang nag-mention sa Page?

Hindi para sa Page: minamarkahan ng reference ng Meta ang from bilang para lang sa Workplace. Ang paghanap sa post o comment gamit ang ID nito ay maaaring magbalik ng author nito kung pinapayagan ng permissions ng Meta.

Makakakuha ba ako ng mga mention mula bago na-subscribe ang Page?

Hindi mula sa webhook, dahil walang history ng notification na maaaring i-query ang Meta. Inililista ng tagged edge ang mga pampublikong post kung saan na-tag ang Page.

Paano naiiba ang mention field sa feed?

Iniuulat ng feed ang mga pagbabago sa sariling feed ng Page, gaya ng mga post, comment at reaction doon; iniuulat ng mention na na-@mention ang Page sa post o comment. Hiwalay na naka-subscribe ang bawat field.

Gumagana ba sa mention ang mga comment rules ng easyCoexistence?

Hindi. Ang mga rule at automation ay kumikilos sa mga comment mula sa feed field at sa mga mensahe sa Messenger; ang mga pagbabago sa mention ay ipinapasa sa inyong endpoint kung paano ito ipinadala ng Meta.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong