Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Polja webhooka za Facebook Page: kompletna lista

Metina referenca za Page webhookove dokumentuje 64 polja pretplate: feed za objave, komentare i reakcije, mention za pominjanja stranice, Messenger polja poput messages, message_echoes, messaging_postbacks i message_reads, te polja profila poput name, picture, hours i website. Svako zahteva dozvolu pages_manage_metadata, a aplikacija dobija polje tek kada je pretplaćena i na nivou aplikacije i preko stranice, putem subscribed_apps.

easyCoexistence pretplaćuje svaku stranicu koju povežete na feed, messages i mention i prosleđuje te događaje na vaš HTTPS endpoint čim stignu, potpisane sa X-EC-Signature, dok pravila za komentare i automatizacije deluju na nove komentare i poruke.

64

Polja pretplate dokumentovana u Metinoj referenci za Page webhookove, od feed i mention do Messenger i polja profila.

pages_manage_metadata

Dozvolu koju administrator stranice sa privilegijama MODERATE mora da odobri pre nego što Page webhookovi stignu do aplikacije.

message_echoes

Zasebno Messenger polje za poruke koje stranica šalje, dostupno samo za Messenger razgovore.

ADVERTISE

Zadatak stranice potreban za pretplatu na leadgen, uz leads_retrieval, ads_management, pages_read_engagement i pages_manage_metadata.

Both levels

Webhookove proizvode samo polja pretplaćena i na nivou stranice i na nivou aplikacije.

Kako su polja Page webhooka organizovana?

Meta ih dokumentuje na jednoj referentnoj stranici za objekat stranice, a dele se u tri porodice: aktivnost na stranici i oko nje, Messenger razgovori i izmene same stranice. Polja feed, mention i profila stižu u entry.changes, gde svako navodi svoje polje, ili kao changed_fields kada je aplikacija isključila „Include Values“. Messenger događaji stižu u entry.messaging, ili u entry.standby za aplikaciju koja ne poseduje nit.

Koja polja prijavljuju aktivnost na stranici?

Dvanaest polja pokriva sadržaj i aktivnost, a ne razgovore. Novi komentar, na primer, stiže na feed kao promena sa item postavljenim na comment i verb postavljenim na add, zajedno sa reakcijama, deljenjima i sopstvenim objavama stranice. Šta svako isporučuje, prema Metinoj referenci:

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

Koja polja nose Messenger događaje?

Messenger ima najduži spisak, a Metin vodič za Messenger webhookove kaže šta svako polje šalje. Ovih trinaest pokrivaju razgovore stranice; standby, koji nosi poruke ka aplikaciji koja ne poseduje nit, dokumentovan je u tom vodiču, a ne u referenci za stranicu:

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

Koja su ostala Messenger polja?

Još deset služi određenim proizvodima, od pozivanja do trgovine i izveštavanja o integritetu:

  • send_cart: poruka koja nosi informacije o korpi ili porudžbini; message_context: detekcije koje Metini modeli naprave u poruci, sa nazivom događaja i ocenom.
  • calls, call_settings_update i call_permission_reply: Messenger glasovni pozivi, izmene podešavanja poziva stranice i odgovor osobe na zahtev za dozvolu da se pozove.
  • messaging_customer_information: ono što je osoba unela na ekranu sa informacijama o kupcu; messaging_in_thread_lead_form_submit: obrazac za lead poslat unutar razgovora.
  • message_template_status_update: promenjen je status pregleda uslužnog šablona poruke.
  • business_integrity i messaging_integrity: ažuriranja integriteta, sa događajima kršenja, ograničenja i radnji u business_integrity.

Koja polja prijavljuju izmene profila stranice?

Dvadeset devet polja prijavljuje izmene sopstvenih podataka stranice, po jedno polje za svaki podatak, a svako stiže kao promena koja ga navodi:

  • Identitet: name, picture, category, koja drži do tri kategorije, i description, Story Description.
  • Poslovni podaci: company_overview, mission, founded, products, general_info, general_manager, members, awards i affiliation.
  • Kontakt i mesto: email, phone, website, location, hours, current_location, hometown, parking i public_transit.
  • Lokal: price_range, payment_options, attire i culinary_team.
  • Lično: birthday, personal_info i personal_interests.

Koju dozvolu zahteva svako polje?

pages_manage_metadata za bilo koje od njih, koju odobrava administrator stranice sa privilegijama MODERATE, a za neka i više. Stranica se pretplaćuje preko subscribed_apps, a Metini vodiči određuju token i dozvole po vrsti polja; da bi aplikacija primala događaje o osobama van sopstvenih uloga, dozvole takođe zahtevaju 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

Na koja polja se easyCoexistence pretplaćuje?

Na tri: feed, messages i mention. Kada se stranica poveže, easyCoexistence šalje POST /{page-id}/subscribed_apps sa tim poljima i tokenom stranice, zatim prosleđuje svaki entry za tu stranicu na krajnju tačku koju postavite, potpisan sa X-EC-Signature. Pravila za komentare i automatizacije deluju na nove komentare iz feed-a i na poruke, a pominjanja se prosleđuju kakva jesu. Nijedno drugo polje nije pretplaćeno, pa se message_echoes, messaging_postbacks, potvrde, primopredaje, standby i izmene profila ne prosleđuju.

Česte greške

  • Pretplaćivanje stranice na polje koje aplikacija nije pretplatila. Meta isporučuje samo polja pretplaćena i na nivou stranice i na nivou aplikacije.
  • Parsiranje Messenger događaja kao promena. Oni stižu u entry.messaging, sa jednim objektom poruke po entry-ju, a ne u entry.changes.
  • Očekivanje odgovora same stranice na poruke. Poruke koje stranica šalje stižu na message_echoes, zasebno polje.
  • Oslanjanje na feed za lajkove velike stranice. Meta šalje obaveštenja o lajkovima samo za stranice sa manje od 10.000 lajkova.
Ovo radite uz EasyCoexistence

US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Da li polje feed obuhvata komentare na oglase?

Da. Meta ne šalje ništa za same oglašene objave, ali komentari na njih stižu na feed.

Šta menja podešavanje Include Values?

Kada je uključeno, promena nosi nove vrednosti u changes. Kada je isključeno, Meta šalje samo nazive izmenjenih polja, u changed_fields.

Kako da vidim na koja polja je stranica pretplaćena?

GET /{page-id}/subscribed_apps sa tokenom stranice navodi aplikacije koje je stranica instalirala i, za svaku, njena subscribed_fields.

Da li easyCoexistence prosleđuje promene profila stranice?

Ne. Stranice povezane sa easyCoexistence pretplaćene su samo na feed, messages i mention, pa se name, picture i ostala polja profila ne prosleđuju.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na