Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Facebook-sivun webhook-kentät: täysi luettelo

Metan Facebook-sivun webhookien viitteessä on 64 tilauskenttää: feed postauksille, kommenteille ja reaktioille, mention sivun maininnoille, Messenger-kentät kuten messages, message_echoes, messaging_postbacks ja message_reads sekä profiilikentät kuten name, picture, hours ja website. Jokainen vaatii luvan pages_manage_metadata, ja sovellus saa kentän vasta, kun se on tilattu sekä sovelluksen tasolla että sivulta subscribed_apps-rajapinnan kautta.

easyCoexistence tilaa jokaisen yhdistämäsi sivun feed-, messages- ja mention-kenttiin ja välittää nämä tapahtumat HTTPS-päätepisteeseesi niiden saapuessa, allekirjoitettuna X-EC-Signature-otsikolla.

64

Metan Facebook-sivun webhookien viitteessä dokumentoidut tilauskentät feedistä ja maininnoista Messenger- ja profiilikenttiin.

pages_manage_metadata

Lupa, jonka sivun ylläpitäjä, jolla on MODERATE-oikeudet, myöntää ennen kuin sivun webhookit saavuttavat sovelluksen.

message_echoes

Erillinen Messenger-kenttä sivun lähettämille viesteille, saatavilla vain Messenger-keskusteluissa.

ADVERTISE

Sivun tehtävä, joka vaaditaan leadgen-tilaukseen: leads_retrieval, ads_management, pages_read_engagement ja pages_manage_metadata.

Both levels

Vain kentät, jotka on tilattu sekä sivulla että sovelluksen tasolla, tuottavat webhookeja.

Miten Facebook-sivun webhook-kentät on jäsennelty?

Meta dokumentoi ne yhdellä viitesivulla sivu-objektille, ja ne jakautuvat kolmeen ryhmään: toiminta sivulla ja sen ympärillä, Messenger-keskustelut sekä sivun omien tietojen muokkaukset. Feed-, maininta- ja profiilimuutokset saapuvat entry.changes-kohtaan, jossa kukin nimeää kentän, tai changed_fields-kenttänä, kun Include Values on pois päältä. Messenger-tapahtumat saapuvat entry.messaging-kohtaan tai entry.standby-kohtaan sovellukselle, joka ei omista keskustelua.

Mitkä kentät kertovat toiminnasta sivulla?

12 kenttää kattaa sisällön ja toiminnan eikä keskusteluja. Uusi kommentti saapuu esimerkiksi feed-kenttään muutoksena, jossa item on comment ja verb on add, reaktioiden, jakojen ja sivun omien julkaisujen rinnalla. Mitä kukin toimittaa, Metan viitteessä:

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

Mitkä kentät kuljettavat Messenger-tapahtumia?

Messenger-kenttiä on eniten, ja Metan Messenger-webhook-ohje kertoo, mitä kukin kenttä lähettää. Nämä 13 kattavat sivun keskustelut. Standby, joka kuljettaa viestit sovellukselle, joka ei omista keskustelua, on dokumentoitu tuossa ohjeessa eikä sivun viitteessä:

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

Mitkä muut Messenger-kentät on olemassa?

Kymmenen lisää palvelee tiettyjä tuotteita puheluista kaupankäyntiin ja eheysraportointiin:

  • send_cart: viesti, jossa on ostoskori- tai tilaustietoja; message_context: Metan mallien viestistä tekemät havainnot, joissa on tapahtuman nimi ja pistemäärä.
  • calls, call_settings_update ja call_permission_reply: Messenger-äänipuhelut, sivun puhelusetusten muutokset sekä henkilön vastaus lupapyyntöön soittaa.
  • messaging_customer_information: tiedot, jotka henkilö syötti asiakastietonäkymään; messaging_in_thread_lead_form_submit: keskustelun sisällä lähetetty liidilomake.
  • message_template_status_update: hyötyviestipohjan tarkistuksen tila muuttui.
  • business_integrity ja messaging_integrity: eheyspäivitykset, joissa business_integrity-kentässä ovat rikkomukset, rajoitukset ja toimintatapahtumat.

Mitkä kentät kertovat sivun profiilin muutoksista?

29 kenttää kertoo sivun omien tietojen muokkauksista, yksi kenttä kutakin tietoa kohden, ja kukin saapuu muutoksena, joka nimeää sen:

  • Identiteetti: name, picture, category, joka pitää sisällään enintään kolme kategoriaa, ja description, eli Story Description.
  • Yrityksen tiedot: company_overview, mission, founded, products, general_info, general_manager, members, awards ja affiliation.
  • Yhteystiedot ja paikka: email, phone, website, location, hours, current_location, hometown, parking ja public_transit.
  • Tilan tiedot: price_range, payment_options, attire ja culinary_team.
  • Henkilökohtaiset: birthday, personal_info ja personal_interests.

Mitä lupaa kukin kenttä vaatii?

pages_manage_metadata kaikkiin niistä, jonka myöntää sivun ylläpitäjä MODERATE-oikeuksin, ja joihinkin lisäksi muita. Sivu tilataan subscribed_apps-rajapinnan kautta, ja Metan ohjeet määrittävät tokenin ja luvat kullekin kenttätyypille. Jotta sovellus saisi tapahtumia sovelluksen omien roolien ulkopuolisista henkilöistä, luvat vaativat myös Advanced Accessin:

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

Mitä kenttiä easyCoexistence tilaa?

Kolme: feed, messages ja mention. Kun sivu yhdistetään, easyCoexistence lähettää POST /{page-id}/subscribed_apps -pyynnön näillä kentillä ja sivun tokenilla, ja välittää sitten jokaisen kyseisen sivun entryn määrittämääsi päätepisteeseen, allekirjoitettuna X-EC-Signature-otsikolla. Kommenttisäännöt ja automaatiot toimivat uusista kommenteista feed-kentässä ja viesteistä, ja maininnat välitetään sellaisenaan. Muuta kenttää ei tilata, joten kaikuja, postback-tapahtumia, kuittauksia, luovutuksia, standby-tapahtumia ja profiilimuutoksia ei välitetä.

Yleiset virheet

  • Sivun tilaaminen kenttään, jota sovellus ei ole tilannut. Meta toimittaa vain kentät, jotka on tilattu sekä sivulla että sovelluksen tasolla.
  • Messenger-tapahtumien jäsentäminen muutoksiksi. Ne saapuvat entry.messaging-kohtaan, yksi messaging-objekti per entry, eikä entry.changes-kohtaan.
  • Sivun omien vastausten odottaminen viesteistä. Sivun lähettämät viestit saapuvat message_echoes-kenttään, joka on erillinen kenttä.
  • Feed-kentän luottaminen tykkäyksiin suurella sivulla. Meta lähettää tykkäysilmoituksia vain sivuille, joilla on alle 10 000 tykkäystä.
Näin teet tämän EasyCoexistencen avulla

Kommenttisäännöt ja automaatiot toimivat uusista kommenteista ja viesteistä. Hinta alkaen US$ 9 yhteydeltä kuukaudessa, laskien US$ 0,75:een yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Sisältääkö feed-kenttä mainosten kommentit?

Kyllä. Meta ei lähetä mitään itse mainospostauksista, mutta niiden kommentit saapuvat feed-kenttään.

Mitä Include Values -asetus muuttaa?

Kun se on päällä, muutos sisältää uudet arvot changes-kentässä. Kun se on pois päältä, Meta lähettää vain muuttuneiden kenttien nimet changed_fields-kentässä.

Miten näen, mihin kenttiin sivu on tilattu?

GET /{page-id}/subscribed_apps sivun tokenilla listaa sivulle asennetut sovellukset ja jokaiselle niistä subscribed_fields-kentän.

Välittääkö easyCoexistence sivun profiilimuutokset?

Ei. easyCoexistenceen yhdistetyt sivut on tilattu vain feed-, messages- ja mention-kenttiin, joten name, picture ja muut profiilikentät eivät välity.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu