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.
Jenis lampiran bagi siaran yang dikongsi; payloadnya menambah ig_post_media_id dan title, iaitu kapsyen siaran itu, di sebelah url.
Bila jenis lampiran share lama berhenti disokong bagi perkongsian siaran Instagram.
Jenis lampiran bagi media yang lenyap selepas dilihat, sekali lihat, yang tiba tanpa URL.
Ditetapkan kepada true pada acara mesej apabila mesej mengandungi media yang tidak disokong.
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.
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:
{
"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:
"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_iddan payload.title: untukig_postsahaja, 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_unsupportedditetapkan 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_postkini 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.
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