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

Instagram පණිවිඩ webhook එක: DM payload එක, echo සහ field

Instagram හි පණිවිඩ webhook field එක professional ගිණුමක DM ලැබෙන ආකාරයටම යවයි: text, attachments, shares, Story replies සහ mentions, inline replies සහ deletions. සෑම event එකක්ම messaging array එකක් තුළ තිබේ, එහි sender ගේ Instagram-scoped ID එක, recipient, timestamp එක සහ message object එක ඇත. ගිණුම විසින්ම යවන පණිවිඩ එම field එකෙන්ම ආපසු පැමිණෙන අතර is_echo true ලෙස සකසා ඇත.

easyCoexistence සම්බන්ධිත සෑම Instagram ගිණුමක්ම messages වෙත subscribe කර, එහි DM, echo ද ඇතුළුව, පැමිණෙන විට ඔබේ HTTPS endpoint එකට forward කරයි; එම ගිණුමේ secret එකෙන් අත්සන් කර; forwarding පිටපතක් තබා නොගන්නා අතර, DMs පෙරනිමියෙන් ගබඩා නොකෙරේ.

is_echo

ගිණුම විසින්ම යැවූ පණිවිඩයක message event එකක් මත is_echo true ලෙස සකසා ඇත.

24 hours

බොහෝ පරිශීලක ක්‍රියා සඳහා සාමාන්‍ය messaging window එක, ඒ අතරතුර යෙදුමට පුද්ගලයාට reply කළ හැක.

ig_post

Shared post සඳහා attachment type එක; පැරණි share type එක 2026 පෙබරවාරි 1 දක්වා පමණක් සහාය දක්වන ලදී.

story_mention

Meta එවන DM event එකේ attachment type එක, කෙනෙකු Story එකේ ගිණුම mention කළ විට.

2534041

ගිණුම හිමිකරු Instagram direct පණිවිඩ සඳහා access අක්‍රිය කර ඇති විට, code 200 යටතේ දෝෂ subcode එක.

messages field එක ක්‍රියාත්මක වන්නේ කවදාද?

පුද්ගලයෙක් professional ගිණුමට DM එකක් යවන විටත්, ගිණුම එකක් යවන විටත්. Meta හි උදාහරණ සහ යොමු ලේඛන මෙම අවස්ථා ලැයිස්තුගත කරයි, ඒ සෑම එකක්ම message object එකක් සහිත messaging event එකකි:

  • පෙළ, සහ media attachments ලෙස: images, video, audio සහ files.
  • shared post එකක් හෝ Reel එකක්, ig_post, ig_reel හෝ reel attachment ලෙස.
  • ගිණුමේ Story එකට reply එකක්, reply_to.story සමඟ, සහ ගිණුම mention කරන Story එකක්, story_mention attachment ලෙස.
  • පෙර පණිවිඩයකට inline reply එකක්, reply_to.mid සමඟ, සහ quick reply එකක්, quick_reply.payload සමඟ.
  • පුද්ගලයා මකා දැමූ පණිවිඩයක් (is_deleted), සහාය නොදක්වන media (is_unsupported), සහ Click-to-Direct ad එකක් click කළ කෙනෙකුගෙන් පණිවිඩයක් (referral).
  • ගිණුම යැවූ පණිවිඩයක්, එය is_echo true සහිතව ආපසු පැමිණේ.

messages notification එකක් ගත් විට පෙනෙන ආකාරය කෙසේද?

JSON හි object අගය instagram වන POST එකකි. comment එකකට මෙන් නොව, පණිවිඩය ගිණුමේ entry එක ඇතුළේ messaging array එකක තිබෙන අතර, එක් එක් element එකේ sender, recipient, timestamp සහ message ඇත. ගිණුමේ Story එකට reply එකක් මෙසේ පෙනේ:

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

සෑම field එකකම අර්ථය කුමක්ද?

