පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
easyCoexistence නිල API

messages webhook එකේ Instagram DM attachments

Instagram හි messages webhook එක DM media message.attachments තුළ ගෙන යයි: එක් එක් object එකට type එකක් සහ සාමාන්‍යයෙන් CDN url එකක් අඩංගු payload එකක් ඇති object array එකක්. Instagram Login සඳහා Meta ලැයිස්තුගත කරන්නේ image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story සහ පැරණි share වර්ග ය. View-once media URL එකක් නැති ephemeral attachment එකක් ලෙස ලැබේ.

easyCoexistence සම්බන්ධ කළ එක් එක් Instagram ගිණුමක් messages වලට subscribe කර, attachments සහිත DM වල් Meta යවන ආකාරයටම ඔබේ HTTPS endpoint එකට forward කරයි, එම ගිණුමේ රහස් යතුරෙන් අත්සන් කර, කිසිදු පිටපතක් තබා නොගෙන, එවිට ඔබේ agent හෝ code එකට අවශ්‍ය media ලබා ගත හැක.

ig_post

shared post සඳහා attachment වර්ගය; එහි payload එකට url අමතරව ig_post_media_id සහ post හි caption එක වන title එකත් එකතු වේ.

1 Feb 2026

Instagram post shares සඳහා පැරණි share attachment වර්ගය සහාය නොවීමට ගිය දිනය.

ephemeral

අතුරුදහන් වන, view-once media හි attachment වර්ගය, URL එකක් නොමැතිව ලැබේ.

is_unsupported

message event එකක, message එකේ සහාය නොදක්වන media ඇති විට, is_unsupported true ලෙස සකසනු ලැබේ.

First image

carousel post එකේ එක් image එකකට කෙනෙකු react කරන හෝ forward කරන විට notification එකෙන් වාර්තා වන්නේ.

DM event එකකට කුමන attachment වර්ග ඇතුළත් විය හැකිද?

Meta හි Instagram Login උදාහරණ message.attachments[].type සඳහා මේ අගයන් ලැයිස්තුගත කරයි, එක් එක් අගයට payload object එකක්. බොහෝ payload වල Meta CDN හි media වෙත url එකක් ඇත, සහ Meta ig_post සඳහා පමණක් අමතර payload fields ලේඛනගත කර ඇති නිසා, payload එක කියවීමට පෙර type එක කියවන්න.

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.

attachment සහිත DM එකක් කෙසේ පෙනේද?

message object එකේ text වෙනුවට හෝ ඒ අසල attachments ඇති messages event එකකි. Meta හි උදාහරණයේ එක් message එකක media අයිතම දෙකක් යවා ඇත, එක් එක් අයිතමයට තමන්ගේම type සහ payload.url ඇත, එබැවින් handler එක පළමු element එක කියවනවා වෙනුවට array එක හරහා loop කළ යුතු වේ:

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

shared post එකක් කෙසේ පෙනේද?

ig_post attachment එකකි. 2025 නොවැම්බර් 3 සිට Meta post shares යවන්නේ share සහ ig_post යන attachment දෙකෙන්ම ය; share වර්ගය post සඳහා 2026 පෙබරවාරි 1 දක්වා සහාය විය, සහ නව integrations ig_post සහාය දැක්විය යුතු බව Meta පවසයි. එහි payload එකට post හි media ID සහ caption එක title ලෙස එකතු වේ:

The attachment of a shared post
"attachments": [
  {
    "type": "ig_post",
    "payload": {
      "ig_post_media_id": "<MEDIA_ID>",
      "title": "<POST_CAPTION>",
      "url": "<CDN_URL>"
    }
  }
]

එක් එක් field එකෙන් අදහස් වන්නේ කුමක්ද?

DM event එක සඳහා Meta ලේඛනගත කරන attachment fields, array එකේ සිට පහළට:

  • message.attachments[]: media අයිතමයකට එක් object එකක්; Meta හි උදාහරණයේ එක message එකක දෙකක් ඇත.
  • type: අයිතමය කුමක්ද යන්න, ඉහත ලැයිස්තුවෙන්. payload කියවීමට පෙර එය මත branch කරන්න.
  • payload.url: media සඳහා CDN URL එකක්. Meta හි overview මෙම URL privacy-aware ලෙස හඳුන්වයි: content මකා දැමූ හෝ කල් ඉකුත් වූ පසු ඒවා කිසිවක් ආපසු නොදෙයි.
  • payload.ig_post_media_id සහ payload.title: ig_post මත පමණක්, shared post හි media ID සහ එහි caption.
  • message.text: message එකේ text ද ඇති විට පමණක් පවතී.
  • message.is_unsupported: message එකේ webhook සහාය නොදක්වන media ඇති විට true.

attachment URL කොපමණ කාලයක් ක්‍රියා කරයිද?

Meta ඒවා content එකට බැඳ තබයි. Instagram CDN URLs privacy-aware බව ඔවුන්ගේ overview පවසයි, content මකා දැමූ හෝ කල් ඉකුත් වූ පසු media ආපසු නොදෙයි; සහ Story mention මාර්ගෝපදේශය පවසන්නේ Story එක කල් ඉකුත් වූ හෝ මකා දැමූ විට එහි URL රේන්ඩර් වීම නවතින බවයි. ගොනුවක් අවශ්‍ය app එකක් event එක පැමිණෙන විට එය ලබා ගත යුතුය, Meta හි නීති ඇතුළත: Story media, උදාහරණයක් ලෙස, ගබඩා කළ නොහැක හෝ cache කළ නොහැක.

