MasukMulai uji coba gratis
easyCoexistence API resmi

Webhook komentar Instagram: payload, field demi field

Field webhook komentar Instagram memberi tahu aplikasi saat seseorang berkomentar pada, atau membalas komentar di, media akun profesional, termasuk Reels. Meta mengirim perubahan dengan field bernilai comments, yang nilainya memuat id dan teks komentar, ID khusus Instagram dan username penulis di from, id dan media_product_type media, serta parent_id saat komentar merupakan balasan.

easyCoexistence mendaftarkan setiap akun Instagram yang terhubung ke comments dan meneruskan event comments yang dikirim Meta untuk akun itu ke endpoint HTTPS Anda saat tiba, ditandatangani dengan secret akun tersebut dan tanpa menyimpan salinan.

parent_id

Ada saat komentar merupakan balasan, memuat ID komentar yang dibalas.

self_ig_scoped_id

Ditambahkan dari saat akun berkomentar di media miliknya sendiri, di samping ID akun itu sendiri.

live_comments

Field terpisah untuk komentar selama siaran Live; notifikasinya berhenti saat siaran berakhir.

Advanced Access

Wajib untuk notifikasi comments dan live_comments; media milik akun privat tidak memicu notifikasi apa pun.

7 days

Sisa waktu untuk mengirim satu balasan privat kepada pengomentar, dialamatkan dengan ID komentar.

Kapan field comments aktif?

Saat seseorang berkomentar pada media milik akun profesional, atau menyebut akun tersebut, setelah aplikasi dan akun sama-sama berlangganan ke field ini. Setiap komentar adalah satu perubahan dalam notifikasi, dan kasus-kasus berikut memiliki bentuk yang sama:

  • Komentar baru pada postingan, Reel, Story, atau iklan, dengan media.media_product_type yang menunjukkan permukaan media tersebut.
  • Balasan di bawah komentar yang sudah ada, yang membawa parent_id dengan ID komentar yang dibalas.
  • Komentar yang dibuat akun pada media miliknya sendiri, termasuk balasannya: from.id adalah ID akun itu sendiri, dan from menambahkan self_ig_scoped_id.
  • Penyebutan @ akun: dengan Instagram Login, Meta menyertakan penyebutan dalam notifikasi comments alih-alih field tersendiri.
  • Komentar selama siaran Live masuk ke field terpisah, live_comments, dengan bentuk nilai yang sama, dan berhenti saat siaran berakhir.

Seperti apa notifikasi komentar?

Sebuah POST dengan JSON yang object-nya bernilai instagram dan memiliki array entry. Setiap entry adalah satu akun profesional: ID-nya, waktu Meta mengirim notifikasi, dan array changes yang memuat satu perubahan per komentar. Balasan pada Reel terlihat seperti ini:

A comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "comments",
          "value": {
            "id": "<COMMENT_ID>",
            "parent_id": "<PARENT_COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<MEDIA_ID>",
              "media_product_type": "REELS"
            }
          }
        }
      ]
    }
  ]
}

Apa arti setiap field?

Field yang dicantumkan referensi webhook Meta untuk komentar, dari luar ke dalam:

  • entry[].id: ID akun profesional, yaitu user_id yang dikembalikan /me untuk akun tersebut. Field ini menunjukkan akun mana yang dimiliki komentar.
  • entry[].time: kapan Meta mengirim notifikasi, sebagai timestamp Unix. Ini bukan waktu komentar ditulis.
  • changes[].field: comments, atau live_comments untuk siaran Live. Periksa field ini sebelum membaca value.
  • value.id: ID komentar, yang dipakai untuk membalas secara publik atau privat, menyembunyikan, atau menghapus.
  • value.text: teks komentar, disertakan saat komentar memiliki teks.
  • value.from.id dan value.from.username: ID khusus Instagram dan username penulis. value.from.self_ig_scoped_id muncul saat akun itu sendiri yang menulis komentar.
  • value.media.id dan value.media.media_product_type: media yang dikomentari dan permukaannya; referensi media Meta menyebut AD, FEED, STORY, dan REELS.
  • value.parent_id: pada balasan, ID komentar yang dibalas. Komentar tingkat atas tidak memilikinya.
  • value.media.ad_id, ad_title, dan original_media_id: tercantum di referensi untuk komentar pada iklan.

Apa yang tidak dilaporkan field comments?

Beberapa hal yang mungkin diharapkan handler tidak disertakan dalam event atau tidak pernah dikirim, menurut panduan setup dan referensi Meta:

  • Komentar pada media milik akun privat: Meta tidak mengirim notifikasi komentar maupun penyebutan untuknya.
  • ID album: event tidak menyertakannya, dan Meta menyarankan mencari album dengan ID komentar.
  • ID iklan untuk media yang dipakai dalam dynamic ads.
  • Waktu pembuatan komentar: GET /<COMMENT_ID>?fields=timestamp mengembalikannya dalam ISO 8601.
  • Komentar Live setelah siaran berakhir, saat notifikasi untuk media live berhenti.
  • Penyebutan di Story, yang tidak didukung API penyebutan Meta; penyebutan itu sampai ke akun sebagai DM.
  • Event masa lalu: Meta tidak menyimpan riwayat notifikasi untuk dikueri, jadi simpan apa yang Anda butuhkan saat setiap event tiba.