Instagram Login යටතේ message event එකක් සඳහා Meta ලේඛනගත කරන fields, පිටතින් ඇතුළතට:

  • entry[].id: professional ගිණුමේ ID එක. entry[].time: Meta notification එක යැවූ වේලාව; Meta හි messaging නිදර්ශන එය මිලි තත්පරවලින් දෙයි.
  • sender.id සහ recipient.id: ලැබෙන DM එකක, පුද්ගලයාගේ Instagram-scoped ID සහ ගිණුමේ ID; echo එකක, එම අගයන් ප්‍රතිලෝමව.
  • timestamp: පණිවිඩය යවන ලද වේලාව, Meta නිදර්ශනවල මිලි තත්පරවලින්. පණිවිඩ තබන්න ලැබුණු අනුපිළිවෙළට නොව මෙයට අනුවය.
  • message.mid: පණිවිඩ ID එක; deduplicate කිරීමට, react කිරීමට සහ reply_to.mid සමඟ එම පණිවිඩයට reply කිරීමට.
  • message.text: පණිවිඩයේ text අඩංගු විට පමණක් ඇතුළත් වේ.
  • message.attachments[]: එක් එකක් type සහ payload සමඟ, සාමාන්‍යයෙන් url එකක්. shared post එකක ig_post payload එක ig_post_media_id සහ title, එනම් එහි caption එක, එකතු කරයි.
  • message.reply_to: inline reply එකක් සඳහා mid, හෝ Story reply එකක් සඳහා Story එකේ url සහ id සමඟ story.
  • message.quick_reply.payload සහ message.referral: තෝරාගත් quick reply එක, සහ Click-to-Direct ad එකේ ref, ad_id, source, type සහ ads_context_data.
  • message.is_deleted, is_echo, is_self සහ is_unsupported: true වන විට පමණක් ඇතුළත් වේ.
  • message.admin_text සහ handoff_reason: සුදුසු යෙදුම්වල, Meta Business Agent වැනි Meta යෙදුමක් සංවාදය භාර දුන් බවට දැනුම්දීමක්; එයට mid හෝ text නොමැතිව පැමිණිය හැක.

echo ක්‍රියා කරන ආකාරය කෙසේද?

ගිණුම පණිවිඩයක් යවන විට, Meta එයටත් is_echo true සහිත messages event එකක් යවයි. එවිට sender.id ගිණුම වන අතර recipient.id පුද්ගලයාගේ Instagram-scoped ID වේ. ගිණුම තමාටම යවන test පණිවිඩයක් is_self ද ගෙන එයි. Echo මගින් ගිණුම කී දේ වාර්තා වන අතර, සංවාද log එකකට එය අවශ්‍ය වේ; නමුත් reply කළ යුතුද යන්න තීරණය කරන handler එකක් ඒවා මඟ හැරිය යුතුය. ගිණුම පණිවිඩයකට react කරන විට හෝ react එක ඉවත් කරන විට Meta echo එකක් නොයවයි.

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 එකට reply කරන්නද?

sender.id, එනම් පුද්ගලයාගේ Instagram-scoped ID. කෙනෙකු ගිණුමට පණිවිඩයක් යවන විට හෝ එහි media එකට comment කරන විට Meta එය සාදයි; එය එම පුද්ගලයාටත් එම ගිණුමටත් විශේෂිත වේ. recipient.id එම අගයට සකසා POST /<IG_ID>/messages යැවීමෙන් reply එක යවයි. event එකේ නමක් හෝ username එකක් නොමැත; GET /<IGSID> සමඟ name සහ username වැනි fields ඉල්ලූ විට ඒවා ලැබේ, මන්ද ගිණුමට පණිවිඩයක් යවා ඇති පුද්ගලයා එම lookup සඳහා අවශ්‍ය අනුමතිය (consent) දී ඇත.

පණිවිඩයක් 24 පැයේ window එක විවෘත කරන්නේ කෙසේද?

යෙදුමට පුද්ගලයෙකුට පණිවිඩයක් යැවිය හැක්කේ ඔවුන් ගිණුමට පණිවිඩයක් යැවූ පසුව පමණි, සහ ඔවුන්ගේ ක්‍රියාව විවෘත කරන සම්මත messaging window එක තුළ පමණි. බොහෝ ක්‍රියා සඳහා එය පැය 24ක් පවතී; Click-to-Direct ad එකක් click කිරීමෙන් පසු යවන පළමු පණිවිඩයෙන් දින 7 දක්වා. පුද්ගලයාගෙන් නව පණිවිඩයක් නව window එකක් විවෘත කරයි, එබැවින් ඔවුන්ගේ නවතම timestamp එක තබා ගත යුතුය; echo එක ගිණුමේම පණිවිඩයක් වන නිසා කිසිවක් දීර්ඝ නොකරයි. පුද්ගලයන් ලියන reply වලට, human_agent ලෙස ටැග් කළ Meta හි වෙනම දින 7 Human Agent window එක භාවිතා කළ හැක.

