MasukMulai uji coba gratis
easyCoexistence API resmi

Lampiran DM Instagram dalam webhook pesan

Webhook pesan Instagram membawa media DM dalam message.attachments: sebuah array objek, masing-masing dengan type dan payload yang biasanya berisi url CDN. Daftar Meta untuk Instagram Login menyebut image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story dan share lama, dan media sekali lihat tiba sebagai lampiran sementara tanpa URL.

easyCoexistence berlangganan setiap akun Instagram yang terhubung ke messages dan meneruskan DM beserta lampirannya ke endpoint HTTPS Anda persis seperti yang dikirim Meta, ditandatangani dengan rahasia akun tersebut dan tanpa salinan yang disimpan, sehingga agen atau kode Anda mengambil media yang dibutuhkan.

ig_post

Jenis lampiran untuk postingan yang dibagikan; payload-nya menambahkan ig_post_media_id dan title, yaitu caption postingan, di samping url.

1 Feb 2026

Kapan jenis lampiran share lama berhenti didukung untuk pembagian postingan Instagram.

ephemeral

Jenis lampiran untuk media menghilang sekali lihat, yang tiba tanpa URL.

is_unsupported

Diatur ke true pada event pesan ketika pesan berisi media yang tidak didukung.

First image

Apa yang dilaporkan notifikasi saat seseorang bereaksi atau meneruskan satu gambar dari postingan carousel.

Jenis lampiran apa saja yang dapat dibawa event DM?

Contoh Instagram Login dari Meta mencantumkan nilai berikut untuk message.attachments[].type, masing-masing dengan objek payload. Sebagian besar payload berisi url ke media di CDN Meta, dan Meta mendokumentasikan field payload tambahan hanya untuk ig_post, jadi baca type sebelum payload.

imageA photo. Meta's Instagram Login list also puts GIFs and stickers under this type.
videoA video, at payload.url.
audioAudio, at payload.url.
fileA file, at payload.url.
ig_postA shared post: url, ig_post_media_id and title, its caption.
ig_reel and reelA shared Reel; Meta lists both names, each with a url.
story_mentionA Story that mentions the account, at its CDN URL.
shareThe legacy post share, supported until 1 February 2026.
media, story, ig_storyAlso in Meta's list, with no payload described.
ephemeralView-once media, sent with no URL.

Seperti apa DM dengan lampiran?

Event messages yang objek message-nya berisi attachments sebagai ganti teks, atau di samping teks. Contoh Meta mengirim dua item media dalam satu pesan, masing-masing dengan type dan payload.url sendiri, sehingga handler harus melakukan loop pada array, bukan membaca elemen pertamanya:

A DM with two attachments, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "attachments": [
              { "type": "image", "payload": { "url": "<CDN_URL>" } },
              { "type": "video", "payload": { "url": "<CDN_URL>" } }
            ]
          }
        }
      ]
    }
  ]
}

Seperti apa postingan yang dibagikan?

Lampiran ig_post. Sejak 3 November 2025 Meta mengirim pembagian postingan dengan lampiran share dan ig_post sekaligus; share didukung untuk postingan hingga 1 Februari 2026, dan Meta menyatakan integrasi baru harus mendukung ig_post. Payload-nya menambahkan media ID postingan dan caption-nya sebagai title:

The attachment of a shared post
"attachments": [
  {
    "type": "ig_post",
    "payload": {
      "ig_post_media_id": "<MEDIA_ID>",
      "title": "<POST_CAPTION>",
      "url": "<CDN_URL>"
    }
  }
]

Apa arti setiap field?

Field lampiran yang didokumentasikan Meta untuk event DM, dari array ke bawah:

  • message.attachments[]: satu objek per item media; contoh Meta memuat dua dalam satu pesan.
  • type: jenis item, dari daftar di atas. Pilah berdasarkan type sebelum membaca payload.
  • payload.url: URL CDN untuk media. Ikhtisar Meta menyebut URL ini sadar privasi: tidak mengembalikan apa pun setelah konten dihapus atau kedaluwarsa.
  • payload.ig_post_media_id dan payload.title: hanya pada ig_post, media ID postingan yang dibagikan dan caption-nya.
  • message.text: hanya ada jika pesan juga berisi teks.
  • message.is_unsupported: true ketika pesan berisi media yang tidak didukung webhook.

