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.
Webhookove daju samo polja pretplaćena i na razini stranice i na razini aplikacije; stranica može navesti više polja nego aplikacija.
Zadaci stranice, od kojih osoba iza tokena treba jedan za čitanje ili stvaranje pretplate.
Vraća se uz success kada aplikacija s DELETE ukloni svoju webhook pretplatu sa stranice.
Što /{app-id}/subscriptions traži za čitanje, stvaranje ili brisanje pretplate na razini aplikacije.
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:
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, uzpages_manage_metadataipages_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_engagementiads_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:
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.
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