Webhook message_reactions Instagram: payload react dan unreact
Field message_reactions Instagram memberi tahu aplikasi saat seseorang bereaksi pada pesan dalam percakapannya dengan akun profesional, atau menghapus reaksinya. Event berada dalam array messaging dengan objek reaction: mid, ID pesan yang direaksi; action, react atau unreact; dan, hanya pada react, reaction, seperti love, serta emoji, emoji itu sendiri.
easyCoexistence berlangganan setiap akun Instagram yang terhubung ke comments, messages, dan mentions, lalu meneruskan event tersebut ke endpoint HTTPS Anda saat tiba, ditandatangani dengan secret akun itu, setiap pesan membawa mid-nya.
Dua nilai reaction.action: reaksi ditambahkan, atau reaksi dihapus.
Versi Graph API sejak Meta mendukung reaksi angry, sad, wow, love, like, laugh, dan lainnya pada webhook ini.
Meta tidak mengirim notifikasi saat akun itu sendiri bereaksi atau menghapus reaksi pada pesan seseorang.
message_reactions termasuk field yang otomatis berlangganan pada produk Instagram baru di App Dashboard.
Panggilan Send API per detik per akun untuk teks, tautan, reaksi, dan stiker.
Kapan message_reactions dipicu?
Saat seseorang bereaksi pada pesan dalam percakapannya dengan akun profesional, dan lagi saat ia menghapus reaksinya, setelah aplikasi dan akun berlangganan pada field ini. Panduan Instagram Messaging dari Meta tegas soal arah sebaliknya: saat akun itu sendiri bereaksi atau menghapus reaksi, tidak ada notifikasi dan messages juga tidak mengirim echo untuknya.
Seperti apa notifikasi reaksi?
Sebuah POST dengan object bernilai instagram, yang entry-nya berisi array messaging. Berbeda dengan DM, event ini tidak membawa objek message: reaksi berada dalam objek reaction tersendiri, di samping sender, recipient, dan timestamp. Ini contoh Meta untuk Instagram Login:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}Apa arti setiap field?
Field yang didokumentasikan Meta untuk event reaksi, dari luar ke dalam:
- entry[].id dan recipient.id: akun profesional. sender.id: ID bercakupan Instagram milik orang yang bereaksi.
- timestamp: saat event dipicu, dalam milidetik pada contoh Meta; entry[].time adalah saat Meta mengirim notifikasi.
- reaction.mid: ID pesan yang direaksi, sama dengan mid yang dimiliki pesan itu pada event messages.
- reaction.action: react saat reaksi ditambahkan, unreact saat dihapus.
- reaction.reaction: nama reaksi, seperti love; Meta mencantumkan angry, sad, wow, love, like, laugh, dan lainnya.
- reaction.emoji: emoji sebagai string Unicode, seperti \u{2764}\u{FE0F} untuk love.
- Pada unreact, reaction dan emoji dihilangkan.
Seperti apa unreact?
Event yang sama dengan action bernilai unreact, tanpa reaction maupun emoji, karena tidak ada yang tersisa untuk dinamai. Cocokkan dengan reaksi yang dihapus melalui reaction.mid dan sender.id, lalu hapus reaksi orang itu dari pesan di catatan Anda.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}Pesan mana yang ditunjuk mid?
Pesan yang direaksi orang tersebut, dengan mid yang sama seperti pada event messages-nya, termasuk echo dari pesan akun sendiri. Handler yang menyimpan mid dapat menempelkan reaksi pada baris percakapan yang tepat. Meta mencatat satu celah: reaksi pada satu gambar dari postingan karusel melaporkan gambar pertama karusel, yang mungkin bukan gambar yang dipilih.
Bagaimana akun bereaksi pada pesan?
Dengan POST /<IG_ID>/messages: recipient.id berisi ID bercakupan Instagram orang tersebut, sender_action bernilai react, dan payload berisi message_id dan reaction, berupa emoji atau bentuk UTF-8-nya. Mengulang panggilan dengan emoji lain mengubah reaksi, dan sender_action bernilai unreact dengan hanya message_id menghapusnya. Kedua panggilan tidak menghasilkan webhook.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}Apa yang dibutuhkan message_reactions?
Dengan Instagram Login, instagram_business_basic dan instagram_business_manage_messages, serta Advanced Access untuk akun yang tidak dimiliki atau dikelola developer. Produk Instagram baru di App Dashboard otomatis berlangganan message_reactions, dan setiap akun didaftarkan melalui POST /<IG_ID>/subscribed_apps. Panduan Send Messages dari Meta menulisnya sebagai messaging_reactions, tetapi tabel field, default dashboard, dan referensi webhook-nya menulis message_reactions.
Apakah easyCoexistence meneruskan reaksi?
Tidak. Aplikasi easyCoexistence dan setiap akun yang terhubung hanya berlangganan comments, messages, dan mentions, sehingga event message_reactions tidak diteruskan ke endpoint Anda. DM dan echo yang ditunjuk reaksi lewat mid-nya memang sampai ke endpoint itu, ditandatangani dengan rahasia akun.
Kesalahan umum
- Mencari reaksi di dalam message. Event reaksi tidak punya objek message; baca objek reaction di samping sender dan recipient.
- Membaca reaction atau emoji tanpa memeriksa action. Keduanya dihilangkan pada unreact, sehingga kode yang mengasumsikan keduanya ada akan rusak saat reaksi dihapus.
- Menunggu webhook setelah akun bereaksi. Meta tidak mengirim apa pun untuk reaksi akun sendiri, bahkan tidak echo, jadi catat saat aplikasi Anda yang mengirimnya.
- Menyalin nama messaging_reactions dari panduan Send Messages Meta. Field di tabel field, default dashboard, dan referensi webhook-nya adalah message_reactions.
Agen Anda membalas seseorang dengan send_social_dm dalam jendela layanan pelanggan 24 jam. Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Mengapa reaksi pada postingan karusel menunjuk ke gambar pertama?
Meta melaporkan gambar pertama karusel saat seseorang bereaksi pada salah satu gambarnya, yang mungkin bukan gambar yang dipilih orang tersebut.
Apakah Instagram mengirim webhook saat bisnis bereaksi terhadap pesan?
Tidak. Meta tidak mengirim notifikasi message_reactions maupun echo saat akun bereaksi atau menghapus reaksi pada pesan.
Reaksi apa saja yang dapat dilaporkan webhook Instagram?
Panduan Instagram Messaging dari Meta mencantumkan angry, sad, wow, love, like, laugh, dan lainnya dari Graph API v12.0, dengan emoji itu sendiri di reaction.emoji.
Apakah nama field webhook message_reactions atau messaging_reactions?
message_reactions. Panduan Send Messages Meta menulis messaging_reactions, tetapi tabel field, default App Dashboard, dan referensi webhook-nya semuanya memakai message_reactions.
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