MasukMulai uji coba gratis
easyCoexistence API resmi

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.

8

Field yang secara default dilanggani oleh produk Instagram baru di App Dashboard, termasuk comments, messages, dan message_reactions.

Per app

Field dipilih untuk aplikasi, bukan per akun: sebuah akun menerima field yang dipilih aplikasi.

Advanced Access

Tingkat akses yang dicantumkan panduan setup Meta untuk webhook Instagram Login, dan yang disyaratkan untuk notifikasi comments dan live_comments.

story_insights

Ditandai tidak tersedia untuk Instagram Login di tabel field Meta, yang menyediakannya dengan Facebook Login dan Unified Login.

10 Sep 2025

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.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

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 dan instagram_manage_insights. Referensi media insights Meta menyatakan webhook insights tidak didukung dengan Instagram Login.
  • messaging_policy_enforcement dan response_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.

Subscribing one account to three fields
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_echo bernilai 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, atau request_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.
Melakukan ini dengan EasyCoexistence

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