Abonarea unei pagini Facebook la webhook-uri: edge-ul subscribed_apps
O pagină Facebook este abonată la webhook-urile unei aplicații prin POST /{page-id}/subscribed_apps, transmițând subscribed_fields precum feed,messages și un token de acces al paginii de la cineva cu sarcina CREATE_CONTENT, MANAGE sau MODERATE, cu pages_manage_metadata și pages_show_list acordate. Meta trimite evenimentele unui câmp doar dacă aplicația se abonează și ea la acel câmp; GET listează abonamentul, iar DELETE îl elimină.
easyCoexistence abonează fiecare pagină pe care o conectezi la feed, messages și mention prin subscribed_apps, o dezabonează când o elimini și trimite evenimentele paginii către endpoint-ul tău HTTPS, semnate cu un secret pentru acea pagină, dintr-un singur conector MCP sau prin Partner API.
Doar câmpurile abonate atât la nivelul paginii, cât și la nivelul aplicației produc webhook-uri; o pagină poate lista mai multe câmpuri decât aplicația.
Sarcinile paginii, dintre care una este necesară persoanei din spatele token-ului pentru a citi sau a crea un abonament.
Returnat alături de success când o aplicație își elimină abonamentul webhook de la o pagină, cu DELETE.
Ce cere /{app-id}/subscriptions pentru a citi, crea sau șterge abonamentul la nivel de aplicație.
După o oră de livrări Messenger eșuate, Meta dezabonează aplicația de la pagină până când aceasta se abonează din nou.
Ce face edge-ul subscribed_apps?
Instalează aplicația pe pagină și stabilește care dintre câmpurile webhook ale paginii primește aplicația. Meta trimite notificări doar cât timp pagina are aplicația instalată și nu a dezactivat platforma aplicațiilor în setări, și doar pentru câmpurile abonate atât la nivelul paginii, prin acest edge, cât și la nivelul aplicației, setat în App Dashboard sau prin /{app-id}/subscriptions. O pagină poate fi abonată la mai multe câmpuri decât aplicația.
Cum abonezi o pagină?
Printr-un POST către edge, cu subscribed_fields care listează câmpurile separate prin virgulă, și token-ul de acces al paginii. Un apel reușit returnează success true, iar un apel care listează messages are nevoie și de pages_messaging pe token:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Ce token, ce sarcini și ce permisiuni are nevoie?
Un token de acces al paginii, care leagă apelul de o singură pagină, de la cineva care poate acționa în numele acelei pagini. Referințele și ghidurile Meta stabilesc aceste cerințe:
- Orice câmp: o persoană cu sarcina
CREATE_CONTENT, MANAGE sau MODERATE, pluspages_manage_metadatacupages_show_list. - messages și celelalte câmpuri Messenger: și
pages_messaging, pe un token de la cineva care poate îndeplini sarcina MESSAGING. - leadgen: sarcina ADVERTISE, cu
leads_retrieval,pages_read_engagementșiads_management. - Citirea abonamentului cu GET necesită aceleași sarcini și permisiuni ca și crearea lui.
Ce nivel de acces necesită câmpurile?
Advanced Access, pentru pagini și persoane din afara rolurilor aplicației. Cu Standard Access, notificările Messenger vin doar de la persoane cu un rol în aplicație, precum administratorii, dezvoltatorii și testerii ei; Advanced Access, acordat pe permisiune prin App Review și necesitând Business Verification, le deschide clienților aplicației. Ghidul Messenger al Meta menționează și publicarea aplicației printre cerințele prealabile.
Ce este abonamentul la nivel de aplicație?
Cealaltă jumătate: câmpurile pe care aplicația însăși le ascultă, împreună cu URL-ul ei de callback. Se setează în App Dashboard sau cu POST /{app-id}/subscriptions și un token de acces al aplicației, transmițând object=page, callback_url, fields, include_values și verify_token, ceea ce declanșează cererea de verificare a Meta. GET pe același edge arată callback_url, fields și dacă abonamentul este activ pentru fiecare obiect; un POST nou modifică câmpurile fără a le suprascrie pe celelalte, iar DELETE le elimină pe toate sau doar pe cele numite.
Cum verifici la ce este abonată o pagină?
Printr-un GET pe același edge și cu token-ul paginii. Matricea data listează fiecare aplicație instalată pe pagină, cu numele, ID-ul și subscribed_fields ei, și revine goală când pagina nu are aplicații instalate:
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"]
}
]
}Cum elimini un abonament?
Cu DELETE /{page-id}/subscribed_apps, care desprinde aplicația de pagină; o aplicație își poate elimina propriul abonament cu un token de acces al aplicației, iar răspunsul conține success și messaging_success. Meta îl elimină și singură: după o oră de livrări Messenger eșuate, aplicația este dezabonată de la pagină și trebuie să se aboneze din nou după ce endpoint-ul ei funcționează.
Ce face easyCoexistence la conectare?
Abonează fiecare pagină pe care o alege persoana, imediat după salvarea token-ului acelei pagini: POST /{page-id}/subscribed_apps cu subscribed_fields setat la feed,messages,mention. Dacă Meta refuză, pagina rămâne conectată, iar list_social_accounts afișează motivul în last_error. Eliminarea paginii trimite DELETE /{page-id}/subscribed_apps înainte ca token-ul să fie șters, iar niciun instrument nu accesează căile subscribed_apps sau de token, astfel abonamentul este gestionat exclusiv de easyCoexistence.
Greșeli frecvente
- Apelarea edge-ului cu un token de acces al utilizatorului. Acesta cere token-ul de acces al paginii care se abonează.
- Abonarea paginii, dar nu și a aplicației. Un câmp ajunge la callback doar dacă și abonamentul aplicației include câmpul.
- Omiterea pages_messaging la abonarea la messages. Meta o cere, pe un token de la cineva care poate îndeplini sarcina MESSAGING.
- Uitarea abonării din nou după o întrerupere. O oră de livrări Messenger eșuate dezabonează aplicația, iar evenimentele se opresc până când POST-ul este trimis din nou.
De la US$ 9 la US$ 0.75 per conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Trebuie să abonez fiecare pagină separat?
Da. subscribed_apps funcționează pe pagină, cu token-ul propriu al paginii, în timp ce abonamentul la nivel de aplicație pentru obiectul page se aplică paginilor care au instalat aplicația.
De ce întoarce subscribed_apps eroarea 200?
Meta listează 200 ca eroare de permisiuni pentru acest edge. Verifică dacă token-ul are pages_manage_metadata și pages_show_list și vine de la cineva cu CREATE_CONTENT, MANAGE sau MODERATE.
Poate o pagină să fie abonată din Graph API Explorer?
Da. Ghidul Meta alege aplicația, obține un token de utilizator cu pages_manage_metadata, îl schimbă cu token-ul paginii și trimite POST-ul către {page-id}/subscribed_apps.
Pot adăuga câmpuri webhook unei pagini conectate la easyCoexistence?
Nu prin uneltele sale: niciuna nu accesează căile subscribed_apps, iar pagina rămâne abonată la feed, messages și mention, câmpurile pe care easyCoexistence le transmite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la