messages event එකේ නොමැති දේ මොනවාද?

Meta හි messaging යොමු ලේඛන අනුව, handler එකක් සොයන දේවල් කිහිපයක් නොමැත:

  • පුද්ගලයාගේ නම හෝ username: Instagram-scoped ID එක පමණි, එය GET /<IGSID> මගින් විසඳා ගත හැක.
  • එක් වරක් බලන media: එය URL එකක් නොමැති ephemeral attachment එකක් ලෙස පැමිණේ.
  • හරියටම carousel රූපය: carousel post එකක එක රූපයකට react කිරීම හෝ forward කිරීම පළමු රූපය ලෙස වාර්තා වේ.
  • Reactions, edits සහ read receipts: ඒවාට ම වූ fields මත පැමිණේ.
  • Read mark එක: webhook මගින් ලැබුණු පණිවිඩයක් reply යවන තුරු Instagram inbox එකේ නොකියවූ ලෙස පවතී.

Meta ලැයිස්තුගත කරන අනෙක් messaging fields මොනවාද?

Instagram Login සඳහා Meta හි field ලැයිස්තුව සහ උදාහරණ මෙවා ද නම් කරයි, ඒ සෑම එකක්ම තමන්ගේම messaging event එකකි. easyCoexistence සෑම ගිණුමක්ම messages, comments සහ mentions පමණක් සඳහා subscribe කරන බැවින්, ඒ කිසිවක් එය forward කරන දේට ඇතුළත් නොවේ:

  • message_reactions: පුද්ගලයෙක් පණිවිඩයකට react කරයි හෝ react එක ඉවත් කරයි, reaction.mid, action (react හෝ unreact) සහ reaction සහ emoji සමඟ.
  • message_edit: පුද්ගලයෙක් පණිවිඩයක් සංස්කරණය කරයි, message_edit.mid, නව text සහ num_edit සමඟ.
  • messaging_postbacks: පුද්ගලයෙක් icebreaker එකක් හෝ template button එකක් තට්ටු කරයි, postback.mid, title සහ payload සමඟ.
  • messaging_referral: දැනටමත් සංවාදයක සිටින පුද්ගලයෙක් ref parameter එකක් සහිත ig.me link එකක් විවෘත කරයි.
  • messaging_seen: පුද්ගලයෙක් පණිවිඩයක් කියවයි, read.mid සමඟ.
  • messaging_optins, messaging_handover සහ standby: අවසාන දෙක, Meta හි handover protocol යටතේ සංවාදයක් බෙදාගන්නා යෙදුම් සඳහා.

ගිණුම විසින් ක්‍රියාත්මක කළ යුත්තේ කුමක්ද?

Allow access to messages ක්‍රියාත්මක කරන්න. Meta හි professional ගිණුමක පණිවිඩ API හරහා කළමනාකරණය කිරීමට පෙර එය ක්‍රියාත්මක කළ යුතුය; Instagram app එකේ Settings, Messages and story replies, Message controls, Connected tools යටතේ. එය ක්‍රියාවිරහිත වන තෙක් යැවීම් code 200, subcode 2534041 සමඟ අසාර්ථක වේ. යෙදුමට instagram_business_basic සහ instagram_business_manage_messages අවශ්‍ය වන අතර, එය හිමි නොවන හෝ කළමනාකරණය නොකරන ගිණුම් සේවා කිරීමට Advanced Access අවශ්‍ය වේ.

easyCoexistence DM එකක් forward කරන්නේ කෙසේද?

