IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Kujisajili kwa Ukurasa wa Facebook kwenye webhook: edge ya subscribed_apps

Ukurasa wa Facebook hujisajili kwenye webhook za programu kwa POST /{page-id}/subscribed_apps, ukipitisha subscribed_fields kama feed,messages na token ya Ukurasa kutoka kwa mtu mwenye kazi ya CREATE_CONTENT, MANAGE au MODERATE, ukiwa na pages_manage_metadata na pages_show_list zimetolewa. Meta hutuma matukio ya sehemu fulani tu programu nayo ikijisajili kwake; GET huorodhesha usajili na DELETE huuondoa.

easyCoexistence hujisajili kwa kila Ukurasa unaounganisha kwa feed, messages na mention kupitia subscribed_apps, huondoa usajili wake unapouondoa, na kusambaza matukio ya Ukurasa kwenye endpoint yako ya HTTPS, yakisainiwa kwa siri maalum ya Ukurasa huo, kutoka kiunganishi kimoja cha MCP au Partner API.

Both levels

Sehemu zilizojisajiliwa kwenye ngazi ya Ukurasa na ya programu pekee ndizo zinazozalisha webhook; Ukurasa unaweza kuorodhesha zaidi ya programu.

CREATE_CONTENT, MANAGE or MODERATE

Kazi za Ukurasa, moja ambayo mtu aliye nyuma ya token anahitaji ili kusoma au kuunda usajili.

messaging_success

Hurejeshwa pamoja na mafanikio programu inapoondoa usajili wa webhook kutoka Ukurasa kwa DELETE.

App access token

Kile /{app-id}/subscriptions kinachohitaji ili kusoma, kuunda au kuondoa usajili wa kiwango cha programu.

1 hour

Idadi ya uwasilishaji wa Messenger unaoshindwa kabla Meta haijaondoa programu kutoka Ukurasa hadi ijisajili tena.

Edge ya subscribed_apps inafanya nini?

Inaweka programu kwenye Ukurasa na kubainisha ni sehemu zipi za webhook za Ukurasa programu inazopokea. Meta hutuma arifa tu wakati Ukurasa una programu imewekwa na haujazima jukwaa la programu kwenye mipangilio yake, na tu kwa sehemu zilizojisajiliwa katika ngazi zote mbili: ya Ukurasa, kupitia edge hii, na ya programu, iliyowekwa kwenye dashboard ya programu au kupitia /{app-id}/subscriptions. Ukurasa unaweza kujisajili kwenye sehemu nyingi kuliko programu.

Unajisajili vipi Ukurasa?

Kwa POST kwenye edge, subscribed_fields ikiorodhesha sehemu zilizotenganishwa kwa koma, na token ya Ukurasa. Wito uliofanikiwa hurudisha success true, na wito unaoorodhesha messages unahitaji pages_messaging kwenye token pia:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Ni token, kazi na ruhusa zipi inahitaji?

Token ya Ukurasa, inayofunga wito kwa Ukurasa mmoja, kutoka kwa mtu anayeweza kutenda kwa Ukurasa huo. Marejeo na miongozo ya Meta yanaweka mahitaji haya:

  • Sehemu yoyote: mtu mwenye kazi ya CREATE_CONTENT, MANAGE au MODERATE, pamoja na pages_manage_metadata na pages_show_list.
  • messages na sehemu nyingine za Messenger: pages_messaging pia, kwenye token ya mtu anayeweza kutekeleza kazi ya MESSAGING.
  • leadgen: kazi ya ADVERTISE, pamoja na leads_retrieval, pages_read_engagement na ads_management.
  • Kusoma usajili kwa GET kunahitaji kazi na ruhusa zilezile zinazohitajika kuunda usajili huo.

Ni kiwango gani cha ufikiaji sehemu zinahitaji?

Ufikiaji wa Juu, kwa Kurasa na watu walio nje ya majukumu ya programu yenyewe. Kwa Ufikiaji wa Kawaida, arifa za Messenger zinatoka tu kwa watu wenye jukumu kwenye programu, kama wasimamizi, wasanidi programu na wajaribu; Ufikiaji wa Juu, unaotolewa kwa kila ruhusa kupitia Ukaguzi wa Programu na unaohitaji Uthibitishaji wa Biashara, unawafungulia wateja wa programu. Mwongozo wa Messenger wa Meta pia unaorodhesha kuchapisha programu miongoni mwa mahitaji ya awali.

