Melanggan Halaman Facebook kepada webhook: edge subscribed_apps
Halaman Facebook dilanggankan kepada webhook aplikasi dengan POST /{page-id}/subscribed_apps, dengan menghantar subscribed_fields seperti feed,messages dan token akses Halaman daripada seseorang yang mempunyai tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list diberikan. Meta hanya menghantar peristiwa bagi medan apabila aplikasi juga melanggannya; GET menyenaraikan langganan dan DELETE memadamkannya.
easyCoexistence melanggan setiap Halaman yang anda sambungkan kepada feed, messages dan mention melalui subscribed_apps, menyahlanggannya apabila anda membuangnya, dan memajukan peristiwa Halaman ke endpoint HTTPS anda yang ditandatangani dengan rahsia khusus bagi Halaman itu, daripada satu penyambung MCP atau Partner API.
Hanya medan yang dilanggan pada kedua-dua peringkat, Halaman dan aplikasi, menghasilkan webhook; sebuah Halaman boleh menyenaraikan lebih banyak medan daripada aplikasi.
Tugas Halaman, salah satunya perlu dimiliki oleh orang di sebalik token untuk membaca atau mencipta langganan.
Dipulangkan bersama success apabila sebuah aplikasi memadam langganan webhooknya daripada Halaman dengan DELETE.
Keperluan /{app-id}/subscriptions untuk membaca, mencipta atau memadam langganan peringkat aplikasi.
Bilangan penghantaran Messenger yang gagal sebelum Meta menyahlanggan aplikasi daripada Halaman sehingga aplikasi melanggan semula.
Apakah fungsi edge subscribed_apps?
Ia memasang aplikasi pada Halaman dan menetapkan medan webhook Halaman mana yang diterima oleh aplikasi. Meta hanya menghantar pemberitahuan semasa Halaman memasang aplikasi dan belum melumpuhkan platform aplikasi dalam tetapannya, dan hanya bagi medan yang dilanggan pada kedua-dua peringkat: Halaman, melalui edge ini, dan aplikasi, yang ditetapkan dalam App Dashboard atau melalui /{app-id}/subscriptions. Sebuah Halaman boleh dilanggan kepada lebih banyak medan daripada aplikasi.
Bagaimana melanggan sebuah Halaman?
Dengan POST ke edge, subscribed_fields yang menyenaraikan medan dipisahkan dengan koma, dan token akses Halaman. Panggilan yang berjaya memulangkan success true, dan panggilan yang menyenaraikan messages juga memerlukan pages_messaging pada token tersebut:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Token, tugas dan kebenaran apa yang diperlukan?
Token akses Halaman, yang mengikat panggilan kepada satu Halaman, daripada seseorang yang boleh bertindak bagi Halaman itu. Rujukan dan panduan Meta menetapkan keperluan ini:
- Mana-mana medan: seseorang yang memiliki tugas
CREATE_CONTENT, MANAGE atau MODERATE, danpages_manage_metadatabersamapages_show_list. - messages dan medan Messenger lain:
pages_messagingjuga, pada token daripada seseorang yang boleh melaksanakan tugas MESSAGING. - leadgen: tugas ADVERTISE, dengan
leads_retrieval,pages_read_engagementdanads_management. - Membaca langganan dengan GET memerlukan tugas dan kebenaran yang sama seperti mencipta langganan itu.
Tahap akses apa yang diperlukan oleh medan?
Akses Lanjutan, bagi Halaman dan orang di luar peranan aplikasi itu sendiri. Dengan Akses Standard, pemberitahuan Messenger hanya datang daripada orang yang mempunyai peranan dalam aplikasi, seperti pentadbir, pembangun dan penguji; Akses Lanjutan, yang diberikan bagi setiap kebenaran melalui App Review dan memerlukan Business Verification, membuka pemberitahuan itu kepada pelanggan aplikasi. Panduan Messenger Meta turut menyenaraikan penerbitan aplikasi sebagai salah satu prasyarat.
Apakah langganan peringkat aplikasi?
Separuh lagi: medan yang didengar oleh aplikasi itu sendiri, bersama URL panggil balik (callback URL)-nya. Ia ditetapkan dalam App Dashboard atau dengan POST /{app-id}/subscriptions dan token akses aplikasi, dengan menghantar object=page, callback_url, fields, include_values dan verify_token, yang mencetuskan permintaan pengesahan Meta. GET pada edge yang sama menunjukkan callback_url, fields dan sama ada langganan itu aktif bagi setiap objek; POST baharu meminda medan tanpa menulis ganti yang lain, dan DELETE memadamkan semuanya atau medan yang dinyatakan.
Bagaimana menyemak apa yang dilanggan oleh sebuah Halaman?
Dengan GET pada edge yang sama dan token Halaman. Tatasusunan data menyenaraikan setiap aplikasi yang dipasang oleh Halaman, dengan namanya, ID dan subscribed_fields, dan dipulangkan kosong apabila Halaman tiada aplikasi dipasang:
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 membuang langganan?
Dengan DELETE /{page-id}/subscribed_apps, yang menyahkaitkan aplikasi daripada Halaman; sesuatu aplikasi boleh membuang langganannya sendiri dengan token akses aplikasi, dan respons memuatkan success dan messaging_success. Meta juga membuangnya sendiri: selepas sejam penghantaran Messenger gagal, aplikasi dinyahlanggan daripada Halaman dan perlu melanggan semula apabila endpointnya berfungsi.
Apa yang dilakukan easyCoexistence semasa sambungan?
Ia melanggan setiap Halaman yang anda pilih, sejurus selepas menyimpan token Halaman itu: POST /{page-id}/subscribed_apps dengan subscribed_fields ditetapkan kepada feed,messages,mention. Jika Meta menolak, Halaman kekal tersambung dan list_social_accounts menunjukkan sebab dalam last_error. Membuang Halaman menghantar DELETE /{page-id}/subscribed_apps sebelum token dibuang, dan tiada alat yang mencapai laluan subscribed_apps atau token, jadi langganan itu diuruskan oleh easyCoexistence sahaja.
Kesilapan biasa
- Memanggil edge dengan token akses pengguna. Ia memerlukan token akses Halaman bagi Halaman yang dilanggan.
- Melanggan Halaman tetapi tidak aplikasi. Sesuatu medan hanya sampai ke panggil balik apabila langganan aplikasi itu turut merangkumi medan tersebut.
- Tidak menyertakan pages_messaging ketika melanggan messages. Meta memerlukannya, pada token daripada seseorang yang boleh melaksanakan tugas MESSAGING.
- Terlupa melanggan semula selepas gangguan. Sejam penghantaran Messenger gagal menyahlanggan aplikasi, dan peristiwa berhenti sehingga POST dihantar semula.
Daripada US$ 9 hingga US$ 0.75 sebulan bagi setiap sambungan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.
Soalan lazim
Adakah saya perlu melanggan setiap Halaman secara berasingan?
Ya. subscribed_apps berfungsi bagi setiap Halaman, dengan token Halaman itu sendiri, manakala langganan peringkat aplikasi bagi objek page terpakai kepada Halaman yang memasang aplikasi.
Mengapa subscribed_apps memulangkan ralat 200?
Meta menyenaraikan 200 sebagai ralat kebenaran bagi edge ini. Semak sama ada token memiliki pages_manage_metadata dan pages_show_list serta datang daripada seseorang yang mempunyai CREATE_CONTENT, MANAGE atau MODERATE.
Bolehkah sebuah Halaman dilanggan dari Graph API Explorer?
Boleh. Panduan Meta memilih aplikasi, mendapatkan token pengguna dengan pages_manage_metadata, menukarnya kepada token Halaman, dan menghantar POST ke {page-id}/subscribed_apps.
Bolehkah saya menambah medan webhook kepada Halaman yang disambungkan ke easyCoexistence?
Tidak melalui alatannya: tiada satu pun yang mencapai laluan subscribed_apps, dan Halaman kekal dilanggan kepada feed, messages dan mention, iaitu medan yang diteruskan oleh easyCoexistence.
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