Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Lampiran DM Instagram dalam webhook mesej

Webhook mesej Instagram membawa media DM dalam message.attachments: satu tatasusunan objek, setiap satunya dengan type dan payload yang biasanya mengandungi url CDN. Senarai Meta untuk Instagram Login menamakan 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 ephemeral tanpa URL.

easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada mesej dan memajukan DM beserta lampirannya ke endpoint HTTPS anda seperti yang Meta hantar, ditandatangani dengan rahsia akaun itu dan tanpa sebarang salinan disimpan, supaya ejen atau kod anda mengambil media yang diperlukan.

ig_post

Jenis lampiran bagi siaran yang dikongsi; payloadnya menambah ig_post_media_id dan title, iaitu kapsyen siaran itu, di sebelah url.

1 Feb 2026

Bila jenis lampiran share lama berhenti disokong bagi perkongsian siaran Instagram.

ephemeral

Jenis lampiran bagi media yang lenyap selepas dilihat, sekali lihat, yang tiba tanpa URL.

is_unsupported

Ditetapkan kepada true pada acara mesej apabila mesej mengandungi media yang tidak disokong.

First image

Apa yang dilaporkan pemberitahuan apabila seseorang bertindak balas kepada atau memajukan satu imej daripada siaran karusel.

Jenis lampiran apakah yang boleh dibawa acara DM?

Contoh Instagram Login Meta menyenaraikan nilai ini bagi message.attachments[].type, setiap satu dengan objek payload. Kebanyakan payload mengandungi url ke media di CDN Meta, dan Meta mendokumentasikan medan payload tambahan bagi ig_post sahaja, jadi bacalah 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.

Bagaimana rupa DM dengan lampiran?

Acara mesej yang objek mesejnya mengandungi attachments dan bukannya teks, atau bersama teks. Contoh Meta menghantar dua item media dalam satu mesej, setiap satunya dengan type dan payload.url sendiri, jadi pengendali perlu melalui tatasusunan itu dan bukan membaca elemen pertamanya sahaja:

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>" } }
            ]
          }
        }
      ]
    }
  ]
}

Bagaimana rupa siaran yang dikongsi?

Lampiran ig_post. Daripada 3 November 2025, Meta menghantar perkongsian siaran dengan kedua-dua lampiran share dan ig_post; share disokong bagi siaran sehingga 1 Februari 2026, dan Meta menyatakan integrasi baharu mesti menyokong ig_post. Payloadnya menambah ID media siaran dan kapsyennya 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 maksud setiap medan?

Medan lampiran yang didokumentasikan Meta bagi acara DM, daripada tatasusunan ke bawah:

  • message.attachments[]: satu objek bagi setiap item media; contoh Meta membawa dua dalam satu mesej.
  • type: jenis item, daripada senarai di atas. Bercabanglah mengikut jenisnya sebelum membaca payload.
  • payload.url: URL CDN bagi media. Gambaran keseluruhan Meta menamakan URL ini mengambil kira privasi; ia tidak memulangkan apa-apa selepas kandungan dipadam atau tamat tempoh.
  • payload.ig_post_media_id dan payload.title: untuk ig_post sahaja, ID media siaran yang dikongsi dan kapsyennya.
  • message.text: hadir hanya apabila mesej juga mengandungi teks.
  • message.is_unsupported: true apabila mesej mengandungi media yang tidak disokong oleh webhook.

Berapa lama URL lampiran berfungsi?

Meta mengikatnya kepada kandungan. Gambaran keseluruhannya menyatakan URL CDN Instagram mengambil kira privasi dan berhenti memulangkan media apabila kandungan telah dipadam atau tamat tempoh, dan panduan mention Story menyatakan URL Story berhenti dipaparkan apabila Story tamat tempoh atau dipadam. Aplikasi yang memerlukan fail patut mengambilnya apabila acara tiba, dalam peraturan Meta: media Story, sebagai contoh, tidak boleh disimpan atau disimpan dalam cache.

Media apa yang tidak dimasukkan oleh webhook?

Panduan Pemesejan Instagram Meta menamakan jurang ini, yang patut dijangka oleh pengendali dan bukan dilayan sebagai ralat:

  • Media yang lenyap: sekali lihat atau benarkan main semula, iaitu lampiran berjenis ephemeral tanpa URL.
  • Media tidak disokong: mesej tiba dengan is_unsupported ditetapkan kepada true.
  • GIF dan pelekat: panduan itu menyatakan ia tidak mencetuskan webhook, manakala contoh Instagram Login Meta menyenaraikannya di bawah image.
  • Imej karusel yang dipilih: tindak balas kepada, atau pemajuan, satu imej dalam siaran karusel melaporkan imej pertama.
  • Perkongsian secara umum: panduan pemesejan Meta masih menyatakan hanya URL media yang dikongsi disertakan, walaupun ig_post kini menambah ID media dan kapsyen.

Bagaimana easyCoexistence memajukan lampiran?

Tidak berubah, di dalam entry: DM dengan media sampai ke endpoint anda dengan tatasusunan attachments Meta seperti yang dihantar oleh Meta, dalam sampul platform, account_id, external_id dan entry, ditandatangani dengan X-EC-Signature. Lampiran tidak dimuat turun, dan acara tidak disimpan secara lalai: akaun yang automasinya dihidupkan menyimpan teks DM, bukan medianya, selama 7 hari. Ambil media yang anda perlukan daripada payload.url apabila acara tiba, dan jangan simpan media Story.

Kesilapan biasa

  • Hanya membaca lampiran pertama. message.attachments ialah tatasusunan, dan contoh Meta membawa dua item dalam satu mesej, jadi lalui setiap elemen tatasusunan itu.
  • Masih memadankan type share bagi siaran yang dikongsi. Meta menyokongnya bagi siaran sehingga 1 Februari 2026; baca ig_post, dengan ID media dan kapsyen dalam payloadnya.
  • Menyimpan payload.url untuk diambil kemudian. Ia berhenti memulangkan media apabila kandungan dipadam atau tamat tempoh, jadi muat turun apa yang anda perlukan ketika tiba, kecuali media Story.
  • Membaca payload.url tanpa memeriksa jenis. Media sekali lihat tiba sebagai ephemeral tanpa URL, dan media tidak disokong menetapkan is_unsupported.
Menggunakan EasyCoexistence untuk ini

send_social_dm membalas dalam tetingkap 24 jam. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.

Soalan lazim

Bolehkah saya menyimpan media daripada lampiran DM Instagram?

Muat turun apa yang anda perlukan apabila acara tiba, kerana payload.url berhenti memulangkan media apabila kandungan dipadam atau tamat tempoh. Media Story ialah pengecualian: peraturan Meta menyatakan ia tidak boleh disimpan atau disimpan dalam cache.

Mengapa webhook DM Instagram tiada URL media?

Biasanya kerana media itu sekali lihat, yang tiba sebagai lampiran ephemeral tanpa URL, atau tidak disokong, yang menetapkan is_unsupported kepada true.

Adakah GIF dan pelekat Instagram mencetuskan webhook mesej?

Dokumen Meta tidak sepakat: contoh Instagram Login menyenaraikan GIF dan pelekat di bawah image, manakala panduan Pemesejan Instagram menyatakan ia tidak mencetuskan webhook. Uji dengan akaun sebenar.

Bolehkah satu acara DM Instagram membawa beberapa lampiran?

Boleh. message.attachments ialah tatasusunan, dan contoh Meta menunjukkan dua item media dalam satu mesej.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada