Webhook suapan Halaman Facebook: peristiwa komen, siaran dan reaksi
Medan suapan dalam webhook Halaman Facebook melaporkan hampir semua perubahan pada suapan Halaman sebaik ia berlaku. Setiap perubahan membawa item, seperti siaran, komen atau reaksi, dan verb, seperti add, edit atau remove, serta ID yang terlibat, pengarang dalam from dan teks dalam message. Meta menghantarnya sebagai JSON, ditandatangani dengan X-Hub-Signature-256.
easyCoexistence melanggan setiap Halaman yang anda sambungkan kepada medan feed dan memajukan perubahannya ke endpoint HTTPS anda sebaik ia tiba, ditandatangani dengan rahsia Halaman itu, manakala peraturan komen-ke-DM dan automasi bertindak ke atas komen baharu.
Notifikasi suapan bagi suka Halaman hanya dihantar untuk Halaman yang mempunyai kurang suka daripada jumlah ini.
Medan suapan tidak menghantar apa-apa untuk siaran iklan itu sendiri, tetapi menghantar komen pada siarannya.
Kebenaran yang perlu diberikan oleh pentadbir Halaman yang mempunyai keistimewaan MODERATE agar webhook Halaman sampai ke aplikasi.
Kebanyakan kemas kini digabungkan oleh Meta menjadi satu penghantaran webhook, walaupun ia tidak menjamin penggabungan.
Tempoh masa Meta terus cuba semula penghantaran yang gagal ke endpoint aplikasi, dengan kekerapan yang semakin berkurang.
Apakah yang dilaporkan oleh medan suapan?
Hampir semua perubahan pada suapan Halaman, mengikut istilah Meta, seperti siaran, komen, reaksi dan kongsian; apa yang dibawa oleh sesuatu perubahan bergantung pada jenisnya. Meta tidak menghantar apa-apa untuk siaran iklan itu sendiri, walaupun komen pada siaran tersebut tetap sampai, dan ia hanya menghantar notifikasi suka Halaman selagi Halaman itu mempunyai kurang daripada 10,000 suka.
Apakah maksud item dan verb?
Dua medan dalam nilai setiap perubahan menyatakan apa yang berlaku:
- item: perkara yang berubah, daripada senarai Meta, yang merangkumi post, status, photo, video, link, share, comment, reaction dan album.
- verb: apa yang berlaku kepadanya: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute atau update.
- Komen baharu tiba dengan item comment dan verb add, iaitu apa yang dicari oleh peraturan komen-ke-DM.
- Reaksi membawa item reaction dan
reaction_typeyang menamakannya.
Bagaimanakah rupa perubahan suapan?
Satu POST yang JSON-nya mempunyai object ditetapkan kepada page dan satu entry bagi setiap Halaman, memuatkan ID Halaman, masa dan tatasusunan changes. Ini ialah contoh Meta sendiri, seseorang menyiarkan ke Halaman:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Medan apakah yang boleh dibawa oleh sesuatu perubahan?
Rujukan Meta menyenaraikan antara medan nilai perubahan suapan ini, hadir mengikut jenis perubahan:
post_id,comment_iddanparent_id: siaran, komen dan perkara yang dimilikinya.- from: ID dan nama pihak yang membuat perubahan.
- message: teks, dengan link, photo, photos atau video bagi kandungan yang dilampirkan.
created_time, danedited_timebagi suntingan.reaction_typebagi reaksi, danis_hiddenuntuk sama ada siaran disembunyikan.- post: butiran seperti
status_type,is_published,updated_timedanpermalink_url.
Bagaimanakah Halaman dilanggan?
Aplikasi menghantar POST /{page-id}/subscribed_apps dengan subscribed_fields=feed dan token Halaman, daripada seseorang yang boleh melaksanakan tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list telah diberikan. Meta hanya menghantar notifikasi selagi Halaman mempunyai aplikasi dipasang dan belum mematikan platform aplikasi dalam tetapannya. easyCoexistence melanggan setiap Halaman kepada feed, messages dan mention apabila ia disambungkan.
Bagaimanakah peristiwa suapan sampai ke endpoint anda?
Meta menghantarnya ke aplikasi easyCoexistence, yang menyemak X-Hub-Signature-256, membalas Meta serta-merta dan memajukan setiap entry bagi Halaman yang disambungkan ke endpoint HTTPS yang anda tetapkan untuknya. Pemajuan itu membawa header X-EC-Signature, iaitu HMAC-SHA256 bagi cap masa dan badan mentah yang dikunci dengan rahsia Halaman tersebut, dan dihantar sekali sahaja, tanpa salinan disimpan dan tanpa percubaan semula. Tetapkan endpoint dengan set_social_webhook_destination atau dengan PUT /channels/:id/webhook pada Partner API.
Perubahan suapan manakah yang memulakan peraturan komen dan automasi?
Hanya komen baharu: perubahan dengan item comment dan verb add pada salah satu siaran Halaman. Peraturan komen-ke-DM menyemak message-nya bagi kata kunci mereka dan melangkau komen yang dibuat oleh Halaman itu sendiri, dan automasi mengambil komen yang tidak dibalas oleh mana-mana peraturan. Suntingan, sembunyian, reaksi dan siaran terus ke endpoint anda, jika anda menetapkannya.
Kesilapan biasa
- Menganggap mana-mana perubahan suapan sebagai komen baharu. Semak item dan verb: reaksi, suntingan, sembunyian dan pembuangan tiba pada medan yang sama.
- Membalas komen Halaman sendiri. Balasannya juga datang sebagai perubahan suapan, jadi langkau yang from.id-nya ialah ID Halaman.
- Menganggap satu perubahan bagi setiap penghantaran. Meta boleh menggabungkan sehingga 1,000 kemas kini, jadi gelung melalui setiap entry dan setiap change di dalamnya.
- Membaca entry.time sebagai masa perubahan berlaku. Meta menetapkannya kepada masa notifikasi dihantar; created_time dalam nilai ialah masa objek dicipta.
Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah webhook suapan merangkumi komen?
Ya. Komen baharu tiba sebagai perubahan suapan dengan item comment dan verb add, membawa comment_id, post_id, from dan message.
Adakah saya menerima webhook untuk suka Halaman?
Hanya bagi Halaman dengan kurang daripada 10,000 suka, mengikut rujukan webhook Halaman Meta.
Adakah siaran iklan termasuk dalam webhook suapan?
Bukan siaran iklan itu sendiri, tetapi komen pada siaran tersebut dihantar.
Adakah saya perlu aplikasi Meta sendiri untuk mendapat peristiwa suapan Halaman?
Tidak. Meta menghantarnya ke aplikasi easyCoexistence, yang memajukan setiap satu ke endpoint yang anda tetapkan untuk Halaman itu.
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