Webhook mention Facebook: saat seseorang menyebut Halaman Anda
Field mention pada webhook Halaman Facebook memberi tahu aplikasi saat seseorang menyebut Halaman di postingan atau komentar. Meta mengirim perubahan dengan field diisi mention, yang nilainya bisa memuat post_id, comment_id untuk komentar, teks di message, tautan dan media yang dilampirkan, serta item dan verb, dalam POST yang ditandatangani dengan X-Hub-Signature-256.
easyCoexistence mendaftarkan setiap Halaman yang Anda hubungkan ke field mention, di samping feed dan messages, lalu meneruskan event mention-nya ke endpoint HTTPS Anda saat tiba, ditandatangani dengan kunci rahasia untuk Halaman itu dan tanpa menyimpan salinan, sehingga agen Anda mengetahui setiap mention saat itu terjadi.
Field webhook Halaman untuk mention baru pada Halaman, termasuk mention di komentar dan postingan.
Izin yang harus diberikan admin Halaman dengan hak MODERATE sebelum webhook Halaman sampai ke callback URL aplikasi.
Cara orang menyebut Halaman di postingan atau komentar: ketik @ dan nama Halaman, lalu pilih.
Berapa lama Meta mencoba ulang notifikasi Halaman yang gagal, dengan frekuensi yang semakin jarang, sebelum membuangnya.
Field yang ditambahkan edge /{page-id}/tagged ke setiap postingan publik tempat Halaman di-tag.
Apa yang memicu webhook mention?
Seseorang menyebut Halaman di postingan atau komentar. Di Facebook, mention dibuat dengan mengetik @ dan nama Halaman lalu memilihnya dari saran, dan referensi Meta menggambarkan field ini sebagai mention baru pada Halaman, termasuk mention di komentar dan postingan. Pusat Bantuan Facebook mencatat bahwa pengaturan Halaman dapat mencegah orang menyebutnya.
Seperti apa notifikasi mention?
POST dengan object diisi page dan satu entry untuk Halaman yang disebut: ID-nya, waktu, dan array changes yang field-nya adalah mention. Referensi Meta mencantumkan field nilai tetapi tidak memberi contoh, jadi mention di postingan ini dibentuk dari daftar 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 arti tiap field mention?
Ini adalah field nilai dalam referensi Meta; field mana yang dibawa notifikasi bergantung pada postingan atau komentar:
post_id: ID postingan yang menyebut Halaman.comment_id: ID komentar, saat mention ada di komentar;parent_id: ID induknya.- message: teks yang memuat mention.
- link, photo, photos dan video: tautan ke apa yang dilampirkan postingan atau komentar.
- item dan verb: jenis objek dan apa yang terjadi padanya, dari daftar yang sama dengan field feed.
created_time: kapan postingan atau komentar dibuat.- from dan
message_tags: penulis dan profil yang di-tag dalam teks, keduanya bertanda hanya untuk Workplace. - Juga tercantum: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_iddanopen_graph_story_id.
Izin apa yang dibutuhkan field mention?
pages_manage_metadata, yang harus diberikan admin Halaman dengan hak MODERATE sebelum webhook Halaman sampai ke aplikasi. Halaman didaftarkan melalui POST /{page-id}/subscribed_apps dengan mention di antara subscribed_fields, menggunakan token Halaman dari seseorang dengan tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list. Aplikasi juga harus berlangganan mention, sebab hanya field yang berlangganan di kedua tingkat yang dikirim, dan Halaman yang dikelola orang tanpa peran di aplikasi memerlukan izin tersebut dalam Advanced Access.
Bagaimana membaca postingan atau komentar yang menyebut Halaman?
Dengan ID-nya, memakai token Halaman, jika Meta mengizinkan. Token Halaman membaca postingan yang diterbitkan ke atau oleh Halaman; postingan publik dari Halaman lain memerlukan pages_manage_posts dan fitur Page Public Content Access, pada token dari admin Halaman; dan Meta mengaitkan pembacaan postingan milik seseorang dengan izin user_posts orang tersebut.
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 Halaman bisa menemukan mention-nya?
Pada edge tagged. GET /{page-id}/tagged mencantumkan postingan publik tempat Halaman di-tag, masing-masing dengan tagged_time, yang juga mencakup postingan dari sebelum webhook disiapkan. Diperlukan token Halaman dari seseorang dengan tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_read_user_content dan pages_show_list, dan Meta menyebut fitur Page Public Content Access mungkin diperlukan. Pada postingan seseorang, Meta hanya mengembalikan from kepada orang yang menulisnya.
Bagaimana easyCoexistence mengirim event mention?
Ia mendaftarkan setiap Halaman ke mention, di samping feed dan messages, saat Halaman terhubung. Aplikasinya memeriksa X-Hub-Signature-256 pada setiap pengiriman, langsung menjawab Meta dan mengirim POST setiap entry untuk Halaman, tanpa diubah, ke endpoint HTTPS yang Anda atur dengan set_social_webhook_destination atau PUT /channels/:id/webhook di Partner API:
- X-EC-Signature berisi t=<unix>,v1=<hex>: HMAC-SHA256 dari timestamp, titik, lalu body mentah, dengan kunci rahasia penandatanganan Halaman.
- Kunci rahasia diawali whsec_ dan hanya ditampilkan sekali; mengatur ulang URL menerbitkan kunci baru, dan URL null menghentikan pengiriman.
- Setiap entry dikirim sekali, menunggu hingga 8 detik, ke alamat HTTPS yang mengarah ke IP publik, tanpa mengikuti redirect 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>"
}
}
]
}
}Kesalahan umum
- Membaca entry.time sebagai saat terjadinya mention. Meta mengatur nilai itu ke saat notifikasi dikirim; created_time dalam value menunjukkan tanggal postingan atau komentar.
- Menganggap pencarian yang gagal sebagai event yang rusak. Meta memperingatkan bahwa sebagian nilai post_id dan comment_id dalam notifikasi mention tidak dapat ditanyakan, karena kurangnya izin atau alasan privasi, jadi simpan teks message dari event itu sendiri.
- Mengambil postingan sebelum menjawab penerusan. Penerusan tidak dicoba ulang, jadi kembalikan 2xx segera dan cari postingannya setelahnya.
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 webhook mention memberi tahu siapa yang menyebut Halaman?
Tidak untuk Halaman: referensi Meta menandai from hanya untuk Workplace. Mencari postingan atau komentar berdasarkan ID-nya dapat mengembalikan penulisnya, jika izin Meta mengizinkan.
Bisakah saya mendapatkan mention dari sebelum Halaman didaftarkan?
Tidak dari webhook, karena Meta tidak menyimpan riwayat notifikasi untuk ditanyakan. Edge tagged mencantumkan postingan publik tempat Halaman di-tag.
Apa bedanya field mention dengan feed?
feed melaporkan perubahan pada feed Halaman sendiri, seperti postingan, komentar, dan reaksi di sana; mention melaporkan Halaman yang disebut dengan @ di postingan atau komentar. Setiap field didaftarkan secara terpisah.
Apakah aturan komentar easyCoexistence berlaku untuk mention?
Tidak. Aturan dan otomasi bekerja pada komentar dari field feed dan pesan Messenger; perubahan mention diteruskan ke endpoint Anda persis seperti yang dikirim Meta.
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