Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram messages webhook: ang DM payload, echoes, at mga field

Ipinapadala ng messages field ng Instagram webhook ang mga DM ng professional account habang dumarating ang mga ito: text, attachments, shares, Story replies at mentions, inline replies, at deletions. Ang bawat event ay nasa messaging array, kasama ang Instagram-scoped ID ng nagpadala, ang recipient, timestamp, at object ng mensahe. Ang mga mensaheng ipinadala ng account mismo ay bumabalik sa parehong field na may is_echo na true.

Nag-subscribe ang easyCoexistence sa bawat naka-connect na Instagram account para sa messages at ipinapasa ang DM nito, kasama ang echoes, sa inyong HTTPS endpoint habang dumarating, nilagdaan ng secret ng account; walang kopyang itinatago sa pagpapasa, at hindi itinatago ang mga DM bilang default.

is_echo

Nakatakda sa true sa messages event para sa mensaheng ipinadala ng account mismo.

24 hours

Karaniwang standard messaging window para sa karamihan ng aksyon ng user, kung kailan maaaring sumagot ang app sa tao.

ig_post

Uri ng attachment para sa shared post; ang lumang share type ay suportado lamang hanggang Pebrero 1, 2026.

story_mention

Uri ng attachment ng DM event na ipinapadala ng Meta kapag may nag-mention sa account sa kanilang Story.

2534041

Error subcode, sa ilalim ng code 200, kapag naka-disable ang access ng account owner sa Instagram DMs.

Kailan nagpapadala ang messages field?

Kapag may nagpadala ng DM sa professional account, at kapag ang account mismo ang nagpadala. Ipinapakita ng mga halimbawa at reference ng Meta ang mga kasong ito, bawat isa ay isang messaging event na may object:

  • Teksto, at media bilang attachments: larawan, video, audio, at file.
  • Shared post o Reel, bilang ig_post, ig_reel, o reel attachment.
  • Reply sa Story ng account, gamit ang reply_to.story, at Story na nag-mention sa account, bilang story_mention attachment.
  • Inline reply sa naunang mensahe, gamit ang reply_to.mid, at quick reply, gamit ang quick_reply.payload.
  • Mensaheng binura ng tao (is_deleted), hindi suportadong media (is_unsupported), at mensaheng galing sa taong nag-click sa Click-to-Direct ad (referral).
  • Mensaheng ipinadala ng account, na bumabalik na may is_echo na true.

Ano ang itsura ng notification ng messages?

Isang POST na may JSON na object na instagram. Hindi tulad ng comment, ang mensahe ay nasa messaging array sa loob ng entry ng account, at bawat elemento ay may sender, recipient, timestamp, at message. Ganito ang itsura ng reply sa Story ng account:

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

Ano ang ibig sabihin ng bawat field?

Ang mga field na dokumentado ng Meta para sa messages event sa ilalim ng Instagram Login, mula sa labas papasok:

  • entry[].id: ang ID ng professional account. entry[].time: kailan ipinadala ng Meta ang notification; ibinibigay ito sa millisecond sa mga halimbawa ng Meta.
  • sender.id at recipient.id: sa papasok na DM, ang Instagram-scoped ID ng tao at ang ID ng account; sa echo, pareho ngunit baligtad.
  • timestamp: kailan ipinadala ang mensahe, sa millisecond sa mga halimbawa ng Meta. Ayusin ang mga mensahe ayon dito, hindi ayon sa pagdating.
  • message.mid: ID ng mensahe, para sa deduplication, reaction, at pag-reply sa mensaheng iyon gamit ang reply_to.mid.
  • message.text: kasama kapag may laman na teksto ang mensahe.
  • message.attachments[]: bawat isa ay may type at payload, kadalasang url. Ang payload ng ig_post ay nagdadagdag ng ig_post_media_id at title, ang caption.
  • message.reply_to: mid para sa inline reply, o story kasama ang url at id ng Story para sa reply sa Story.
  • message.quick_reply.payload at message.referral: ang napiling quick reply, at ang ref, ad_id, source, type, at ads_context_data ng Click-to-Direct ad.
  • message.is_deleted, is_echo, is_self, at is_unsupported: kasama lamang kapag true.
  • message.admin_text at handoff_reason: sa mga kwalipikadong app, isang paunawa na inilipat ng Meta application, gaya ng Meta Business Agent, ang usapan; maaari itong dumating nang walang mid o text.