comment එකක් මෙන්: ගිණුම සඳහා Meta ලබාදෙන සෑම entry එකක්ම platform, account_id, external_id සහ entry අඩංගු envelope එකක් තුළ ඔබේ HTTPS endpoint එකට POST කරයි, ගිණුමේ secret එකෙන් X-EC-Signature හි අත්සන් කර, එක් වරක් පමණක් සහ පිටපතක් තබා නොගෙන. echo ද අනෙක් ඒවා සමඟ forward වන බැවින්, reply කිරීමට පෙර is_echo පරීක්ෂා කරන්න. Reply කිරීමට, 24 පැයේ window එක තුළ, account_id සහ event එකේ sender.id recipient_id ලෙස සමඟ send_social_dm කැඳවන්න. DM මත ආරම්භ වන automation එකක් ද එම events මත ක්‍රියාත්මක වේ.

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

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

  • echo වලට reply කිරීම. is_echo සකසා ඇති event එකක් ගිණුමේම පණිවිඩයක් වන අතර, එයට reply කිරීම ගිණුම තමා සමඟ ම loop එකකට ඇද දමයි.
  • පණිවිඩයට සැමවිටම text ඇතැයි උපකල්පනය කිරීම. Attachments, shares, Story mentions සහ deletions text field එකක් නොමැතිව පැමිණේ, එබැවින් message object එකේ ඇති දේ අනුව branch කරන්න.
  • පැමිණි අනුපිළිවෙළට පණිවිඩ තැබීම. Meta දෝෂයකින් පසු පණිවිඩ අනුපිළිවෙළ නැතිව යැවිය හැකි බැවින්, timestamp අනුව sort කරන්න.
  • time සහ timestamp තත්පර ලෙස parse කිරීම. Meta හි messaging නිදර්ශන දෙකම මිලි තත්පරවලින් දෙයි; තත්පර ලෙස කියවූ විට ඒවා දුරස්ථ අනාගතයේ දිනයන් බවට පත්වේ.
EasyCoexistence සමඟ මෙය කිරීම

send_social_dm පැය 24ක window එක තුළ reply කරයි, සහ automation වලට ස්ථිර text හෝ AI සමඟ තමාටම reply කළ හැක. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.

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

Instagram පණිවිඩ webhook timestamp එක තත්පර ද මිලි තත්පර ද?

Meta හි messaging නිදර්ශනවල, timestamp සහ entry time දෙකම මිලි තත්පරවලින්. තත්පර ලෙස කියවූ විට ඒවා දුරස්ථ අනාගතයේ දිනයන් බවට පත්වේ.

Instagram DM webhook එකෙන් sender ගේ username එක ලබා ගන්නේ කෙසේද?

GET /<IGSID> කැඳවන්න, name සහ username වැනි fields සමඟ. event එකේ ඇත්තේ පුද්ගලයාගේ Instagram-scoped ID එක පමණි.

Instagram DM webhooks මගේ ගිණුමට නොපැමිණෙන්නේ ඇයි?

ගිණුමේ "Allow access to messages" ක්‍රියාත්මක කර ඇත්දැයි, /subscribed_apps හරහා messages වෙත subscribe වී ඇත්දැයි, සහ හිමි නොවන ගිණුම් සඳහා යෙදුම Advanced Access සමඟ Live ද යන්න පරීක්ෂා කරන්න.

easyCoexistence Instagram message reactions forward කරනවාද?

නැත. Reactions එන්නේ message_reactions මතයි, සහ easyCoexistence ගිණුම් messages, comments සහ mentions වෙත subscribe කරයි.

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

Instagram comments webhook: payload එක, field එකෙන් fieldInstagram comments webhook එකේ payload එක field එකෙන් field විස්තර කරයි: post සහ Reel comments, reply, නොදෙන දේ සහ වැරදෙන තැන්.Instagram webhook සත්‍යාපනය: hub.challenge සහ X-Hub-Signature-256Instagram webhook සැකසීම: hub.challenge ට පිළිතුරු දෙන්න, යෙදුමේ secret සමඟ X-Hub-Signature-256 පරීක්ෂා කරන්න, ගිණුම් subscribe කරන්න.Instagram webhook events: comments, mentions සහ DMsInstagram comments, mentions සහ DMs webhook event ලෙස endpoint එකට එන ආකාරය, payload එක සහ signature එක පරීක්ෂා කිරීම.API හරහා Instagram DMs සහ පැය 24 window එකAPI හරහා Instagram DM කාට යැවිය හැකිද, පැය 24 window එක, private replies සහ Allow access to messages සැකසුම පැහැදිලි කරයි.Instagram private replies API: comment එකකට DM එකක් යැවීමMeta API එකෙන් Instagram private reply යැවීම: POST /<IG_ID>/messages, comment ID එක, comment එකකට එකක්, දින 7ක් ඇතුළත, දෝෂය 2534025.API හරහා Instagram mentions: @mentions සොයාගෙන පිළිතුරු දීමInstagram @mentions API හරහා Instagram Login සහිත comments webhook එක මගින් පැමිණෙන ආකාරය සහ comments හා captions වලට පිළිතුරු දෙන ආකාරය.

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

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

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

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