Log masukMulakan percubaan percuma
easyCoexistence API rasmi

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.

64

Medan langganan yang didokumenkan dalam rujukan webhook Halaman Meta, dari feed dan mention hingga medan Messenger dan profil.

pages_manage_metadata

Kebenaran yang mesti diberikan oleh pentadbir Halaman dengan keistimewaan MODERATE sebelum webhook Halaman sampai ke aplikasi.

message_echoes

Medan Messenger berasingan untuk mesej yang dihantar oleh Halaman, hanya tersedia bagi perbualan Messenger.

ADVERTISE

Tugasan Halaman yang diperlukan untuk melanggan leadgen, dengan leads_retrieval, ads_management, pages_read_engagement dan pages_manage_metadata.

Both levels

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:

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

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:

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

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_update dan call_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_integrity dan messaging_integrity: kemas kini integriti, dengan pelanggaran, sekatan dan peristiwa tindakan dalam business_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 dan public_transit.
  • Premis: price_range, payment_options, attire dan culinary_team.
  • Peribadi: birthday, personal_info dan personal_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:

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

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.
Menggunakan EasyCoexistence untuk ini

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