Paano gumagana ang echoes?

Kapag nagpadala ng mensahe ang account, nagpapadala rin ang Meta ng messages event para dito, na may is_echo na true. Ang sender.id ay ang account at ang recipient.id ang Instagram-scoped ID ng tao, at ang test na mensaheng ipinadala ng account sa sarili ay may is_self din. Itinatala ng echoes kung ano ang sinabi ng account, na kailangan ng conversation log, ngunit dapat laktawan ng handler na nagpapasya kung sasagot. Walang echo na ipinapadala kapag nag-react ang account sa mensahe o nag-alis ng reaction.

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

Aling ID ang sasagutin?

sender.id, ang Instagram-scoped ID ng tao. Ginagawa ito ng Meta kapag may nagpadala ng DM sa account o nag-comment sa media nito, at partikular ito sa taong iyon at sa account na iyon. Ang POST /<IG_ID>/messages na may recipient.id na nakatakda rito ay nagpapadala ng reply. Walang pangalan o username ang event; ibinabalik ito ng GET /<IGSID> na may fields gaya ng name at username, dahil ang taong nakapagpadala ng DM sa account ay nagbigay na ng pahintulot na kailangan ng lookup na iyon.

Paano nagbubukas ng 24-hour window ang isang mensahe?

Makakapagpadala lamang ng mensahe ang app sa tao pagkatapos magpadala ng DM ang tao sa account, at sa loob lamang ng standard messaging window na nabubuksan ng aksyon nito. Para sa karamihan ng aksyon, 24 na oras ito, at hanggang 7 araw mula sa unang mensaheng ipinadala pagkatapos mag-click ng Click-to-Direct ad. Ang bagong mensahe mula sa tao ay nagbubukas ng bagong window, kaya ang pinakahuling timestamp niya ang dapat subaybayan; ang echo ay mensahe ng account mismo at walang pinapahaba. Ang mga reply na isinulat ng tao ay maaaring gumamit ng hiwalay na 7-day Human Agent window ng Meta, na may tag na human_agent.

Ano ang hindi dala ng messages event?

Ilang bagay na maaaring hanapin ng handler ang wala, ayon sa mga reference ng Meta para sa messaging:

  • Pangalan o username ng tao: tanging Instagram-scoped ID lamang, na nireresolba ng GET /<IGSID>.
  • Media na view-once: dumarating ito bilang ephemeral attachment na walang URL.
  • Eksaktong larawan sa carousel: ang reaction sa, o forward ng, isang larawan sa carousel post ay nag-uulat ng unang larawan.
  • Reactions, edits, at read receipts, na may sariling field.
  • Read mark: ang mensaheng naihatid sa pamamagitan ng webhook ay nananatiling unread sa Instagram inbox hanggang may ipadalang reply.

Anong iba pang messaging fields ang nakalista ng Meta?

Pinangalanan ng listahan ng field at mga halimbawa ng Meta para sa Instagram Login ang mga ito bukod sa messages, na bawat isa ay sariling messaging event. Nag-subscribe ang easyCoexistence sa bawat account para sa messages, comments, at mentions lamang, kaya wala sa mga ito ang ipinapasa nito:

  • message_reactions: nag-react ang tao sa mensahe o nag-alis ng reaction, na may reaction.mid, action na react o unreact, at ang reaction at emoji.
  • message_edit: in-edit ng tao ang mensahe, na may message_edit.mid, ang bagong teksto, at num_edit.
  • messaging_postbacks: pinindot ng tao ang icebreaker o template button, na may postback.mid, title, at payload.
  • messaging_referral: binuksan ng taong nasa usapan na ang ig.me link na may ref parameter.
  • messaging_seen: binasa ng tao ang mensahe, na may read.mid.
  • messaging_optins, messaging_handover, at standby: ang huling dalawa ay para sa mga app na nagbabahagi ng usapan sa ilalim ng handover protocol ng Meta.

