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.
Metan Facebook-sivun webhookien viitteessä dokumentoidut tilauskentät feedistä ja maininnoista Messenger- ja profiilikenttiin.
Lupa, jonka sivun ylläpitäjä, jolla on MODERATE-oikeudet, myöntää ennen kuin sivun webhookit saavuttavat sovelluksen.
Erillinen Messenger-kenttä sivun lähettämille viesteille, saatavilla vain Messenger-keskusteluissa.
Sivun tehtävä, joka vaaditaan leadgen-tilaukseen: leads_retrieval, ads_management, pages_read_engagement ja pages_manage_metadata.
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ä:
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ä:
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_updatejacall_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_integrityjamessaging_integrity: eheyspäivitykset, joissabusiness_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 japublic_transit. - Tilan tiedot:
price_range,payment_options, attire jaculinary_team. - Henkilökohtaiset: birthday,
personal_infojapersonal_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:
| 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 |
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ä.
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