Webhook sebutan Facebook: apabila seseorang menyebut Page anda
Medan mention dalam webhook Page Facebook memberi tahu aplikasi apabila seseorang @menyebut Page dalam siaran atau komen. Meta menghantar change dengan medan bernilai mention, dan value-nya boleh membawa post_id, comment_id bagi komen, teks dalam message, pautan dan media yang dilampirkan, serta item dan verb, dalam POST yang ditandatangani dengan X-Hub-Signature-256.
easyCoexistence melanggan setiap Page yang anda sambungkan kepada medan mention, bersama feed dan messages, dan menghantar acara sebutannya ke endpoint HTTPS anda sebaik tiba, ditandatangani dengan rahsia bagi Page itu dan tanpa menyimpan salinan, supaya ejen anda tahu tentang setiap sebutan sebaik ia berlaku.
Medan webhook Page bagi sebutan Page yang baharu, termasuk sebutan dalam komen dan siaran.
Kebenaran yang mesti diberikan oleh admin Page dengan keistimewaan MODERATE sebelum webhook Page sampai ke URL panggil balik aplikasi.
Cara orang menyebut Page dalam siaran atau komen: taip @ dan nama Page, kemudian pilihnya.
Tempoh Meta mencuba semula pemberitahuan Page yang gagal, dengan kekerapan yang semakin berkurang, sebelum membuangnya.
Medan yang ditambah oleh edge /{page-id}/tagged kepada setiap siaran awam yang di dalamnya Page telah ditandai.
Apakah yang mencetuskan webhook sebutan?
Seseorang menyebut Page dalam siaran atau komen. Di Facebook, sebutan dibuat dengan menaip @ dan nama Page, kemudian memilihnya daripada cadangan. Rujukan Meta menerangkan medan ini sebagai sebutan baharu bagi Page, termasuk sebutan dalam komen dan siaran. Pusat Bantuan Facebook menyatakan bahawa tetapan Page boleh menghalang orang daripada menyebutnya.
Bagaimana rupa notifikasi sebutan?
Satu POST dengan object bernilai page dan satu entry bagi Page yang disebut: ID-nya, masa, dan tatasusunan changes yang medannya ialah mention. Rujukan Meta menyenaraikan medan value tetapi tidak memberi contoh, jadi sebutan dalam siaran ini dibentuk daripada senarai tersebut:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
]
}Apa maksud setiap medan sebutan?
Ini ialah medan value dalam rujukan Meta. Notifikasi membawa medan yang mana satu bergantung pada siaran atau komen:
post_id: ID siaran yang menyebut Page.comment_id: ID komen, apabila sebutan berada dalam komen;parent_id: ID induknya.- message: teks yang membawa sebutan.
- link, photo, photos dan video: pautan kepada apa yang dilampirkan pada siaran atau komen.
- item dan verb: jenis objek dan apa yang berlaku kepadanya, daripada senarai yang sama digunakan oleh medan feed.
created_time: masa siaran atau komen dicipta.- from dan
message_tags: pengarang dan profil yang ditanda dalam teks, kedua-duanya ditanda Workplace sahaja. - Turut disenaraikan: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_iddanopen_graph_story_id.
Kebenaran apakah yang diperlukan oleh medan sebutan?
pages_manage_metadata, yang mesti diberikan oleh admin Page dengan keistimewaan MODERATE sebelum webhook Page sampai ke aplikasi. Page dilanggan melalui POST /{page-id}/subscribed_apps dengan mention dalam subscribed_fields, menggunakan token Page daripada seseorang yang mempunyai tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list. Aplikasi juga melanggan mention, kerana hanya medan yang dilanggan pada kedua-dua peringkat dihantar. Page yang dikendalikan oleh orang tanpa peranan pada aplikasi memerlukan kebenaran tersebut dalam Advanced Access.
Bagaimana membaca siaran atau komen yang menyebut Page?
Mengikut ID-nya, dengan token Page, apabila Meta membenarkannya. Token Page membaca siaran yang diterbitkan kepada atau oleh Page. Siaran awam Page lain memerlukan pages_manage_posts dan ciri Page Public Content Access, menggunakan token daripada admin Page. Meta juga mengaitkan pembacaan siaran seseorang dengan kebenaran user_posts orang itu.
GET https://graph.facebook.com/<POST_ID>
?fields=message,permalink_url,created_time
&access_token=<PAGE_ACCESS_TOKEN>
GET https://graph.facebook.com/<COMMENT_ID>
?fields=message,from,created_time
&access_token=<PAGE_ACCESS_TOKEN>Di mana lagi Page boleh mencari sebutannya?
Pada edge tagged. GET /{page-id}/tagged menyenaraikan siaran awam yang di dalamnya Page telah ditandai, setiap satu dengan tagged_time, yang juga meliputi siaran sebelum webhook ditetapkan. Ia memerlukan token Page daripada seseorang yang mempunyai tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_read_user_content dan pages_show_list. Meta menyatakan ciri Page Public Content Access mungkin diperlukan. Pada siaran seseorang, Meta memulangkan from hanya kepada orang yang menulisnya.
Bagaimana easyCoexistence menghantar acara sebutan?
Ia melanggan setiap Page kepada mention, bersama feed dan messages, apabila Page disambungkan. Aplikasinya menyemak X-Hub-Signature-256 pada setiap penghantaran, menjawab Meta serta-merta dan POST setiap entry bagi Page, tanpa diubah, ke endpoint HTTPS yang anda tetapkan dengan set_social_webhook_destination atau PUT /channels/:id/webhook pada Partner API:
- X-EC-Signature membawa t=<unix>,v1=<hex>: HMAC-SHA256 bagi cap masa, titik dan badan mentah, dengan kunci rahsia tandatangan Page.
- Rahsia bermula dengan whsec_ dan ditunjukkan sekali sahaja. Menetapkan semula URL mengeluarkan rahsia baharu, dan URL null menghentikan penghantaran.
- Setiap entry dihantar sekali, menunggu sehingga 8 saat, ke alamat HTTPS yang diselesaikan kepada IP awam, tanpa mengikut ubah hala dan tanpa menyimpan salinan.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
}Kesilapan biasa
- Membaca entry.time sebagai masa sebutan berlaku. Meta menetapkannya kepada masa notifikasi dihantar; created_time dalam value menandakan tarikh siaran atau komen.
- Menganggap carian yang gagal sebagai acara yang rosak. Meta memberi amaran bahawa sesetengah nilai post_id dan comment_id dalam notifikasi sebutan tidak boleh ditanya, kerana kekurangan kebenaran atau atas sebab privasi, jadi simpan teks mesej daripada acara itu sendiri.
- Mengambil siaran sebelum menjawab penghantaran. Penghantaran tidak dicuba semula, jadi pulangkan 2xx serta-merta dan cari siaran kemudian.
Daripada US$ 9 sebulan bagi setiap sambungan, turun kepada US$ 0.75 apabila anda menambah sambungan, dengan 3 hari pertama sebagai percubaan percuma.
Soalan lazim
Adakah webhook sebutan memberitahu siapa yang menyebut Page?
Tidak bagi Page: rujukan Meta menandakan from sebagai Workplace sahaja. Mencari siaran atau komen melalui ID-nya boleh memulangkan pengarangnya jika kebenaran Meta membenarkannya.
Bolehkah saya mendapat sebutan dari sebelum Page dilanggan?
Tidak daripada webhook, kerana Meta tidak menyimpan sejarah notifikasi untuk ditanya. Edge tagged menyenaraikan siaran awam yang di dalamnya Page telah ditandai.
Apa beza medan mention dengan feed?
feed melaporkan perubahan pada suapan Page sendiri, seperti siaran, komen dan reaksi di situ. mention melaporkan Page yang disebut dalam siaran atau komen. Setiap medan dilanggan secara berasingan.
Adakah peraturan komen easyCoexistence bertindak ke atas sebutan?
Tidak. Peraturan dan automasi bertindak ke atas komen daripada medan feed dan mesej Messenger. Perubahan sebutan dihantar ke endpoint anda sama seperti yang dihantar Meta.
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