Ano ang dapat i-on ng account?

Payagan ang access sa messages. Kailangang i-on ito ng Meta sa professional account bago ma-manage ang mga mensahe nito sa pamamagitan ng API, sa Instagram app sa ilalim ng Settings, Messages and story replies, Message controls, Connected tools. Habang naka-off ito, nabibigo ang mga pagpapadala na may code 200, subcode 2534041. Kailangan ding gamitin ng app ang instagram_business_basic at instagram_business_manage_messages, at may Advanced Access para makapagserbisyo sa mga account na hindi nito pag-aari o pinamamahalaan.

Paano ipinapasa ng easyCoexistence ang DM?

Tulad ng comment: bawat entry na ipinapadala ng Meta para sa account ay ipinapadala sa inyong HTTPS endpoint sa loob ng envelope ng platform, account_id, external_id, at entry, nilagdaan sa X-EC-Signature gamit ang secret ng account, isang beses at walang kopyang naiiwan. Ipinapasa rin ang echoes kasama ng iba, kaya suriin ang is_echo bago sumagot. Para sumagot, tawagin ang send_social_dm gamit ang account_id at ang sender.id ng event bilang recipient_id, sa loob ng 24-hour window. Tumatakbo sa parehong event ang mga automation na nagsisimula sa DM.

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

Mga karaniwang pagkakamali

  • Pagsagot sa echoes. Ang event na may is_echo ay mensahe ng account mismo, at ang reply dito ay magdudulot ng loop ng account sa sarili nito.
  • Pag-aakalang laging may text ang mensahe. Ang attachments, shares, Story mentions, at deletions ay dumarating na walang text field, kaya mag-branch batay sa laman ng object ng mensahe.
  • Pag-order ng mga mensahe ayon sa pagdating. Maaaring dumating nang wala sa ayos ang mga mensahe ng Meta pagkatapos ng pagkabigo, kaya i-sort ang mga ito ayon sa timestamp.
  • Pag-parse ng time at timestamp bilang segundo. Ibinibigay ng mga halimbawa ng Meta ang dalawa sa millisecond, at kung babasahin bilang segundo, nagiging petsa ang mga ito sa malayong hinaharap.
Ginagawa ito gamit ang EasyCoexistence

Sumasagot ang send_social_dm sa loob ng 24-hour window, at kayang sumagot nang kusa ang mga automation gamit ang nakatakdang teksto o AI. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Sa segundo o millisecond ba ang timestamp ng Instagram DM webhook?

Sa millisecond, ayon sa mga halimbawa ng Meta para sa messaging, pareho ang timestamp at entry time. Kapag binasa bilang segundo, nagiging petsa ito sa malayong hinaharap.

Paano ko makukuha ang username ng sender mula sa Instagram DM webhook?

Tumawag ng GET /<IGSID> na may fields gaya ng name at username. Tanging Instagram-scoped ID ng tao ang dala ng event.

Bakit hindi dumarating ang mga Instagram DM webhook ko?

Suriin kung naka-on ang Payagan ang access sa messages, kung naka-subscribe ang account sa messages sa /subscribed_apps, at kung Live ang app na may Advanced Access para sa mga account na hindi nito pag-aari.

Ipinapasa ba ng easyCoexistence ang Instagram DM reactions?

Hindi. Dumarating ang reactions sa message_reactions, at nag-subscribe ang easyCoexistence sa mga account para sa messages, comments, at mentions.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong