IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Webhook ya kutajwa ya Facebook: mtu anapotaja Ukurasa wako

Field ya mention ya webhook ya Ukurasa wa Facebook huiarifu programu mtu anapotaja Ukurasa katika chapisho au maoni. Meta hutuma mabadiliko yenye field iliyowekwa kuwa mention, na thamani yake inaweza kubeba post_id, comment_id ya maoni, maandishi katika message, viungo na midia vilivyoambatishwa, pamoja na item na verb. Hutumwa kama POST iliyosainiwa kwa X-Hub-Signature-256.

easyCoexistence humsajili kila Ukurasa unaounganisha kwenye field ya mention, pamoja na feed na messages, na husambaza matukio yake ya kutajwa kwenye endpoint yako ya HTTPS yanapofika.

mention

Field ya webhook ya Ukurasa kwa kutajwa kipya, pamoja na kutajwa katika maoni na machapisho.

pages_manage_metadata

Ruhusa ambayo msimamizi wa Ukurasa mwenye ruhusa za MODERATE lazima aitoe kabla webhook za Ukurasa hazijafika kwenye callback URL ya programu.

@ + name

Jinsi watu wanavyotaja Ukurasa katika chapisho au maoni: andika @ pamoja na jina la Ukurasa, kisha uchague.

36 hours

Muda ambao Meta hujaribu tena arifa ya Ukurasa iliyoshindikana, kwa kupungua kwa mara kwa mara, kabla ya kuiacha.

tagged_time

Field ambayo edge ya /{page-id}/tagged huongeza kwa kila chapisho la umma ambalo Ukurasa umetambulishwa.

Nini huchochea webhook ya kutajwa?

Mtu anapotaja Ukurasa katika chapisho au maoni. Kwenye Facebook, kutajwa hufanywa kwa kuandika @ pamoja na jina la Ukurasa kisha kuuchagua kutoka kwenye mapendekezo. Rejeleo la Meta linaeleza field hiyo kama kutajwa kipya kwa Ukurasa, ikijumuisha kutajwa katika maoni na machapisho. Kituo cha Msaada cha Facebook kinaeleza kuwa mipangilio ya Ukurasa inaweza kuzuia watu kuutaja.

Arifa ya kutajwa inaonekanaje?

POST yenye object iliyowekwa kuwa page na entry moja ya Ukurasa uliotajwa: kitambulisho chake, muda, na orodha ya changes ambayo field yake ni mention. Rejeleo la Meta linaorodhesha sehemu za thamani lakini halitoi mfano, kwa hiyo kutajwa katika chapisho kunaundwa kutokana na orodha hiyo:

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

Kila sehemu ya kutajwa inamaanisha nini?

Hizi ni sehemu za thamani kulingana na rejeleo la Meta. Arifa inabeba zipi inategemea chapisho au maoni husika:

  • post_id: kitambulisho cha chapisho lililotaja Ukurasa.
  • comment_id: kitambulisho cha maoni, pale kutajwa kuko katika maoni; parent_id: kitambulisho cha maoni yake mama.
  • message: maandishi yanayobeba kutajwa.
  • link, photo, photos na video: viungo vya kile ambacho chapisho au maoni limeambatisha.
  • item na verb: aina ya kitu na kilichotokea kwake, kutoka kwenye orodha zile zile ambazo field ya feed hutumia.
  • created_time: wakati chapisho au maoni lilipoundwa.
  • from na message_tags: mwandishi na wasifu zilizotambulishwa katika maandishi, zote zikiwa Workplace pekee.
  • Pia imeorodheshwa: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id na open_graph_story_id.

Ruhusa gani field ya kutajwa inahitaji?

pages_manage_metadata, ambayo Meta inahitaji msimamizi wa Ukurasa mwenye ruhusa za MODERATE aitoe kabla webhook za Ukurasa hazijafika kwenye programu. Ukurasa unajisajili kupitia POST /{page-id}/subscribed_apps ukiwa na mention miongoni mwa subscribed_fields, ukitumia token ya Ukurasa kutoka kwa mtu mwenye kazi ya CREATE_CONTENT, MANAGE au MODERATE, pamoja na pages_manage_metadata na pages_show_list. Programu nayo hujisajili kwa mention, kwa sababu field zilizosajiliwa katika ngazi zote mbili pekee ndizo hufikishwa. Kurasa zinazoendeshwa na watu wasio na jukumu kwenye programu zinahitaji ruhusa hizo katika Advanced Access.

Unasomaje chapisho au maoni yanayotaja Ukurasa?

