Berlangganan Halaman Facebook ke webhook: edge subscribed_apps
Halaman Facebook berlangganan ke webhook aplikasi dengan POST /{page-id}/subscribed_apps, mengirim subscribed_fields seperti feed,messages dan token akses Halaman dari seseorang dengan tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list telah diberikan. Meta hanya mengirim event sebuah field jika aplikasi juga berlangganan ke field itu; GET menampilkan langganan dan DELETE menghapusnya.
easyCoexistence berlangganan setiap Halaman yang Anda hubungkan ke feed, messages, dan mention melalui subscribed_apps, membatalkan langganannya saat Anda menghapusnya, dan meneruskan event Halaman ke endpoint HTTPS Anda yang ditandatangani dengan rahasia untuk Halaman tersebut, dari satu konektor MCP atau Partner API.
Hanya field yang dilanggani di tingkat Halaman dan aplikasi yang menghasilkan webhook; Halaman dapat mencantumkan lebih banyak field daripada aplikasi.
Tugas Halaman, yang salah satunya harus dimiliki orang di balik token agar dapat membaca atau membuat langganan.
Dikembalikan bersama success ketika aplikasi menghapus langganan webhook-nya dari Halaman dengan DELETE.
Yang diperlukan /{app-id}/subscriptions untuk membaca, membuat, atau menghapus langganan tingkat aplikasi.
Pengiriman Messenger yang gagal sebelum Meta membatalkan langganan aplikasi dari Halaman hingga aplikasi berlangganan kembali.
Apa yang dilakukan edge subscribed_apps?
Edge ini memasang aplikasi di Halaman dan menentukan field webhook Halaman mana yang diterima aplikasi. Meta hanya mengirim notifikasi selama Halaman memiliki aplikasi terpasang dan belum menonaktifkan platform aplikasi di pengaturannya, dan hanya untuk field yang berlangganan di kedua tingkat: tingkat Halaman, melalui edge ini, dan tingkat aplikasi, yang diatur di App Dashboard atau lewat /{app-id}/subscriptions. Halaman dapat berlangganan lebih banyak field daripada aplikasi.
Bagaimana cara berlangganan sebuah Halaman?
Dengan POST ke edge, subscribed_fields berisi daftar field dipisah koma, dan token akses Halaman. Panggilan yang berhasil mengembalikan success true, dan panggilan yang mencantumkan messages juga memerlukan pages_messaging pada token:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Token, tugas, dan izin apa yang diperlukan?
Token akses Halaman, yang mengikat panggilan ke satu Halaman, dari seseorang yang dapat bertindak atas Halaman tersebut. Referensi dan panduan Meta menetapkan persyaratan berikut:
- Field apa pun: seseorang dengan tugas
CREATE_CONTENT, MANAGE, atau MODERATE, sertapages_manage_metadatadanpages_show_list. - messages dan field Messenger lainnya:
pages_messagingjuga, pada token dari seseorang yang dapat menjalankan tugas MESSAGING. - leadgen: tugas ADVERTISE, dengan
leads_retrieval,pages_read_engagement, danads_management. - Membaca langganan dengan GET memerlukan tugas dan izin yang sama dengan membuatnya.
Tingkat akses apa yang diperlukan field?
Advanced Access, untuk Halaman dan orang di luar peran aplikasi itu sendiri. Dengan Standard Access, notifikasi Messenger hanya datang dari orang yang memiliki peran di aplikasi, seperti admin, developer, dan tester; Advanced Access, yang diberikan per izin melalui App Review dan memerlukan Verifikasi Bisnis, membukanya untuk pelanggan aplikasi. Panduan Messenger Meta juga mencantumkan publikasi aplikasi sebagai prasyarat.
Apa itu langganan tingkat aplikasi?
Bagian lainnya: field yang didengarkan aplikasi itu sendiri, bersama callback URL-nya. Diatur di App Dashboard atau dengan POST /{app-id}/subscriptions dan token akses aplikasi, dengan object=page, callback_url, fields, include_values, dan verify_token, yang memicu permintaan verifikasi Meta. GET pada edge yang sama menampilkan callback_url, fields, dan apakah langganan setiap objek aktif; POST baru mengubah field tanpa menimpa yang lain, dan DELETE menghapus semuanya atau field yang disebutkan.
Bagaimana cara memeriksa apa yang dilanggani sebuah Halaman?
Dengan GET pada edge yang sama dan token Halaman. Array data mencantumkan setiap aplikasi yang dipasang Halaman, dengan nama, ID, dan subscribed_fields-nya, dan kembali kosong ketika Halaman tidak memiliki aplikasi terpasang:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}Bagaimana cara menghapus langganan?
Dengan DELETE /{page-id}/subscribed_apps, yang memisahkan aplikasi dari Halaman; aplikasi dapat menghapus langganannya sendiri dengan token akses aplikasi, dan respons memuat success dan messaging_success. Meta juga menghapusnya sendiri: setelah satu jam pengiriman Messenger yang gagal, aplikasi dibatalkan langganannya dari Halaman dan harus berlangganan kembali setelah endpoint-nya berfungsi.
Apa yang dilakukan easyCoexistence saat terhubung?
Berlangganan untuk setiap Halaman yang dipilih orang tersebut, tepat setelah menyimpan token Halaman itu: POST /{page-id}/subscribed_apps dengan subscribed_fields diatur ke feed,messages,mention. Jika Meta menolak, Halaman tetap terhubung dan list_social_accounts menampilkan alasannya di last_error. Menghapus Halaman mengirim DELETE /{page-id}/subscribed_apps sebelum token dibuang, dan tidak ada alat yang menjangkau jalur subscribed_apps atau token, sehingga langganan hanya dikelola oleh easyCoexistence.
Kesalahan umum
- Memanggil edge dengan token akses pengguna. Edge ini memerlukan token akses Halaman dari Halaman yang akan dilanggani.
- Berlangganan Halaman tetapi tidak aplikasinya. Sebuah field hanya sampai ke callback jika langganan aplikasi itu juga mencakupnya.
- Lupa menyertakan pages_messaging saat berlangganan messages. Meta mewajibkannya, pada token dari seseorang yang dapat menjalankan tugas MESSAGING.
- Lupa berlangganan kembali setelah gangguan. Satu jam pengiriman Messenger yang gagal membatalkan langganan aplikasi, dan event berhenti hingga POST dikirim ulang.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya perlu berlangganan setiap Halaman secara terpisah?
Ya. subscribed_apps bekerja per Halaman, dengan token Halaman itu sendiri, sedangkan langganan tingkat aplikasi untuk objek page berlaku bagi Halaman yang memasang aplikasi.
Mengapa subscribed_apps mengembalikan kesalahan 200?
Meta mencantumkan 200 sebagai kesalahan izin untuk edge ini. Periksa bahwa token memuat pages_manage_metadata dan pages_show_list serta berasal dari seseorang dengan CREATE_CONTENT, MANAGE, atau MODERATE.
Bisakah sebuah Halaman dilanggani dari Graph API Explorer?
Bisa. Panduan Meta memilih aplikasi, mendapatkan token pengguna dengan pages_manage_metadata, menukarnya dengan token Halaman, lalu mengirim POST ke {page-id}/subscribed_apps.
Bisakah saya menambahkan field webhook ke Halaman yang terhubung ke easyCoexistence?
Tidak melalui alatnya: tidak satu pun menjangkau jalur subscribed_apps, dan Halaman tetap berlangganan feed, messages, dan mention, yaitu field yang diteruskan easyCoexistence.
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