Medan webhook Halaman Facebook: senarai lengkap
Rujukan webhook Halaman Meta mendokumenkan 64 medan langganan: feed untuk siaran, komen dan reaksi, mention untuk sebutan kepada Halaman, medan Messenger seperti messages, message_echoes, messaging_postbacks dan message_reads, serta medan profil seperti name, picture, hours dan website. Setiap medan memerlukan pages_manage_metadata, dan aplikasi hanya menerima medan apabila medan itu dilanggan pada peringkat aplikasi dan oleh Halaman melalui subscribed_apps.
easyCoexistence melanggan setiap Halaman yang anda sambungkan kepada feed, messages dan mention, dan meneruskan peristiwa tersebut ke endpoint HTTPS anda apabila tiba, ditandatangani dengan X-EC-Signature, manakala peraturan komen dan automasi bertindak ke atas komen dan mesej baharu.
Medan langganan yang didokumenkan dalam rujukan webhook Halaman Meta, dari feed dan mention hingga medan Messenger dan profil.
Kebenaran yang mesti diberikan oleh pentadbir Halaman dengan keistimewaan MODERATE sebelum webhook Halaman sampai ke aplikasi.
Medan Messenger berasingan untuk mesej yang dihantar oleh Halaman, hanya tersedia bagi perbualan Messenger.
Tugasan Halaman yang diperlukan untuk melanggan leadgen, dengan leads_retrieval, ads_management, pages_read_engagement dan pages_manage_metadata.
Hanya medan yang dilanggan pada peringkat Halaman dan aplikasi menghasilkan webhook.
Bagaimana medan webhook Halaman disusun?
Meta mendokumenkannya pada satu rujukan untuk objek halaman, dan ia terbahagi kepada tiga keluarga: aktiviti pada dan sekitar Halaman, perbualan Messenger, dan suntingan kepada butiran Halaman itu sendiri. Medan feed, mention dan perubahan profil tiba dalam entry.changes, setiap satu menamakan medannya, atau sebagai changed_fields apabila aplikasi mematikan Include Values; peristiwa Messenger tiba dalam entry.messaging, atau dalam entry.standby bagi aplikasi yang tidak memiliki benang itu.
Medan manakah melaporkan aktiviti pada Halaman?
Dua belas medan meliputi kandungan dan aktiviti, bukan perbualan. Komen baharu, sebagai contoh, tiba pada feed sebagai perubahan dengan item ditetapkan kepada comment dan verb ditetapkan kepada add, bersama reaksi, perkongsian dan siaran Halaman itu sendiri. Apa yang disampaikan setiap satu, dalam rujukan Meta:
Medan manakah membawa peristiwa Messenger?
Messenger mempunyai senarai terpanjang, dan panduan webhook Messenger Meta menerangkan apa yang dihantar oleh setiap medan. Tiga belas medan ini meliputi perbualan Halaman, manakala standby, yang membawa mesej kepada aplikasi yang tidak memiliki benang itu, didokumenkan dalam panduan tersebut dan bukan dalam rujukan Halaman:
Apakah medan Messenger yang lain?
Sepuluh lagi berkhidmat untuk produk tertentu, daripada panggilan hingga perdagangan dan pelaporan integriti:
send_cart: mesej yang membawa maklumat troli atau pesanan;message_context: pengesanan yang dibuat oleh model Meta pada sesuatu mesej, dengan nama peristiwa dan skor.- calls,
call_settings_updatedancall_permission_reply: panggilan suara Messenger, perubahan kepada tetapan panggilan Halaman, dan jawapan seseorang kepada permintaan kebenaran untuk membuat panggilan. messaging_customer_information: maklumat yang dimasukkan seseorang pada skrin maklumat pelanggan;messaging_in_thread_lead_form_submit: borang prospek yang dihantar di dalam perbualan.message_template_status_update: status semakan template mesej utiliti telah berubah.business_integritydanmessaging_integrity: kemas kini integriti, dengan pelanggaran, sekatan dan peristiwa tindakan dalambusiness_integrity.
Medan manakah melaporkan perubahan kepada profil Halaman?
Dua puluh sembilan medan melaporkan suntingan kepada butiran Halaman itu sendiri, satu medan bagi setiap butiran, setiap satu tiba sebagai perubahan yang menamakannya:
- Identiti: name, picture, category, yang memuatkan sehingga tiga kategori, dan description, iaitu Story Description.
- Butiran perniagaan:
company_overview, mission, founded, products,general_info,general_manager, members, awards dan affiliation. - Hubungan dan tempat: email, phone, website, location, hours,
current_location, hometown, parking danpublic_transit. - Premis:
price_range,payment_options, attire danculinary_team. - Peribadi: birthday,
personal_infodanpersonal_interests.
Apakah kebenaran bagi setiap medan?
pages_manage_metadata untuk mana-mana daripadanya, diberikan oleh pentadbir Halaman dengan keistimewaan MODERATE, dan lebih lagi bagi sesetengahnya. Halaman dilanggan melalui subscribed_apps, dan panduan Meta menetapkan token serta kebenaran bagi setiap jenis medan; untuk menerima peristiwa tentang orang di luar peranan aplikasi, kebenaran itu juga memerlukan 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 |
Medan manakah yang dilanggan oleh easyCoexistence?
Tiga: feed, messages dan mention. Apabila Halaman disambungkan, easyCoexistence menghantar POST /{page-id}/subscribed_apps dengan medan tersebut dan token Halaman, kemudian meneruskan setiap entri bagi Halaman itu ke endpoint yang anda tetapkan, ditandatangani dengan X-EC-Signature. Peraturan komen dan automasi bertindak ke atas komen baharu daripada feed dan ke atas mesej, dan sebutan diteruskan sebagaimana adanya. Tiada medan lain dilanggan, jadi gema, postback, resit, serah tugas, standby dan perubahan profil tidak diteruskan.
Kesilapan biasa
- Melanggan Halaman kepada medan yang belum dilanggan oleh aplikasi. Meta hanya menghantar medan yang dilanggan pada peringkat Halaman dan aplikasi.
- Menghurai peristiwa Messenger sebagai perubahan. Ia tiba dalam entry.messaging, dengan satu objek messaging bagi setiap entri, bukan dalam entry.changes.
- Mengharapkan balasan Halaman sendiri pada mesej. Mesej yang dihantar oleh Halaman tiba pada message_echoes, medan yang berasingan.
- Bergantung pada feed untuk suka pada Halaman besar. Meta hanya menghantar pemberitahuan suka bagi Halaman dengan kurang daripada 10,000 suka.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah medan feed termasuk komen pada iklan?
Ya. Meta tidak menghantar apa-apa untuk siaran iklan itu sendiri, tetapi komen pada siaran tersebut tiba pada feed.
Apakah yang diubah oleh tetapan Include Values?
Apabila dihidupkan, perubahan membawa nilai baharu dalam changes. Apabila dimatikan, Meta hanya menghantar nama medan yang berubah, dalam changed_fields.
Bagaimana saya melihat medan yang dilanggan oleh Halaman?
GET /{page-id}/subscribed_apps dengan token Halaman menyenaraikan aplikasi yang dipasang oleh Halaman dan, bagi setiap satu, subscribed_fields-nya.
Adakah easyCoexistence meneruskan perubahan profil Halaman?
Tidak. Halaman yang disambungkan kepada easyCoexistence hanya dilanggan kepada feed, messages dan mention, jadi nama, gambar dan medan profil lain tidak diteruskan.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada