MasukMulai uji coba gratis
easyCoexistence API resmi

Event webhook Instagram: komentar, mention dan DM

Event webhook Instagram melaporkan aktivitas pada akun profesional saat terjadi: komentar baru, @mention, dan DM. Meta mengirim tiap event sebagai JSON melalui POST ke endpoint HTTPS aplikasi yang terhubung dan mencoba kembali pengiriman yang gagal ke endpoint tersebut hingga 36 jam. easyCoexistence meneruskan tiap event ke endpoint Anda sekali, ditandatangani per akun, tanpa mencoba kembali. Dengan Instagram Login, mention datang di dalam notifikasi komentar.

36 hours

Berapa lama Meta terus mencoba kembali pengiriman yang gagal ke endpoint aplikasi sebelum membuangnya.

1,000

Sebagian besar pembaruan dikelompokkan Meta menjadi satu pengiriman webhook, meski Meta tidak menjamin pengelompokan.

is_echo

Penanda yang ditetapkan Meta pada event pesan yang dikirim oleh akun itu sendiri.

Public

Hanya media pada akun publik yang memicu notifikasi komentar dan mention.

Event apa saja yang ada?

Untuk akun profesional yang terhubung dengan Instagram Login, tiga jenis aktivitas datang sebagai event:

  • Komentar: komentar baru pada media akun, dengan ID komentar, ID cakupan Instagram dan username penulis, teksnya, serta ID dan tipe media.
  • Mention: dengan Instagram Login, mention datang di dalam notifikasi komentar, bukan sebagai field tersendiri.
  • Pesan: DM ke akun, dengan pengirim, penerima, timestamp dan pesannya sendiri, termasuk teks, lampiran dan balasan Story.

Bagaimana event sampai ke endpoint Anda?

Meta mengirim webhook Instagram ke aplikasi tempat akun terhubung. easyCoexistence menerimanya dan meneruskan setiap event ke endpoint HTTPS yang Anda atur untuk akun tersebut, begitu event tiba, ditandatangani dengan rahasia milik akun itu.

Atur endpoint dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API melalui PUT /channels/:id/webhook. Rahasia penandatanganan ditampilkan sekali, mengatur ulang endpoint akan menerbitkan rahasia baru, dan mengirim null sebagai URL mematikan penerusan.

Seperti apa sebuah pengiriman?

Berupa POST dengan body JSON yang memuat platform, account_id yang diberikan list_social_accounts untuk koneksi itu, external_id akun Instagram, dan entry: entry webhook Meta untuk event tersebut, tanpa perubahan. DM datang dengan cara yang sama, dengan array messaging sebagai ganti changes. Komentar baru terlihat seperti ini:

A forwarded comment event
{
  "platform": "instagram",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<INSTAGRAM_ACCOUNT_ID>",
  "entry": {
    "id": "<INSTAGRAM_ACCOUNT_ID>",
    "time": 1793318400,
    "changes": [
      {
        "field": "comments",
        "value": {
          "id": "<COMMENT_ID>",
          "from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
          "text": "<COMMENT_TEXT>",
          "media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
        }
      }
    ]
  }
}

Bagaimana cara memverifikasi pengiriman?

Setiap pengiriman membawa header X-EC-Signature dalam bentuk t=<unix>,v1=<hex>, di mana v1 adalah HMAC-SHA256 dari timestamp, titik, lalu body permintaan mentah, dengan kunci rahasia penandatanganan akun. Hitung di atas body mentah persis seperti diterima, bandingkan dengan waktu konstan, dan tolak timestamp yang lebih tua dari 5 menit.

Node.js: verifying X-EC-Signature
import crypto from "node:crypto";

// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
  const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
  if (!sig.t || !sig.v1) return false;
  if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(sig.t + "." + rawBody)
    .digest("hex");
  return expected.length === sig.v1.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}

Apakah pengiriman dicoba kembali?

Tidak oleh easyCoexistence: penerusan mengirim setiap event sekali, di memori, dan tidak menyimpan salinan untuk dicoba ulang. Balas dengan 2xx segera dan kerjakan setelahnya, serta simpan apa pun yang Anda butuhkan saat event tiba, karena Meta juga tidak menyimpan riwayat notifikasi lama yang bisa dikueri.

Meta sendiri mencoba kembali pengiriman ke aplikasi yang gagal hingga 36 jam, sehingga event yang sama sesekali bisa sampai dua kali: lakukan deduplikasi berdasarkan ID komentar atau mid pesan.

Apa lagi yang perlu diperiksa handler?

Beberapa detail pada payload Meta yang sering menjebak handler pertama kali:

  • is_echo: event pesan dengan is_echo bernilai true dikirim oleh akun itu sendiri, sehingga tidak perlu dibalas.
  • Balasan Story: DM yang menjawab Story membawa reply_to dengan ID dan URL Story tersebut.
  • Mention Story: datang sebagai pesan dengan tipe lampiran story_mention.
  • time: kapan Meta mengirim notifikasi, bukan kapan komentar atau pesan dibuat; timestamp pesan ada di entry messaging-nya.
  • ID album: event komentar tidak menyertakannya; cari album dengan ID komentar.

Kesalahan umum

  • Mengerjakan tugas sebelum membalas. Penerusan tidak mencoba ulang, jadi kembalikan 2xx segera dan proses event setelahnya.
  • Memverifikasi tanda tangan pada JSON yang sudah diurai. Hitung HMAC di atas body mentah persis seperti diterima.
  • Membalas echo. Event pesan dengan is_echo bernilai true adalah pesan yang dikirim akun itu, dan membalasnya memulai loop.
  • Melewatkan deduplikasi. Meta bisa mengirim ulang event yang sama setelah kegagalan, jadi gunakan ID komentar atau mid pesan sebagai kunci.
Melakukan ini dengan EasyCoexistence

easyCoexistence meneruskan komentar, mention dan DM akun Instagram ke endpoint HTTPS Anda begitu tiba, ditandatangani dengan rahasia untuk akun itu dan tanpa salinan yang disimpan di perjalanan. Aktifkan dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apa arti field time dalam webhook Instagram?

Kapan Meta mengirim notifikasi, bukan kapan komentar atau pesan dibuat. Timestamp DM ada di entry messaging-nya.

Apakah Meta mencoba kembali pengiriman webhook Instagram yang gagal?

Ya. Meta mencoba kembali pengiriman yang gagal ke aplikasi hingga 36 jam, sehingga event yang sama sesekali bisa datang dua kali: lakukan deduplikasi berdasarkan ID komentar atau mid pesan. easyCoexistence meneruskan setiap event ke endpoint Anda sekali, jadi balas dengan 2xx segera.

Berapa banyak pembaruan yang bisa dimuat satu pengiriman webhook Instagram?

Hingga 1,000 jika Meta mengelompokkannya, meski Meta tidak menjamin pengelompokan. Lakukan perulangan pada seluruh array entry, jangan hanya membaca item pertamanya.

Apakah mention punya event sendiri?

Tidak dengan Instagram Login. Meta menyertakan mention dalam notifikasi komentar, sehingga datang lewat jalur yang sama dengan komentar.

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