Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

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.

64

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.

pages_manage_metadata

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.

message_echoes

Un câmp Messenger separat pentru mesajele trimise de Pagină, disponibil doar pentru conversațiile Messenger.

ADVERTISE

Sarcina Paginii necesară pentru abonarea la leadgen, cu leads_retrieval, ads_management, pages_read_engagement și pages_manage_metadata.

Both levels

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:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

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:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

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 și call_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 și messaging_integrity: actualizări de integritate, cu încălcări, restricții și evenimente de acțiune în business_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 și public_transit.
  • Localul: price_range, payment_options, attire și culinary_team.
  • Personal: birthday, personal_info și personal_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:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

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.
Faceți acest lucru cu EasyCoexistence

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