Usajili wa kiwango cha programu ni upi?

Nusu nyingine: sehemu ambazo programu yenyewe inasikiliza, pamoja na callback URL yake. Huwekwa kwenye dashboard ya programu au kwa POST /{app-id}/subscriptions na token ya ufikiaji wa programu, ukipitisha object=page, callback_url, fields, include_values na verify_token, jambo linalozindua ombi la uthibitishaji la Meta. GET kwenye edge hiyo hiyo huonyesha callback_url, fields na kama usajili unafanya kazi kwa kila kitu; POST mpya hubadilisha sehemu bila kufuta nyingine, na DELETE huondoa zote au sehemu zilizotajwa.

Unakagua vipi Ukurasa umejisajili nini?

Kwa GET kwenye edge hiyo hiyo na token ya Ukurasa. Safu ya data huorodhesha kila programu ambayo Ukurasa umeweka, pamoja na jina lake, ID yake na subscribed_fields, na hurudi tupu Ukurasa usipokuwa na programu zilizowekwa:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Unaondoa usajili vipi?

Kwa DELETE /{page-id}/subscribed_apps, ambayo hutenganisha programu na Ukurasa; programu inaweza kuondoa usajili wake yenyewe kwa token ya ufikiaji wa programu, na jibu hushikilia success na messaging_success. Meta pia huondoa usajili yenyewe: baada ya saa moja ya uwasilishaji wa Messenger unaoshindwa, programu inaondolewa kwenye Ukurasa na inapaswa kujisajili tena mara endpoint yake ikifanya kazi.

easyCoexistence inafanya nini wakati wa kuunganisha?

Inajisajili kwa kila Ukurasa mtu anaouchagua, mara tu baada ya kuhifadhi token ya Ukurasa huo: POST /{page-id}/subscribed_apps ikiwa na subscribed_fields zikiwekwa feed,messages,mention. Meta ikikataa, Ukurasa unabaki umeunganishwa na list_social_accounts inaonyesha sababu katika last_error. Kuondoa Ukurasa kunatuma DELETE /{page-id}/subscribed_apps kabla token haijafutwa, na hakuna zana inayofikia njia za subscribed_apps wala token, hivyo usajili unasimamiwa na easyCoexistence pekee.

Makosa ya kawaida

  • Kuita edge kwa token ya mtumiaji. Inachukua token ya Ukurasa husika.
  • Kujisajili Ukurasa bila programu. Sehemu hufika kwenye callback URL pale tu usajili wa programu yenyewe unapoijumuisha pia.
  • Kuacha pages_messaging nje unapojisajili kwa messages. Meta inaihitaji, kwenye token ya mtu anayeweza kutekeleza kazi ya MESSAGING.
  • Kusahau kujisajili tena baada ya kukatika kwa huduma. Saa moja ya uwasilishaji wa Messenger usiofanikiwa huondoa programu, na matukio yanasimama hadi POST itumwe tena.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, hushuka unapoongeza miunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, ninahitaji kujisajili kila Ukurasa kando?

Ndiyo. subscribed_apps hufanya kazi kwa kila Ukurasa, kwa token ya Ukurasa huo, ilhali usajili wa kiwango cha programu kwa object=page unatumika kwa Kurasa zilizosakinisha programu.

Kwa nini subscribed_apps inarudisha hitilafu 200?

Meta inaorodhesha 200 kama hitilafu ya ruhusa kwa edge hii. Hakikisha token ina pages_manage_metadata na pages_show_list na inatoka kwa mtu mwenye CREATE_CONTENT, MANAGE au MODERATE.

Je, Ukurasa unaweza kujisajiliwa kutoka Graph API Explorer?

Ndiyo. Mwongozo wa Meta huchagua programu, hupata token ya mtumiaji yenye pages_manage_metadata, kisha huibadilisha kuwa token ya Ukurasa na kutuma POST kwa {page-id}/subscribed_apps.

Je, ninaweza kuongeza sehemu za webhook kwenye Ukurasa uliounganishwa na easyCoexistence?

Si kupitia zana zake: hakuna inayofikia njia za subscribed_apps, na Ukurasa unabaki umejisajili kwa feed, messages na mention, sehemu ambazo easyCoexistence inazisambaza.

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