webhook එකේ Instagram Story mentions සහ Story පිළිතුරු
Instagram මගින් Story mentions සහ Story පිළිතුරු DM ලෙස messages webhook field එකට යවයි. mention එකක් ලැබෙන්නේ attachments හි story_mention වර්ගයේ අයිතමයක් ඇති පණිවිඩයක් ලෙසයි, එහි payload.url හි Story හි CDN URL එක ඇත. පිළිතුරක් රැගෙන එන්නේ පුද්ගලයාගේ පෙළ සහ reply_to.story ය; එහි Story හි url සහ id ඇත, link sticker එකක් ඇති Story සඳහා link_sticker_url ද ඇත.
easyCoexistence සෑම සම්බන්ධ Instagram ගිණුමක්ම messages වෙත subscribe කරයි, එබැවින් Story mentions සහ Story replies ඔබේ HTTPS endpoint එකට අනෙකුත් DM සමඟ ළඟා වේ, ගිණුමේ secret සමඟ අත්සන් කර, කිසිදු පිටපතක් නොතබා.
කෙනෙකු තම Story එකේ ගිණුම mention කරන විට Meta යවන messages event එකේ attachment වර්ගය.
Meta විසින් reply_to.story වෙත 2025 දෙසැම්බර් 12 දින එක් කළ field එක, පිළිතුරු දුන් Story හි link sticker URL එක රඳවා ගනී.
Story එකක් කොපමණ කාලයක් පවතින්නද; එය කල් ඉකුත් වී හෝ මකා දැමූ පසු එහි mention URL එක render වීම නවතී.
Mention ලැබෙන ගිණුම්; පෞද්ගලික ගිණුමක mention ලැබෙන්නේ එය professional ගිණුම follow කරන්නේ නම් පමණි.
Meta ගේ Instagram Messaging guide අනුව webhook සහාය නොදක්වන Story පිළිතුරු.
Story mention එකක් කෙසේ ලැබෙන්නේද?
DM ලෙසය. කෙනෙකු professional ගිණුම තම Story එකේ mention කළ විට, Instagram එම Story ට යොමු වන පණිවිඩයක් ගිණුමේ inbox එකට දමයි, Meta ඒ සඳහා messages event එකක් යවයි. sender.id යනු පුද්ගලයාගේ Instagram-scoped ID එකයි, සහ message.attachments හි payload.url එම Story හි CDN URL වන story_mention වර්ගයේ අයිතම එකක් ඇත. Meta ගේ නියැදි වල පෙළක් නොමැත, එබැවින් attachment එක කියවන්න:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Story reply එකක් කෙසේ ලැබෙන්නේද?
ලැබෙන්නේ ද DM ලෙසය, පුද්ගලයාගේ පණිවිඩය සහ ගිණුමේ Story වෙත යොමු කරන reply_to object එකක් සමඟ. reply_to.story හි Story හි CDN url සහ එහි id ඇත. Meta ගේ webhook reference හි link_sticker_url ද එහි ලැයිස්තුගත කර ඇත, 2025 දෙසැම්බරයේ link sticker ඇති Story වලට පිළිතුරු සඳහා එකතු කළ එය, link අනුව automation routing සඳහා Meta යෝජනා කරයි. පෙර පණිවිඩයකට inline පිළිතුරක් reply_to.mid භාවිත කරයි.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}එක් එක් field එකේ තේරුම කුමක්ද?
Meta මෙම event දෙක සඳහා ලේඛනගත කරන fields, පිටතින් ඇතුළට:
- entry[].id සහ recipient.id: professional ගිණුම. sender.id: පුද්ගලයාගේ Instagram-scoped ID, පිළිතුරක් යන ID එක.
- timestamp: පණිවිඩය යවන ලද වේලාව, Meta ගේ නියැදි වල මිලිතත්පරවලින්; entry[].time යනු Meta දැනුම්දීම යැවූ වේලාවයි.
- message.mid: පණිවිඩ ID එක, retry ද්විත්ව ඇතුළත් කිරීම් ඉවත් කිරීමට සහ
reply_to.mid සමඟ පිළිතුරු දීමට. - attachments[].type
story_mentionසහ payload.url: mention එක, සහ එය සිදු කළ Story හි CDN URL එක. reply_to.story.url සහreply_to.story.id: පුද්ගලයා පිළිතුරු දුන් ගිණුමේ Story එක.reply_to.story.link_sticker_url: එම Story හි link sticker එකේ URL එක.- message.text: පිළිතුරේ වචන, පණිවිඩයේ පෙළ ඇති විට ඇතුළත් වේ.
Story URL එක කොපමණ කාලයක් ක්රියා කරයිද?
Story එක ක්රියා කරන තාක් කාලය. Story එක පැය 24 කින් හෝ එහි කර්තෘ මකා දැමූ විට අතුරුදහන් වන අතර, Meta ගේ story mention guide පවසන්නේ එවිට URL එක render වීම නවතින බවයි; එහි overview එක ඊට එකතු කරන්නේ Instagram ගේ CDN URL privacy-aware බවත්, මකා දැමූ හෝ කල් ඉකුත් වූ අන්තර්ගතයට කිසිවක් ආපසු නොදෙන බවත්ය. එම guide එකට අනුව CDN URL තබා ගැනීමට ඉඩ දෙයි, නමුත් media එක නොවේ: යෙදුමක් Story හි අන්තර්ගතය තම servers මත ගබඩා හෝ cache නොකළ යුතු අතර, Story නැති වූ පසු placeholder එකක් පෙන්විය යුතුය.
කිසිදු event එකක් ඇති නොවන්නේ කවදාද?
Meta ගේ guides මෙම අවස්ථා නම් කරයි, Story event එකක් බලා සිටින handler එකට කිසිවක් නොලැබෙන:
- professional ගිණුම follow නොකරන පෞද්ගලික ගිණුමක් විසින් කරන Story mention.
- සාමාන්ය post එකක tag: Meta කියන්නේ post වල tagging නොව, Story mentions පමණක් messages webhook එක trigger කරන බවයි.
- webhook සහාය නොදක්වන GIF හෝ sticker සමඟ කරන Story reply.
- mentions API හරහා Story: GET /<
IG_ID>/tags සහ POST /<IG_ID>/mentions එවා සහාය නොදක්වයි, එබැවින් Story mention ලැබෙන්නේ DM මගිනි.
Story mentions සහ replies පැය 24 කාල සීමාව විවෘත කරයිද?
පිළිතුරක් යනු පුද්ගලයාගෙන් එන පණිවිඩයකි, Meta ලැයිස්තු කරන්නේ Story mentions යනු පුද්ගලයෙකු සංවාදයක් ආරම්භ කරන නාලිකා අතර බවයි. ඔවුන්ගේ ක්රියාව විවෘත කරන කවුළුව බොහෝ ක්රියා සඳහා පැය 24ක් පවතී, එබැවින් එය විවෘත කර ඇති අතරතුර ගිණුමට POST /<IG_ID>/messages සමඟ පිළිතුරු දිය හැකිය, recipient.id ලෙස event එකේ sender.id සකසා. ගිණුමේ පිළිතුර messages මත echo ලෙස ආපසු ලැබෙන අතර is_echo true ලෙස සකසා ඇත.
easyCoexistence ඒවා කෙසේ යොමු කරයිද?
messages field එකේ, එහි සෑම සම්බන්ධ ගිණුමක්ම subscribe වේ, එබැවින් Story mentions සහ Story replies ගිණුමේ අනෙකුත් DM සමඟ ඔබේ endpoint එකට ළඟා වේ: platform, account_id, external_id සහ entry වල envelope එකක් ඇතුළත එක් entry එකක්, ගිණුමේ secret සමඟ X-EC-Signature හි අත්සන් කර, එක් වරක් යවා, පිටපතක් නොතබා. send_social_dm පුද්ගලයාට recipient_id ලෙස event එකේ sender.id සමඟ පිළිතුරු දෙයි, පැය 24 කවුළුව තුළ.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"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": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}සාමාන්ය වැරදි
- Story හි media ගබඩා කිරීම. Meta ගේ story mention guide CDN URL තබා ගැනීමට ඉඩ දෙයි, අන්තර්ගතය නොවේ, එය ඔබේ servers මත ගබඩා හෝ cache නොකළ යුතුය.
- message.text පමණක් කියවීම. Story mention එකක attachment එකක් ඇත, වර්ගය story_mention, සහ Meta ගේ නියැදි වල පෙළක් නැත, එබැවින් පෙළ-පමණක් handler එකට හිස් පණිවිඩයක් පෙනේ.
- දින ගණනකට පසු Story URL එක render කිරීම. පැය 24 කින් කල් ඉකුත් වූ හෝ මකා දැමූ පසු එය ක්රියා නොකරයි, එබැවින් එතැන් සිට placeholder එකක් පෙන්වන්න.
- Story mentions comments field හෝ mentions API හි සෙවීම. Meta ඒවා messages මත DM ලෙස ලබා දෙයි.
send_social_dm පුද්ගලයාට පැය 24 කවුළුව තුළ පිළිතුරු දෙයි, Claude, ChatGPT හෝ ඔබේ තමන්ගේම කේතයෙන්. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
Instagram Story mention event එකක text තිබේද?
Meta ගේ නියැදි වල නැත. Story mention එකක story_mention වර්ගයේ attachment එකක් ඇත, Story හි CDN URL සමඟ, එබැවින් message.text පමණක් කියවන handler එකට හිස් පණිවිඩයක් පෙනේ.
Instagram Story reply එකේ link_sticker_url යනු කුමක්ද?
පුද්ගලයා පිළිතුරු දුන් Story හි link sticker එකේ URL එකයි, reply_to.story.link_sticker_url හි. Meta එය 2025 දෙසැම්බර් 12 එකතු කළ අතර link අනුව automation යොමු කිරීම සඳහා එය යෝජනා කරයි.
GIF හෝ sticker පිළිතුරු Story වෙත webhook trigger කරනවාද?
නැත. Meta ගේ Instagram Messaging guide පවසන්නේ webhook එකට GIF හෝ sticker සමඟ කරන Story පිළිතුරු සහාය නොදක්වන බවයි.
පෞද්ගලික ගිණුම් Story mention webhook trigger කරනවාද?
professional ගිණුම follow කරන විට පමණි. පොදු ගිණුම්වලින් mentions සිදු වන විට ලැබේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