Câmpurile webhook ale Paginii Facebook: lista completă
Referința Meta pentru webhook-urile Paginii documentează 64 de câmpuri de abonare: feed pentru postări, comentarii și reacții, mention pentru mențiunile Paginii, câmpuri Messenger precum messages, message_echoes, messaging_postbacks și message_reads, și câmpuri de profil precum name, picture, hours și website. Fiecare necesită pages_manage_metadata, iar o aplicație primește un câmp doar dacă a fost abonată atât la nivelul aplicației, cât și de către Pagină, prin subscribed_apps.
easyCoexistence abonează fiecare Pagină conectată la feed, messages și mention și trimite aceste evenimente către endpoint-ul HTTPS pe care îl setați, pe măsură ce sosesc, semnate cu X-EC-Signature.
Câmpurile de abonare documentate în referința Meta pentru webhook-urile Paginii, de la feed și mention până la câmpurile Messenger și de profil.
Permisiunea pe care un administrator al Paginii cu privilegii MODERATE trebuie să o acorde înainte ca webhook-urile Paginii să ajungă la o aplicație.
Un câmp Messenger separat pentru mesajele trimise de Pagină, disponibil doar pentru conversațiile Messenger.
Sarcina Paginii necesară pentru abonarea la leadgen, cu leads_retrieval, ads_management, pages_read_engagement și pages_manage_metadata.
Doar câmpurile abonate atât la nivelul Paginii, cât și la cel al aplicației produc webhook-uri.
Cum sunt organizate câmpurile webhook ale Paginii?
Meta le documentează pe o singură pagină de referință pentru obiectul Page, iar ele se împart în trei familii: activitatea de pe Pagină și din jurul ei, conversațiile Messenger și modificările detaliilor propriei Pagini. Modificările de la feed, mention și profil ajung în entry.changes, fiecare cu numele câmpului, sau ca changed_fields atunci când aplicația a dezactivat opțiunea Include Values. Evenimentele Messenger ajung în entry.messaging sau în entry.standby, pentru o aplicație care nu deține conversația.
Ce câmpuri raportează activitatea de pe Pagină?
Douăsprezece câmpuri acoperă conținutul și activitatea, nu conversațiile. Un comentariu nou, de exemplu, ajunge pe feed ca o modificare cu item setat la comment și verb setat la add, alături de reacții, distribuiri și postările proprii ale Paginii. Ce livrează fiecare, în referința Meta:
Ce câmpuri transmit evenimente Messenger?
Messenger are cea mai lungă listă, iar ghidul Meta pentru webhook-urile Messenger spune ce trimite fiecare câmp. Aceste treisprezece acoperă conversațiile unei Pagini. Standby, care transmite mesajele către o aplicație care nu deține conversația, este documentat în acel ghid, nu în referința Paginii:
Ce alte câmpuri Messenger există?
Alte zece servesc anumite produse, de la apeluri până la raportarea comerțului și a integrității:
send_cart: un mesaj care conține informații despre coș sau comandă;message_context: detecții pe care modelele Meta le fac asupra unui mesaj, cu un nume de eveniment și un scor.- calls,
call_settings_updateșicall_permission_reply: apeluri vocale Messenger, modificări ale setărilor de apel ale Paginii și răspunsul unei persoane la o cerere de permisiune pentru apel. messaging_customer_information: ce a introdus o persoană pe un ecran cu informații despre client;messaging_in_thread_lead_form_submit: un formular de lead trimis în interiorul conversației.message_template_status_update: s-a schimbat statusul de revizuire al unui șablon de mesaj utilitar.business_integrityșimessaging_integrity: actualizări de integritate, cu încălcări, restricții și evenimente de acțiune înbusiness_integrity.
Ce câmpuri raportează modificările profilului Paginii?
Douăzeci și nouă de câmpuri raportează modificările detaliilor propriei Pagini, câte un câmp pentru fiecare detaliu, fiecare sosind ca o modificare care îl numește:
- Identitate: name, picture, category, care cuprinde până la trei categorii, și description, adică Story Description.
- Detalii de business:
company_overview, mission, founded, products,general_info,general_manager, members, awards și affiliation. - Contact și loc: email, phone, website, location, hours,
current_location, hometown, parking șipublic_transit. - Localul:
price_range,payment_options, attire șiculinary_team. - Personal: birthday,
personal_infoșipersonal_interests.
Ce permisiune necesită fiecare câmp?
pages_manage_metadata pentru oricare dintre ele, acordată de un administrator al Paginii cu privilegii MODERATE, iar pentru unele și mai multe. Pagina este abonată prin subscribed_apps, iar ghidurile Meta stabilesc token-ul și permisiunile pentru fiecare tip de câmp. Pentru a primi evenimente despre persoane din afara rolurilor aplicației, permisiunile necesită și Advanced Access:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
La ce câmpuri se abonează easyCoexistence?
La trei: feed, messages și mention. Când o Pagină se conectează, easyCoexistence trimite POST /{page-id}/subscribed_apps cu aceste câmpuri și token-ul Paginii, apoi redirecționează fiecare intrare a acelei Pagini către endpoint-ul pe care îl setați, semnată cu X-EC-Signature. Regulile pentru comentarii și automatizările acționează asupra comentariilor noi de la feed și asupra mesajelor, iar mențiunile sunt redirecționate așa cum sunt. Niciun alt câmp nu este abonat, așadar ecourile, postback-urile, confirmările de livrare, transferurile, standby și modificările de profil nu sunt redirecționate.
Greșeli frecvente
- Abonarea Paginii la un câmp pe care aplicația nu l-a abonat. Meta livrează doar câmpurile abonate atât la nivelul Paginii, cât și la cel al aplicației.
- Interpretarea evenimentelor Messenger ca modificări. Ele sosesc în entry.messaging, cu un obiect messaging pe intrare, nu în entry.changes.
- Așteptarea răspunsurilor proprii ale Paginii la mesaje. Mesajele trimise de Pagină sosesc pe message_echoes, un câmp separat.
- Bazarea pe feed pentru aprecierile unei Pagini mari. Meta trimite notificări de apreciere doar pentru Paginile cu mai puțin de 10.000 de aprecieri.
Regulile pentru comentarii și automatizările acționează asupra comentariilor și mesajelor noi. Între US$ 9 și US$ 0,75 pe conexiune pe lună, prețul scade pe măsură ce adăugați conexiuni, cu primele 3 zile de probă gratuită.
Întrebări frecvente
Câmpul feed include comentariile de la reclame?
Da. Meta nu trimite nimic pentru postările de reclamă în sine, dar comentariile de pe ele sosesc pe feed.
Ce schimbă setarea Include Values?
Cu ea activată, o modificare conține valorile noi în changes. Cu ea dezactivată, Meta trimite doar numele câmpurilor modificate, în changed_fields.
Cum văd la ce câmpuri este abonată o Pagină?
GET /{page-id}/subscribed_apps cu token-ul Paginii listează aplicațiile instalate de Pagină și, pentru fiecare, câmpurile abonate (subscribed_fields).
easyCoexistence redirecționează modificările profilului Paginii?
Nu. Paginile conectate la easyCoexistence sunt abonate doar la feed, messages și mention, deci name, picture și celelalte câmpuri de profil nu sunt redirecționate.
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