webhook එකෙන් කුමන media ඉවත් වේද?

Meta හි Instagram Messaging මාර්ගෝපදේශය මෙම හිඩැස් නම් කරයි, handler එක ඒවා දෝෂ ලෙස නොසලකා, ඒවා අපේක්ෂා කළ යුතුය:

  • Disappearing media, view once හෝ replay ඉඩ දෙන: ephemeral වර්ගයේ attachment එකක්, URL එකක් නැතිව.
  • Unsupported media: message එක is_unsupported true ලෙස සකසා ලැබේ.
  • GIFs සහ stickers: එම මාර්ගෝපදේශය පවසන්නේ ඒවා webhook එකක් trigger නොකරන බවයි, Meta හි Instagram Login උදාහරණ ඒවා image යටතේ ලැයිස්තුගත කරන අතරම.
  • carousel post එකක එක් image එකකට react කිරීම හෝ forward කිරීම, පළමු image එක වාර්තා කරයි.
  • පොදුවේ shares: Meta හි messaging මාර්ගෝපදේශ තවමත් පවසන්නේ shared media හි URL පමණක් ඇතුළත් වන බවයි, නමුත් ig_post දැන් media ID සහ caption එකතු කරයි.

easyCoexistence attachments කෙසේ forward කරයිද?

entry තුළ වෙනස් නොකර: media සහිත DM එකක් Meta එවූ ආකාරයෙන්ම Meta හි attachments array එක සමඟ, platform, account_id, external_id සහ entry අඩංගු envelope එකක දී, X-EC-Signature සමඟ අත්සන් කර, ඔබේ endpoint එකට පැමිණේ. Attachments බාගත නොකෙරේ, සහ සිදුවීම් පෙරනිමියෙන් ගබඩා නොකෙරේ: ස්වයංක්‍රීයකරණයක් ක්‍රියාත්මක ගිණුමක් DM එකේ පෙළ, එහි media නොව, දින 7ක් තබා ගනී. සිදුවීම පැමිණෙන විට payload.url වෙතින් ඔබට අවශ්‍ය media ලබා ගන්න, සහ Story media ගබඩා නොකර තබන්න.

සාමාන්‍ය වැරදි

  • පළමු attachment එක පමණක් කියවීම. message.attachments යනු array එකකි, සහ Meta හි උදාහරණයේ එක් message එකක අයිතම දෙකක් ඇත, එබැවින් ඒ හරහා loop කරන්න.
  • shared post සඳහා share type එක තවමත් ගැලපීම. Meta එය post සඳහා 2026 පෙබරවාරි 1 දක්වා සහාය විය; ig_post කියවන්න, media ID සහ caption එක එහි payload එකේ.
  • පසුව ලබා ගැනීමට payload.url සුරැකීම. content මකා දැමූ හෝ කල් ඉකුත් වූ පසු එය media ආපසු නොදෙයි, එබැවින් පැමිණි විට ඔබට අවශ්‍ය දේ බාගත කරන්න, Story media හැර.
  • type පරීක්ෂා නොකර payload.url කියවීම. View-once media ephemeral ලෙස URL එකක් නැතිව පැමිණේ, සහ unsupported media ඒ වෙනුවට is_unsupported සකසයි.
EasyCoexistence සමඟ මෙය කිරීම

send_social_dm පැය 24ක කවුළුව තුළ පිළිතුරු දෙයි. US$ 9 සිට US$ 0.75 දක්වා සම්බන්ධතාවයකට මාසිකව, සම්බන්ධතා එකතු කරන තරම් අඩු වෙමින්, දින 3ක නොමිලේ trial කාලය සමඟ.

නිතර අසන ප්‍රශ්න

Instagram DM attachment එකකින් media ගබඩා කළ හැකිද?

Event එක පැමිණෙන විට ඔබට අවශ්‍ය දේ බාගත කරන්න, මන්ද payload.url content මකා දැමූ හෝ කල් ඉකුත් වූ පසු media ආපසු නොදෙන නිසා. Story media ව්‍යතිරේකයයි: Meta හි නීති පවසන්නේ එය ගබඩා කළ හෝ cache කළ නොහැකි බවයි.

Instagram DM webhook එකට media URL එකක් නැත්තේ ඇයි?

සාමාන්‍යයෙන් media view-once නිසා, එය URL එකක් නැති ephemeral attachment එකක් ලෙස පැමිණේ, නැතහොත් unsupported නිසා, එය is_unsupported true ලෙස සකසයි.

Instagram GIFs සහ stickers messages webhook එක trigger කරනවාද?

Meta හි ලේඛන එකඟ නොවේ: එහි Instagram Login උදාහරණ GIFs සහ stickers image යටතේ ලැයිස්තුගත කරන අතර, එහි Instagram Messaging මාර්ගෝපදේශය පවසන්නේ ඒවා webhook එකක් trigger නොකරන බවයි. සැබෑ ගිණුමකින් පරීක්ෂා කරන්න.

එක් Instagram DM event එකකට attachments කිහිපයක් ගෙන යා හැකිද?

හැකිය. message.attachments යනු array එකකි, සහ Meta හි උදාහරණයේ එක් message එකක media අයිතම දෙකක් පෙන්වයි.

තවදුරටත් කියවන්න

ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.

වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්‍ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්‍රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.

  • දින 3ක් නොමිලේ
  • ඕනෑම වේලාවක අවලංගු කරන්න
  • නිල API පමණි
  • 24/7 නිරීක්ෂණය කෙරේ

සත්‍යාපනය කළේ