Webhook mesej Instagram: muatan DM, gema dan medan
Medan mesej webhook Instagram menghantar DM akaun profesional sebaik sahaja tiba: teks, lampiran, kongsian, balasan Story dan sebutan, balasan sebaris serta pemadaman. Setiap peristiwa berada dalam tatasusunan messaging dengan ID pengirim berskop Instagram, penerima, cap masa dan objek mesej, dan mesej yang dihantar oleh akaun itu sendiri datang pada medan yang sama dengan is_echo ditetapkan kepada true.
easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada mesej dan memajukan DM-nya, termasuk gema, ke endpoint HTTPS anda sebaik sahaja tiba, ditandatangani dengan rahsia akaun itu; penghantaran tidak menyimpan salinan, dan DM tidak disimpan secara lalai.
Ditetapkan kepada true pada peristiwa mesej bagi mesej yang dihantar oleh akaun itu sendiri.
Tetingkap mesej standard bagi kebanyakan tindakan pengguna, semasa aplikasi boleh membalas kepada orang tersebut.
Jenis lampiran bagi siaran yang dikongsi; jenis kongsi lama hanya disokong sehingga 1 Februari 2026.
Jenis lampiran bagi peristiwa DM yang Meta hantar apabila seseorang menyebut akaun dalam Story mereka.
Subkod ralat, di bawah kod 200, apabila pemilik akaun telah melumpuhkan akses kepada mesej langsung Instagram.
Bilakah medan mesej dicetuskan?
Apabila seseorang menghantar DM kepada akaun profesional, dan apabila akaun itu menghantar satu. Contoh dan rujukan Meta menyenaraikan kes berikut, setiap satu sebagai peristiwa mesej dengan objek mesej:
- Teks, dan media sebagai lampiran: imej, video, audio dan fail.
- Siaran atau Reel yang dikongsi, sebagai lampiran
ig_post,ig_reelatau reel. - Balasan kepada Story akaun, dengan
reply_to.story, dan Story yang menyebut akaun, sebagai lampiranstory_mention. - Balasan sebaris kepada mesej terdahulu, dengan
reply_to.mid, dan balasan pantas, denganquick_reply.payload. - Mesej yang dipadam oleh orang itu (
is_deleted), media tidak disokong (is_unsupported), dan mesej daripada seseorang yang mengklik iklan Click-to-Direct (referral). - Mesej yang dihantar oleh akaun, yang datang semula dengan
is_echoditetapkan kepada true.
Bagaimana rupa notifikasi mesej?
POST dengan JSON yang objeknya ditetapkan kepada instagram. Tidak seperti komen, mesej berada dalam tatasusunan messaging di dalam entri akaun, dan setiap elemen membawa sender, recipient, timestamp dan message. Balasan kepada Story akaun kelihatan seperti ini:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}Apa maksud setiap medan?
Medan yang didokumenkan Meta untuk peristiwa mesej di bawah Instagram Login, dari luar ke dalam:
- entry[].id: ID akaun profesional. entry[].time: bila Meta menghantar notifikasi; sampel mesej Meta memberinya dalam milisaat.
- sender.id dan recipient.id: pada DM masuk, ID berskop Instagram orang itu dan ID akaun; pada gema, dua nilai yang sama tetapi terbalik.
- timestamp: bila mesej dihantar, dalam milisaat dalam sampel Meta. Susun mesej mengikut medan ini, bukan mengikut urutan tiba.
- message.mid: ID mesej, untuk penyahduplikatan, bertindak balas dan membalas mesej itu dengan
reply_to.mid. - message.text: disertakan apabila mesej mengandungi teks.
- message.attachments[]: setiap satu dengan type dan payload, biasanya url. Payload
ig_postbagi siaran yang dikongsi menambahig_post_media_iddan title, iaitu kapsyennya. - message.
reply_to: mid bagi balasan sebaris, atau story dengan url dan id Story bagi balasan Story. - message.
quick_reply.payload dan message.referral: balasan pantas yang dipilih, dan ref,ad_id, source, type sertaads_context_databagi Click-to-Direct. - message.
is_deleted,is_echo,is_selfdanis_unsupported: disertakan hanya apabila benar. - message.
admin_textdanhandoff_reason: pada aplikasi yang layak, notis bahawa aplikasi Meta, seperti Meta Business Agent, telah menyerahkan perbualan; ia boleh tiba tanpa mid atau teks.
Bagaimana gema berfungsi?
Apabila akaun menghantar mesej, Meta turut menghantar peristiwa mesej untuknya, dengan is_echo ditetapkan kepada true. sender.id kemudiannya ialah akaun dan recipient.id ialah ID berskop Instagram orang itu, dan mesej ujian yang akaun hantar kepada dirinya sendiri turut membawa is_self. Gema merekod apa yang dikatakan akaun, yang diperlukan oleh log perbualan, tetapi pengendali yang memutuskan sama ada hendak membalas mesti melangkau gema. Meta tidak menghantar gema apabila akaun bertindak balas kepada mesej atau membuang reaksi.
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}ID manakah yang anda balas?
sender.id, ID berskop Instagram orang itu. Meta mencipta ID ini apabila seseorang menghantar mesej kepada akaun atau mengulas media akaun, dan ia khusus kepada orang itu dan akaun itu. POST /<IG_ID>/messages dengan recipient.id ditetapkan kepadanya menghantar balasan. Peristiwa itu tidak membawa nama atau nama pengguna; GET /<IGSID> dengan medan seperti name dan username memulangkannya, kerana seseorang yang telah menghantar mesej kepada akaun telah memberi persetujuan yang diperlukan oleh carian itu.
Bagaimana mesej membuka tetingkap 24 jam?
Sesuatu aplikasi hanya boleh menghantar mesej kepada seseorang selepas orang itu menghantar mesej kepada akaun, dan hanya dalam tetingkap mesej standard yang dibuka oleh tindakan mereka. Bagi kebanyakan tindakan ia berlangsung 24 jam, dan sehingga 7 hari dari mesej pertama yang dihantar selepas mengklik iklan Click-to-Direct. Mesej baharu daripada orang itu membuka tetingkap baharu, jadi cap masa terkini mereka yang perlu dijejaki; gema ialah mesej akaun sendiri dan tidak memanjangkan apa-apa. Balasan yang ditulis oleh seseorang boleh menggunakan tetingkap Human Agent 7 hari yang berasingan milik Meta, ditanda human_agent.
Apa yang tidak dibawa oleh peristiwa mesej?
Beberapa perkara yang mungkin dicari oleh pengendali tiada, menurut rujukan mesej Meta:
- Nama atau nama pengguna orang itu: hanya ID berskop Instagram, yang diselesaikan oleh GET /<IGSID>.
- Media lihat-sekali: ia tiba sebagai lampiran sementara tanpa URL.
- Imej karusel yang tepat: reaksi kepada, atau pemajuan, satu imej dalam siaran karusel melaporkan imej pertama.
- Reaksi, suntingan dan resit baca, yang datang pada medan tersendiri.
- Tanda dibaca: mesej yang dihantar melalui webhook kekal tidak dibaca dalam peti masuk Instagram sehingga balasan dihantar.
Medan mesej lain yang disenaraikan Meta?
Senarai medan dan contoh Meta untuk Instagram Login menamakan medan lain selain mesej, setiap satu sebagai peristiwa mesej tersendiri. easyCoexistence melanggan setiap akaun hanya kepada mesej, komen dan sebutan, jadi tiada satu pun daripadanya termasuk dalam apa yang diteruskannya:
message_reactions: seseorang bertindak balas kepada mesej atau membuang reaksi, dengan reaction.mid, action ditetapkan kepada react atau unreact, serta reaction dan emoji.message_edit: seseorang menyunting mesej, denganmessage_edit.mid, teks baharu dannum_edit.messaging_postbacks: seseorang mengetik icebreaker atau butang template, dengan postback.mid, title dan payload.messaging_referral: seseorang yang sudah berada dalam perbualan membuka pautan ig.me dengan parameter ref.messaging_seen: seseorang membaca mesej, dengan read.mid.messaging_optins,messaging_handoverdan standby: dua yang terakhir untuk aplikasi yang berkongsi perbualan di bawah protokol serah Meta.
Apa yang mesti dihidupkan oleh akaun?
Benarkan akses kepada mesej. Meta memerlukan akaun profesional menghidupkannya sebelum mesejnya boleh diurus melalui API, dalam aplikasi Instagram di bawah Tetapan, Mesej dan balasan Story, Kawalan mesej, Alat yang disambungkan. Semasa ia dimatikan, penghantaran gagal dengan kod 200, subkod 2534041. Aplikasi juga memerlukan instagram_business_basic dan instagram_business_manage_messages, dengan Advanced Access untuk melayani akaun yang tidak dimilikinya atau diurusnya.
Bagaimana easyCoexistence meneruskan DM?
Sama seperti komen: setiap entri yang Meta hantar untuk akaun dihantar melalui POST ke endpoint HTTPS anda dalam sampul platform, account_id, external_id dan entry, ditandatangani dalam X-EC-Signature dengan rahsia akaun, sekali sahaja dan tanpa salinan disimpan. Gema diteruskan bersama yang lain, jadi semak is_echo sebelum membalas. Untuk menjawab, panggil send_social_dm dengan account_id dan sender.id peristiwa sebagai recipient_id, dalam tetingkap 24 jam. Automasi yang bermula pada DM berjalan pada peristiwa yang sama.
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"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": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}Kesilapan biasa
- Membalas gema. Peristiwa dengan is_echo ditetapkan ialah mesej akaun sendiri, dan membalasnya menghantar akaun ke dalam gelung dengan dirinya sendiri.
- Mengandaikan mesej sentiasa ada teks. Lampiran, kongsian, sebutan Story dan pemadaman tiba tanpa medan teks, jadi bercabanglah berdasarkan apa yang dikandungi objek mesej.
- Menyusun mesej mengikut urutan tiba. Meta boleh menghantar mesej tidak mengikut urutan selepas kegagalan, jadi susunlah mengikut cap masa.
- Menghuraikan time dan timestamp sebagai saat. Sampel mesej Meta memberi kedua-duanya dalam milisaat, dan jika dibaca sebagai saat ia menjadi tarikh yang jauh di masa depan.
send_social_dm membalas dalam tetingkap 24 jam, dan automasi boleh membalas sendiri dengan teks tetap atau AI. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari percubaan percuma pertama.
Soalan lazim
Adakah cap masa webhook mesej Instagram dalam saat atau milisaat?
Milisaat, dalam sampel mesej Meta, untuk kedua-dua timestamp dan masa entri. Jika dibaca sebagai saat, ia bertukar menjadi tarikh yang jauh di masa depan.
Bagaimana saya mendapatkan nama pengguna pengirim daripada DM webhook Instagram?
Panggil GET /<IGSID> dengan medan seperti name dan username. Peristiwa itu hanya membawa ID berskop Instagram orang tersebut.
Mengapa webhook DM Instagram saya tidak tiba?
Semak sama ada akaun telah menghidupkan Benarkan akses kepada mesej, sama ada ia dilanggan kepada mesej melalui /subscribed_apps, dan sama ada aplikasi itu Live dengan Advanced Access untuk akaun yang tidak dimilikinya.
Adakah easyCoexistence meneruskan reaksi mesej Instagram?
Tidak. Reaksi datang pada message_reactions, dan easyCoexistence melanggan akaun kepada mesej, komen dan sebutan.
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