Kwa kitambulisho chake, kwa token ya Ukurasa, pale Meta inaporuhusu. Token ya Ukurasa husoma machapisho yaliyochapishwa kwa Ukurasa au nayo. Machapisho ya Kurasa nyingine yaliyoshirikishwa hadharani yanahitaji pages_manage_posts na kipengele cha Page Public Content Access, kwa token ya msimamizi wa Ukurasa. Meta pia inafunga usomaji wa chapisho la mtu kwenye ruhusa ya user_posts ya mtu huyo.

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>

Ukurasa unaweza kupata wapi kutajwa kwingine?

Kwenye edge ya tagged. GET /{page-id}/tagged huorodhesha machapisho ya umma ambamo Ukurasa umetambulishwa, kila moja likiwa na tagged_time, na hili pia linajumuisha machapisho ya kabla webhook haijawekwa. Inahitaji token ya Ukurasa kutoka kwa mtu mwenye kazi ya CREATE_CONTENT, MANAGE au MODERATE, pamoja na pages_read_user_content na pages_show_list. Meta inasema kipengele cha Page Public Content Access kinaweza kuhitajika. Kwenye chapisho la mtu, Meta hurudisha from kwa mwandishi wake pekee.

easyCoexistence inatumaje matukio ya kutajwa?

Inajisajili kila Ukurasa kwenye mention, pamoja na feed na messages, Ukurasa unapounganishwa. Programu yake hukagua X-Hub-Signature-256 kwenye kila utoaji, humjibu Meta mara moja, na hutuma kila entry ya Ukurasa, bila kubadilishwa, kwenye endpoint ya HTTPS uliyoweka kwa set_social_webhook_destination au PUT /channels/:id/webhook kwenye Partner API:

  • X-EC-Signature hubeba t=<unix>,v1=<hex>: HMAC-SHA256 ya muhuri wa muda, nukta na mwili ghafi, ikitumia siri ya kutia sahihi ya Ukurasa.
  • Siri huanza na whsec_ na huonyeshwa mara moja. Kuweka URL tena hutoa siri mpya, na URL null husimamisha usambazaji.
  • Kila entry hutumwa mara moja, ikisubiri hadi sekunde 8, kwenye anwani ya HTTPS inayoelekeza kwenye IP ya umma, bila kufuata uelekezaji upya na bila kuhifadhi nakala.
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>"
        }
      }
    ]
  }
}

Makosa ya kawaida

  • Kusoma entry.time kama wakati wa kutajwa. Meta huiweka kuwa wakati arifa ilipotumwa; created_time ndani ya value ndiyo inayoonyesha tarehe ya chapisho au maoni.
  • Kuchukulia utafutaji ulioshindwa kama tukio lililoharibika. Meta inaonya kuwa baadhi ya thamani za post_id na comment_id katika arifa za kutajwa haziwezi kuulizwa, kwa sababu ya ukosefu wa ruhusa au faragha, kwa hiyo hifadhi maandishi ya ujumbe kutoka kwenye tukio lenyewe.
  • Kuchukua chapisho kabla ya kujibu uwasilishaji. Uwasilishaji haujaribiwi tena, kwa hiyo rudisha 2xx mara moja kisha utafute chapisho baadaye.
Kufanya hili ukitumia EasyCoexistence

Yanasainiwa kwa siri ya Ukurasa huo na hayahifadhiwi nakala, ili wakala wako ajue kuhusu kila kutajwa kinapotokea. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kinashuka unapoongeza miunganisho, pamoja na kipindi cha majaribio bila malipo cha siku 3.

Maswali yanayoulizwa mara kwa mara

Je, webhook ya kutajwa inasema nani aliyetaja Ukurasa?

Si kwa Ukurasa: rejeleo la Meta linaweka from kuwa Workplace pekee. Kutafuta chapisho au maoni kwa kitambulisho chake kunaweza kurudisha mwandishi wake pale ruhusa za Meta zinaporuhusu.

Je, naweza kupata kutajwa kutoka kabla Ukurasa haujasajiliwa?

Si kupitia webhook, kwa sababu Meta haitunzi historia ya arifa ya kuulizwa. Edge ya tagged huorodhesha machapisho ya umma ambamo Ukurasa umetambulishwa.

Field ya mention inatofautianaje na feed?

feed huripoti mabadiliko kwenye feed ya Ukurasa yenyewe, kama machapisho, maoni na miitikio humo. mention huripoti Ukurasa ukitajwa kwa @ katika chapisho au maoni. Kila field hujisajili yenyewe.

Kanuni za maoni za easyCoexistence zinatenda kazi kwenye kutajwa?

Hapana. Kanuni na otomatiki hutenda kwenye maoni kutoka field ya feed na kwenye ujumbe wa Messenger. Mabadiliko ya mention husambazwa kwenye endpoint yako kama Meta ilivyoyatuma.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye