Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Pretplata Facebook stranice na webhookove: edge subscribed_apps

Facebook stranica pretplaćuje se na webhookove aplikacije pozivom POST /{page-id}/subscribed_apps, uz subscribed_fields poput feed,messages i Page access token osobe sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE te dodijeljene dozvole pages_manage_metadata i pages_show_list. Meta šalje događaje polja samo ako se aplikacija pretplati i na njega; GET prikazuje pretplatu, a DELETE je uklanja.

easyCoexistence pretplaćuje svaku stranicu koju povežete na feed, messages i mention putem subscribed_apps, odjavljuje je kad je uklonite i prosljeđuje događaje stranice vašem HTTPS endpointu potpisane tajnom za tu stranicu, iz jednog MCP konektora ili Partner API-ja.

Both levels

Webhookove daju samo polja pretplaćena i na razini stranice i na razini aplikacije; stranica može navesti više polja nego aplikacija.

CREATE_CONTENT, MANAGE or MODERATE

Zadaci stranice, od kojih osoba iza tokena treba jedan za čitanje ili stvaranje pretplate.

messaging_success

Vraća se uz success kada aplikacija s DELETE ukloni svoju webhook pretplatu sa stranice.

App access token

Što /{app-id}/subscriptions traži za čitanje, stvaranje ili brisanje pretplate na razini aplikacije.

1 hour

Neuspjelih Messenger isporuka prije nego što Meta odjavi aplikaciju sa stranice, dok se ponovno ne pretplati.

Što radi edge subscribed_apps?

Instalira aplikaciju na stranicu i određuje koja webhook polja stranice aplikacija prima. Meta šalje obavijesti samo dok je aplikacija instalirana na stranici i nije isključena platforma aplikacija u postavkama stranice te samo za polja pretplaćena na obje razine: stranične, putem ovog edgea, i one aplikacije, postavljene u App Dashboardu ili putem /{app-id}/subscriptions. Stranica može biti pretplaćena na više polja nego aplikacija.

Kako pretplatiti stranicu?

POST-om na edge, s subscribed_fields koji navodi polja odvojena zarezima, i Page access tokenom stranice. Uspješan poziv vraća success true, a poziv koji navodi messages zahtijeva i pages_messaging na tokenu:

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 }

Koji token, zadaci i dozvole su potrebni?

Page access token, koji veže poziv za jednu stranicu, od osobe koja može djelovati na toj stranici. Metine reference i vodiči postavljaju ove zahtjeve:

  • Bilo koje polje: osoba sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE, uz pages_manage_metadata i pages_show_list.
  • messages i ostala Messenger polja: i pages_messaging, na tokenu osobe koja može obaviti zadatak MESSAGING.
  • leadgen: zadatak ADVERTISE, uz leads_retrieval, pages_read_engagement i ads_management.
  • Čitanje pretplate putem GET-a zahtijeva iste zadatke i dozvole kao i stvaranje.

Koju razinu pristupa polja trebaju?

Napredni pristup (Advanced Access), za stranice i osobe izvan vlastitih uloga aplikacije. Uz Standardni pristup, Messenger obavijesti dolaze samo od osoba s ulogom u aplikaciji, poput njezinih administratora, programera i testera; Napredni pristup, odobren po dozvoli kroz App Review i uz Business Verification, otvara ih kupcima aplikacije. Metin vodič za Messenger među preduvjetima navodi i objavljivanje aplikacije.

Što je pretplata na razini aplikacije?

Druga polovica: polja koja sama aplikacija sluša, s njezinim callback URL-om. Postavlja se u App Dashboardu ili POST-om na /{app-id}/subscriptions s tokenom pristupa aplikacije, uz object=page, callback_url, fields, include_values i verify_token, čime se pokreće Metin zahtjev za provjeru. GET na istom edgeu prikazuje callback_url, fields i je li pretplata aktivna za svaki objekt, novi POST mijenja polja bez prepisivanja ostalih, a DELETE uklanja sva ili navedena polja.

Kako provjeriti na što je stranica pretplaćena?

GET-om na istom edgeu i tokenom stranice. Polje data navodi svaku aplikaciju koju je stranica instalirala, s njezinim imenom, ID-om i subscribed_fields, a vraća se prazno kada stranica nema instaliranih aplikacija:

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

Kako ukloniti pretplatu?

DELETE-om na /{page-id}/subscribed_apps, koji odvaja aplikaciju od stranice; aplikacija može ukloniti vlastitu pretplatu tokenom pristupa aplikacije, a odgovor sadrži success i messaging_success. Meta je također uklanja sama: nakon sat vremena neuspjelih Messenger isporuka aplikacija se odjavljuje sa stranice i mora se ponovno pretplatiti kada njezin endpoint proradi.

Što easyCoexistence radi pri povezivanju?

Pretplaćuje svaku stranicu koju osoba odabere, odmah nakon spremanja tokena te stranice: POST /{page-id}/subscribed_apps sa subscribed_fields postavljenim na feed,messages,mention. Ako Meta odbije, stranica ostaje povezana, a list_social_accounts u polju last_error prikazuje razlog. Uklanjanje stranice šalje DELETE /{page-id}/subscribed_apps prije nego se token odbaci, a nijedan alat ne dosiže putanje subscribed_apps i token, pa pretplatom upravlja isključivo easyCoexistence.

Uobičajene pogreške

  • Poziv edgea s korisničkim tokenom. Traži Page access token stranice koja se pretplaćuje.
  • Pretplata stranice bez pretplate aplikacije. Polje dolazi do callbacka samo ako ga uključuje i vlastita pretplata aplikacije.
  • Izostavljanje pages_messaging pri pretplati na messages. Meta to zahtijeva, na tokenu osobe koja može obaviti zadatak MESSAGING.
  • Zaboravljena ponovna pretplata nakon prekida. Sat vremena neuspjelih Messenger isporuka odjavljuje aplikaciju, a događaji prestaju dok se POST ponovno ne pošalje.
Radite ovo uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s prva 3 dana besplatno.

Često postavljana pitanja

Moram li pretplatiti svaku stranicu zasebno?

Da. subscribed_apps radi po stranici, s tokenom te stranice, dok se pretplata na razini aplikacije za objekt page odnosi na stranice koje su instalirale aplikaciju.

Zašto subscribed_apps vraća grešku 200?

Meta navodi 200 kao grešku dozvola za ovaj edge. Provjerite nosi li token pages_manage_metadata i pages_show_list te dolazi li od osobe sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE.

Može li se stranica pretplatiti iz Graph API Explorera?

Da. Metin vodič odabire aplikaciju, dobiva korisnički token s pages_manage_metadata, mijenja ga za token stranice i šalje POST na {page-id}/subscribed_apps.

Mogu li dodati webhook polja stranici povezanoj s easyCoexistence?

Ne putem njegovih alata: nijedan ne dosiže putanje subscribed_apps, a stranica ostaje pretplaćena na feed, messages i mention, polja koja easyCoexistence prosljeđuje.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na