Log masukMulakan percubaan percuma
easyCoexistence API rasmi

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.

is_echo

Ditetapkan kepada true pada peristiwa mesej bagi mesej yang dihantar oleh akaun itu sendiri.

24 hours

Tetingkap mesej standard bagi kebanyakan tindakan pengguna, semasa aplikasi boleh membalas kepada orang tersebut.

ig_post

Jenis lampiran bagi siaran yang dikongsi; jenis kongsi lama hanya disokong sehingga 1 Februari 2026.

story_mention

Jenis lampiran bagi peristiwa DM yang Meta hantar apabila seseorang menyebut akaun dalam Story mereka.

2534041

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_reel atau reel.
  • Balasan kepada Story akaun, dengan reply_to.story, dan Story yang menyebut akaun, sebagai lampiran story_mention.
  • Balasan sebaris kepada mesej terdahulu, dengan reply_to.mid, dan balasan pantas, dengan quick_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_echo ditetapkan 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:

A messages notification, 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>",
            "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_post bagi siaran yang dikongsi menambah ig_post_media_id dan 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 serta ads_context_data bagi Click-to-Direct.
  • message.is_deleted, is_echo, is_self dan is_unsupported: disertakan hanya apabila benar.
  • message.admin_text dan handoff_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.

An echo of a message the account sent
{
  "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, dengan message_edit.mid, teks baharu dan num_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_handover dan 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.

A forwarded DM with an image
{
  "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.
Menggunakan EasyCoexistence untuk ini

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