Berapa lama URL lampiran berfungsi?

Meta mengikatnya pada konten. Ikhtisarnya menyatakan URL CDN Instagram sadar privasi dan berhenti mengembalikan media setelah konten dihapus atau kedaluwarsa, dan panduan mention Story-nya menyatakan URL Story berhenti tampil saat Story kedaluwarsa atau dihapus. Aplikasi yang memerlukan file sebaiknya mengambilnya saat event tiba, sesuai aturan Meta: media Story, misalnya, tidak boleh disimpan atau di-cache.

Media apa yang tidak dikirim webhook?

Panduan Instagram Messaging dari Meta menyebut celah berikut, yang harus diantisipasi handler, bukan dianggap sebagai kesalahan:

  • Media menghilang, sekali lihat atau izinkan putar ulang: lampiran bertipe ephemeral, tanpa URL.
  • Media yang tidak didukung: pesan tiba dengan is_unsupported bernilai true.
  • GIF dan stiker: panduan tersebut menyatakan keduanya tidak memicu webhook, sementara contoh Instagram Login dari Meta mencantumkannya di bawah image.
  • Gambar carousel yang dipilih: reaksi terhadap, atau teruskan dari, satu gambar dalam postingan carousel melaporkan gambar pertama.
  • Pembagian secara umum: panduan messaging Meta masih menyatakan hanya URL media yang dibagikan yang disertakan, meskipun ig_post kini menambahkan media ID dan caption.

Bagaimana easyCoexistence meneruskan lampiran?

Tidak berubah, di dalam entry: DM dengan media sampai ke endpoint Anda dengan array attachments dari Meta persis seperti yang Meta kirim, dalam envelope berisi platform, account_id, external_id, dan entry, yang ditandatangani dengan X-EC-Signature. Lampiran tidak diunduh, dan event tidak disimpan secara default: akun dengan automasi yang aktif menyimpan teks DM, bukan medianya, selama 7 hari. Ambil media yang Anda butuhkan dari payload.url saat event tiba, dan jangan simpan media Story.

Kesalahan umum

  • Hanya membaca lampiran pertama. message.attachments adalah array, dan contoh Meta memuat dua item dalam satu pesan, jadi lakukan loop.
  • Masih mencocokkan type share untuk postingan yang dibagikan. Meta mendukungnya untuk postingan hingga 1 Februari 2026; baca ig_post, dengan media ID dan caption di payload-nya.
  • Menyimpan payload.url untuk diambil nanti. URL berhenti mengembalikan media setelah konten dihapus atau kedaluwarsa, jadi unduh yang diperlukan saat tiba, kecuali media Story.
  • Membaca payload.url tanpa memeriksa type. Media sekali lihat tiba sebagai ephemeral tanpa URL, dan media yang tidak didukung mengatur is_unsupported sebagai gantinya.
Melakukan ini dengan EasyCoexistence

send_social_dm membalas di dalam jendela 24 jam. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah saya menyimpan media dari lampiran DM Instagram?

Unduh yang Anda perlukan saat event tiba, karena payload.url berhenti mengembalikan media setelah konten dihapus atau kedaluwarsa. Media Story adalah pengecualian: aturan Meta menyatakan media tersebut tidak boleh disimpan atau di-cache.

Mengapa webhook DM Instagram tidak memiliki URL media?

Biasanya karena media bersifat sekali lihat, yang tiba sebagai lampiran ephemeral tanpa URL, atau tidak didukung, yang mengatur is_unsupported menjadi true.

Apakah GIF dan stiker Instagram memicu webhook pesan?

Dokumentasi Meta tidak sepakat: contoh Instagram Login mencantumkan GIF dan stiker di bawah image, sedangkan panduan Instagram Messaging menyatakan keduanya tidak memicu webhook. Uji dengan akun sungguhan.

Bisakah satu event DM Instagram membawa beberapa lampiran?

Bisa. message.attachments adalah array, dan contoh Meta menunjukkan dua item media dalam satu pesan.

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