Apa yang dibutuhkan field comments?

Dengan Instagram Login, izin instagram_business_basic dan instagram_business_manage_comments, serta Advanced Access, yang diwajibkan Meta untuk notifikasi comments dan live_comments. Aplikasi harus Live dan berlangganan ke comments di App Dashboard, dan setiap akun harus didaftarkan lewat POST /<IG_ID>/subscribed_apps dengan comments termasuk di subscribed_fields-nya. Meta sangat menyarankan webhook ini dibanding polling untuk komentar, karena webhook menghemat pembatasan laju.

Bagaimana cara membalas komentar dari event?

Dengan ID yang dibawanya. POST /<COMMENT_ID>/replies dengan message memposting balasan publik di bawah komentar, menggunakan value.id. POST /<IG_ID>/messages dengan recipient.comment_id diisi value.id mengirim penulisnya satu balasan privat, dalam 7 hari sejak komentar, atau selama siaran berlangsung jika di Live. from.id adalah ID khusus Instagram, tetapi DM yang langsung dikirim ke sana gagal sampai orang tersebut mengirim pesan ke akun, jadi balasan privat adalah cara menjangkau mereka lewat DM.

Bagaimana easyCoexistence meneruskan komentar?

Saat komentar tiba, setelah endpoint ditetapkan untuk akun lewat set_social_webhook_destination dari Claude atau ChatGPT, atau lewat PUT /channels/:id/webhook di Partner API. easyCoexistence mendaftarkan setiap akun yang terhubung ke field yang membawa komentar, mention, dan DM-nya, memeriksa tanda tangan Meta pada setiap pengiriman, langsung menjawab Meta, dan mengirim POST setiap entry untuk akun itu ke URL HTTPS Anda di dalam envelope:

  • platform dan external_id: instagram, dan ID Instagram akun, sama dengan entry.id.
  • account_id: ID koneksi di easyCoexistence, yang dikembalikan list_social_accounts dan dipakai tool MCP.
  • entry: entry Meta untuk akun, tanpa diubah, sehingga pengiriman batch menjadi satu POST per entry. Field object Meta dan X-Hub-Signature-256 tidak diteruskan.
  • Pengiriman: satu percobaan, menunggu hingga 8 detik, tanpa mengikuti redirect, ke alamat HTTPS yang mengarah ke IP publik. Tidak ada salinan yang disimpan dan tidak ada percobaan ulang.
A forwarded comment, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>

{
  "platform": "instagram",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<IG_ID>",
  "entry": {
    "id": "<IG_ID>",
    "time": 1793448000,
    "changes": [
      {
        "field": "comments",
        "value": {
          "id": "<COMMENT_ID>",
          "text": "<COMMENT_TEXT>",
          "from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
          "media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
        }
      }
    ]
  }
}

Apa yang dilakukan aturan komentar-ke-DM terhadap event yang sama?

Aturan tersebut membacanya bersamaan dengan penerusan. Sebuah aturan cocok ketika komentar memuat salah satu kata kuncinya, tanpa membedakan huruf besar-kecil, pada satu postingan yang dipilih atau pada semua postingan, lalu mengirim DM aturan itu kepada penulis sebagai balasan privat, ditambah balasan publik jika aturan memilikinya. Komentar dari akun itu sendiri dilewati, otomasi yang dimulai dari komentar mengambil komentar yang tidak dibalas aturan mana pun, dan komentar yang sudah dibalas aturan tetap sampai ke endpoint Anda. Balasan publik aturan dapat kembali sebagai event comments baru dari akun itu sendiri.

Kesalahan umum

  • Mencari comment_id. Di bawah Instagram Login, ID komentar ada di value.id; comment_id termasuk payload dari setup login Meta lainnya.
  • Membalas komentar milik akun sendiri. Balasannya kembali sebagai event comments dengan from.id sama dengan entry.id, dan otomasi yang membalasnya akan berbicara dengan dirinya sendiri.
  • Membaca entry.time sebagai waktu komentar. Field itu mencatat kapan Meta mengirim notifikasi; field timestamp milik komentar yang menunjukkan kapan komentar ditulis.
  • Menunggu komentar Live di field comments. Komentar itu tiba di live_comments, yang butuh berlangganan tersendiri dan berhenti saat siaran berakhir.
Melakukan ini dengan EasyCoexistence

Aturan komentar-ke-DM dan otomasi membalas komentar yang sama sepanjang waktu. Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah webhook komentar Instagram menyertakan balasan atas komentar?

Ya. Balasan tiba sebagai event comments tersendiri, dengan parent_id yang memuat ID komentar yang dibalas.

Apakah komentar di Reels memicu webhook komentar Instagram?

Ya. Komentar pada Reel datang lewat field comments seperti pada postingan, dan media.media_product_type membedakan keduanya.

Mengapa webhook komentar Instagram saya tidak aktif?

Paling sering aplikasi belum Live atau belum memiliki Advanced Access, akun belum pernah didaftarkan lewat /subscribed_apps, media milik akun privat, atau komentar berada di siaran Live, yang memakai live_comments.

Apakah webhook komentar menyertakan username pengomentar?

Ya. value.from memuat username orang tersebut di samping ID khusus Instagram-nya, sehingga tidak perlu panggilan tambahan untuk menampilkan siapa yang berkomentar.

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