Field webhook Instagram: daftar lengkap
Untuk akun profesional di Instagram Login, tabel field webhook Meta mencantumkan comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover dan standby, dengan mentions dikirim di dalam comments; contohnya menambahkan message_edit. Setiap field memerlukan instagram_business_basic ditambah instagram_business_manage_comments atau, untuk sebagian besar field pesan, instagram_business_manage_messages. story_insights tidak tersedia dengan Instagram Login.
easyCoexistence berlangganan setiap akun Instagram yang terhubung ke comments, messages, dan mentions, lalu meneruskan event tersebut ke endpoint HTTPS Anda begitu tiba, ditandatangani dengan kunci rahasia akun itu.
Field yang secara default dilanggani oleh produk Instagram baru di App Dashboard, termasuk comments, messages, dan message_reactions.
Field dipilih untuk aplikasi, bukan per akun: sebuah akun menerima field yang dipilih aplikasi.
Tingkat akses yang dicantumkan panduan setup Meta untuk webhook Instagram Login, dan yang disyaratkan untuk notifikasi comments dan live_comments.
Ditandai tidak tersedia untuk Instagram Login di tabel field Meta, yang menyediakannya dengan Facebook Login dan Unified Login.
Saat Meta memperkenalkan webhook message_edit untuk Business Login for Instagram dan Facebook Login for Business.
Field webhook apa saja yang ditawarkan Instagram Login?
Berikut daftarnya dari tabel field Meta, dengan pemicu tiap field diambil dari contoh dan referensi webhook-nya. Setiap field juga memerlukan instagram_business_basic di samping izin yang ditampilkan, dan Meta mensyaratkan Advanced Access untuk notifikasi comments dan live_comments.
Field mana yang tidak tersedia dengan Instagram Login?
Tiga baris pada tabel field Meta tidak memiliki izin Instagram Login, sehingga aplikasi dengan Instagram Login tidak menerimanya, dan satu field lagi hanya ada di luar itu:
story_insights: metrik sebuah Story saat kedaluwarsa, dengan Facebook Login atau Unified Login daninstagram_manage_insights. Referensi media insights Meta menyatakan webhook insights tidak didukung dengan Instagram Login.messaging_policy_enforcementdanresponse_feedback: hanya ada di kolom untuk Instagram Messaging API milik Meta.- mentions sebagai field tersendiri: Facebook Login dan Unified Login mencantumkannya, dengan
instagram_manage_comments, sedangkan Instagram Login menggabungkan mentions ke dalam comments.
Bagaimana cara berlangganan field?
Di dua tempat. Di App Dashboard, pada pengaturan webhook produk Instagram, simpan callback URL dan verify token, yang memicu permintaan verifikasi dari Meta, lalu pilih field-nya; produk Instagram baru otomatis berlangganan delapan di antaranya. Kemudian berlangganan tiap akun dengan POST /<IG_ID>/subscribed_apps di graph.instagram.com, dengan subscribed_fields diisi field yang dipilih di dashboard, dipisahkan koma.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Bisakah tiap akun mendapatkan field yang berbeda?
Tidak. Panduan setup Meta menyatakan field tidak dapat dipilih untuk tiap akun pengguna aplikasi: sebuah akun menerima field yang dipilih untuk aplikasi. subscribed_fields pada langganan akun dimaksudkan untuk mencantumkan field dari dashboard, sehingga handler sebaiknya menerima field apa pun yang dipilih aplikasi dan memutuskan berdasarkan isi setiap event, bukan berdasarkan apa yang diminta untuk satu akun.
Bagaimana membedakan field dalam sebuah notifikasi?
Dari bentuk entry-nya. Field comments datang dalam array changes, dengan tiap change menyebut field-nya. Field pesan datang dalam array messaging tanpa nama field, dan kunci di samping sender, recipient, dan timestamp yang membedakannya:
- changes[].field: comments atau
live_comments, dengan komentarnya ada di value. - message: messages, termasuk gema dari pesan akun sendiri, yang membawa
is_echobernilai true. - reaction:
message_reactions. postback:messaging_postbacks. read:messaging_seen.message_edit:message_edit. - referral di samping sender:
messaging_referral. Referral di dalam message termasuk messages, dari thread baru atau iklan Click-to-Direct. pass_thread_control,take_thread_control, ataurequest_thread_control:messaging_handover, sebagaimana tercantum di referensi webhook Meta.
Field apa saja yang dilanggani easyCoexistence?
comments, messages, dan mentions, daftar yang dilanggani setiap akun Instagram saat terhubung. Dengan Instagram Login, mentions ada di dalam comments, sehingga langganan mencakup comments dan DM, dengan gema, balasan Story, mention Story, dan lampiran termasuk dalam DM. Field lain dalam tabel dikirim oleh Meta ke aplikasi yang berlangganan kepadanya dan bukan bagian dari langganan koneksi mana pun. Setelah endpoint diatur dengan set_social_webhook_destination atau Partner API, easyCoexistence memeriksa tanda tangan Meta, langsung menjawab Meta, dan mengirim POST setiap entry untuk akun itu ke endpoint tersebut:
- platform dan
external_id: instagram, dan ID Instagram akun, sama dengan entry.id. account_id: ID koneksi di easyCoexistence, yang diterima oleh tool MCP.- entry: entry Meta untuk akun itu, tanpa perubahan. Field object milik Meta dan header X-Hub-Signature-256-nya tidak diteruskan.
- X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 dari timestamp, titik, dan raw body, dengan kunci rahasia milik akun itu sendiri.
- Pengiriman: satu kali percobaan hingga 8 detik, tanpa mengikuti redirect, tanpa menyimpan salinan, dan tanpa mencoba kembali.
Kesalahan umum
- Menunggu field mentions dengan Instagram Login. Meta menggabungkan mentions ke dalam notifikasi comments, sehingga handler yang dikunci pada field mentions tidak pernah berjalan.
- Mengira sebuah akun hanya menerima field yang disebut langganannya sendiri. Meta mengirim field yang dipilih untuk aplikasi, jadi tentukan cabang berdasarkan isi setiap event.
- Menganggap message.referral dan referral tingkat atas sebagai satu event. Yang pertama ada di messages; yang kedua adalah messaging_referral, untuk tautan ig.me yang dibuka di percakapan yang sudah ada.
- Menunggu story_insights dengan Instagram Login. Meta menandainya tidak tersedia di sana, jadi baca metrik Story dari endpoint insights selama Story itu masih tayang.
Event tidak disimpan secara default; akun dengan automasi aktif menyimpan DM dan komentarnya selama 7 hari. Atur endpoint dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API. 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 Instagram Login punya field webhook mentions?
Tidak sebagai field tersendiri. Meta menyertakan mentions dalam notifikasi comments untuk Instagram Login; mentions menjadi field tersendiri dengan Facebook Login dan Unified Login.
Apakah story_insights tersedia dengan Instagram Login?
Tidak. Tabel field Meta menandainya tidak tersedia untuk Instagram Login, dan referensi media insights-nya menyatakan webhook insights tidak didukung di sana.
Izin apa yang diperlukan webhook pesan Instagram?
instagram_business_basic dan instagram_business_manage_messages, dengan Advanced Access, yang dicantumkan panduan setup Meta untuk webhook Instagram Login.
Kapan Meta menambahkan webhook message_edit untuk Instagram?
Pada 10 September 2025, untuk Business Login for Instagram dan Facebook Login for Business. Sebuah edit datang di array messaging di bawah kunci message_edit.
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