MasukMulai uji coba gratis
easyCoexistence API resmi

Field webhook Facebook Page: daftar lengkapnya

Dokumen referensi webhook Page dari Meta mencantumkan 64 field langganan: feed untuk postingan, komentar dan reaksi, mention untuk penyebutan Page, field Messenger seperti messages, message_echoes, messaging_postbacks dan message_reads, serta field profil seperti name, picture, hours dan website. Setiap field membutuhkan pages_manage_metadata, dan aplikasi menerima sebuah field setelah field tersebut berlangganan baik di tingkat aplikasi maupun oleh Page melalui subscribed_apps.

easyCoexistence berlangganan setiap Page yang Anda hubungkan ke feed, messages dan mention, lalu meneruskan event tersebut ke endpoint HTTPS Anda saat tiba, ditandatangani dengan X-EC-Signature, sementara aturan komentar dan otomasi bekerja atas komentar dan pesan baru.

64

Field langganan yang didokumentasikan di referensi webhook Page dari Meta, dari feed dan mention hingga field Messenger dan profil.

pages_manage_metadata

Izin yang harus diberikan admin Page dengan hak akses MODERATE sebelum webhook Page sampai ke aplikasi.

message_echoes

Field Messenger terpisah untuk pesan yang dikirim Page, hanya tersedia untuk percakapan Messenger.

ADVERTISE

Tugas Page yang dibutuhkan untuk berlangganan leadgen, dengan leads_retrieval, ads_management, pages_read_engagement dan pages_manage_metadata.

Both levels

Hanya field yang berlangganan di tingkat Page dan aplikasi yang menghasilkan webhook.

Bagaimana field webhook Page diorganisasi?

Meta mendokumentasikannya dalam satu halaman referensi untuk objek page, dan field-field tersebut terbagi dalam tiga keluarga: aktivitas di Page dan sekitarnya, percakapan Messenger, dan perubahan pada detail Page itu sendiri. Perubahan feed, mention dan profil tiba di entry.changes, masing-masing menyebut field-nya, atau sebagai changed_fields ketika aplikasi mematikan Include Values; event Messenger tiba di entry.messaging, atau di entry.standby untuk aplikasi yang tidak memiliki thread tersebut.

Field mana yang melaporkan aktivitas di Page?

Dua belas field mencakup konten dan aktivitas, bukan percakapan. Komentar baru, misalnya, tiba di feed sebagai perubahan dengan item bernilai comment dan verb bernilai add, bersama reaksi, bagikan, dan postingan Page itu sendiri. Yang dikirim masing-masing, menurut referensi 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

Field mana yang membawa event Messenger?

Messenger memiliki daftar terpanjang, dan panduan webhook Messenger dari Meta menjelaskan apa yang dikirim setiap field. Tiga belas ini mencakup percakapan Page; standby, yang membawa pesan ke aplikasi yang tidak memiliki thread tersebut, didokumentasikan di panduan itu dan bukan di referensi Page:

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

Field Messenger lain apa saja?

Sepuluh lainnya melayani produk tertentu, mulai dari panggilan hingga commerce dan pelaporan integritas:

  • send_cart: pesan yang memuat informasi keranjang atau pesanan; message_context: deteksi yang dibuat model Meta pada sebuah pesan, dengan nama event dan skor.
  • calls, call_settings_update dan call_permission_reply: panggilan suara Messenger, perubahan pengaturan panggilan Page, dan jawaban seseorang atas permintaan izin untuk menelepon.
  • messaging_customer_information: data yang diisi seseorang di layar informasi pelanggan; messaging_in_thread_lead_form_submit: formulir lead yang dikirim di dalam percakapan.
  • message_template_status_update: status tinjauan template pesan utilitas telah berubah.
  • business_integrity dan messaging_integrity: pembaruan integritas, dengan event pelanggaran, pembatasan, dan tindakan di business_integrity.

Field mana yang melaporkan perubahan profil Page?

Dua puluh sembilan field melaporkan perubahan pada detail Page itu sendiri, satu field untuk setiap detail, masing-masing tiba sebagai perubahan yang menyebut namanya:

  • Identitas: name, picture, category, yang memuat hingga tiga kategori, dan description, yaitu Story Description.
  • Detail bisnis: company_overview, mission, founded, products, general_info, general_manager, members, awards dan affiliation.
  • Kontak dan lokasi: email, phone, website, location, hours, current_location, hometown, parking dan public_transit.
  • Tempat usaha: price_range, payment_options, attire dan culinary_team.
  • Pribadi: birthday, personal_info dan personal_interests.

Izin apa yang dibutuhkan setiap field?

pages_manage_metadata untuk semuanya, diberikan oleh admin Page dengan hak akses MODERATE, dan lebih untuk beberapa. Page berlangganan melalui subscribed_apps, dan panduan Meta mengatur token dan izin per jenis field; untuk menerima event tentang orang di luar peran aplikasi, izin tersebut 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

Field mana saja yang didaftarkan easyCoexistence?

Tiga: feed, messages dan mention. Ketika sebuah Page terhubung, easyCoexistence mengirim POST /{page-id}/subscribed_apps dengan field tersebut dan token Page, lalu meneruskan setiap entry untuk Page itu ke endpoint yang Anda atur, ditandatangani dengan X-EC-Signature. Aturan komentar dan otomasi bekerja atas komentar baru dari feed dan atas pesan, dan mention diteruskan apa adanya. Tidak ada field lain yang didaftarkan, jadi echo, postback, tanda terima, handover, standby dan perubahan profil tidak diteruskan.

Kesalahan umum

  • Mendaftarkan Page ke field yang belum didaftarkan aplikasi. Meta hanya mengirim field yang didaftarkan di tingkat Page dan aplikasi.
  • Mengurai event Messenger sebagai perubahan. Event tiba di entry.messaging, dengan satu objek messaging per entry, bukan di entry.changes.
  • Berharap balasan Page sendiri muncul di messages. Pesan yang dikirim Page tiba di message_echoes, field terpisah.
  • Mengandalkan feed untuk suka di Page besar. Meta hanya mengirim notifikasi suka untuk Page dengan kurang dari 10,000 suka.
Melakukan ini dengan EasyCoexistence

US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah field feed mencakup komentar pada iklan?

Ya. Meta tidak mengirim apa pun untuk postingan iklan itu sendiri, tetapi komentar pada postingan tersebut tiba di feed.

Apa yang diubah oleh pengaturan Include Values?

Saat aktif, sebuah perubahan memuat nilai baru di changes. Saat nonaktif, Meta hanya mengirim nama field yang berubah, di changed_fields.

Bagaimana cara melihat field apa saja yang didaftarkan ke Page?

GET /{page-id}/subscribed_apps dengan token Page menampilkan aplikasi yang dipasang Page dan, untuk setiap aplikasi, subscribed_fields-nya.

Apakah easyCoexistence meneruskan perubahan profil Page?

Tidak. Page yang terhubung ke easyCoexistence hanya didaftarkan ke feed, messages dan mention, sehingga name, picture dan field profil lainnya tidak diteruskan.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada