Instagram webhook events: comments, mentions සහ DMs
Instagram webhook events මගින් professional ගිණුමක activity එක සිදුවන විටම වාර්තා කරයි: නව comments, @mentions සහ DMs. Meta එක් එක් event එකක් JSON ලෙස සම්බන්ධ කළ යෙදුමේ HTTPS endpoint එකට POST කරයි, අසාර්ථක delivery එකක් එම endpoint එකට පැය 36ක් දක්වා නැවත උත්සාහ කරයි. easyCoexistence එක් එක් event එකක් ඔබේ endpoint එකට එක් වරක් යවයි, ගිණුම අනුව අත්සන් කර, retries නොමැතිව. Instagram Login සමඟ mentions පැමිණෙන්නේ comments දැනුම්දීම ඇතුළෙනි.
Meta, යෙදුමේ endpoint එකට අසාර්ථක delivery එකක් අත්හරින තුරු නැවත උත්සාහ කරන කාලය.
බොහෝ updates Meta විසින් එක් webhook delivery එකකට batch කරයි, නමුත් batching සහතික නොකරයි.
ගිණුම විසින්ම යැවූ පණිවිඩ event වලට Meta සකසන flag එක.
Public ගිණුම්වල media පමණක් comment සහ mention දැනුම්දීම් සක්රිය කරයි.
ඇත්තේ කුමන events ද?
Instagram Login සමඟ සම්බන්ධ කළ professional ගිණුමක් සඳහා, ක්රියාකාරකම් තුනක් events ලෙස පැමිණේ:
- Comments: ගිණුමේ media මත නව comment එකක්, comment ID, කතෘගේ Instagram-scoped ID සහ username, text, සහ media ID සහ type සමඟ.
- Mentions: Instagram Login සමඟ ඒවා තමන්ගේම field එකක් ලෙස නොව comments දැනුම්දීම ඇතුළේ පැමිණේ.
- Messages: ගිණුමට DM එකක්, යවන්නා, ලබන්නා, timestamp සහ පණිවිඩයම, text, attachments සහ Story replies ඇතුළුව.
events ඔබේ endpoint එකට පැමිණෙන්නේ කෙසේද?
Meta, Instagram webhooks ගිණුම සම්බන්ධ කළ යෙදුමට delivery කරයි. easyCoexistence ඒවා ලබාගෙන, එක් එක් event එක පැමිණෙන ගමන්ම, එම ගිණුම සඳහා ඔබ සකසන HTTPS endpoint එකට යවයි, එම ගිණුම සඳහා secret එකකින් අත්සන් කර.
endpoint එක set_social_webhook_destination මගින් Claude හෝ ChatGPT වලින්, හෝ PUT /channels/:id/webhook හරහා Partner API සමඟ සකසන්න. signing secret එක එක් වරක් පමණක් පෙන්වයි, endpoint එක නැවත සැකසීමෙන් නව එකක් ලැබේ, සහ URL ලෙස null යැවීමෙන් forwarding නවතී.
delivery එකක් කෙසේ පෙනේද?
JSON body එකක් සහිත POST එකක්: platform, list_social_accounts මගින් සම්බන්ධතාවයට ලැබෙන account_id, Instagram ගිණුමේ external_id, සහ entry: event එක සඳහා Meta හි webhook entry එක, වෙනස් නොකර. DM එක changes වෙනුවට messaging array එකක් සමඟ එලෙසම පැමිණේ. නව comment එකක් මෙසේ පෙනේ:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}delivery එකක් කෙසේ verify කරන්නද?
එක් delivery එකක X-EC-Signature header එකක් ඇත, t=<unix>,v1=<hex> ආකාරයෙන්. v1 යනු timestamp, dot එක සහ raw request body හි HMAC-SHA256 වන අතර, එය ගිණුමේ signing secret එක යතුර ලෙස යොදා ගනී. එය ලැබුණු ආකාරයටම raw body මත ගණනය කර, constant time තුළ සංසන්දනය කර, මිනිත්තු 5ට වඩා පැරණි timestamp එකක් ප්රතික්ෂේප කරන්න.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}delivery එකක් නැවත උත්සාහ කරනවාද?
easyCoexistence විසින් නැත: forwarding එක event එක එක් වරක් memory තුළ යවයි, නැවත උත්සාහ කිරීමට copy එකක් තබන්නේ නැත. ඉක්මනින් 2xx පිළිතුරු දී වැඩ පසුව කරන්න, සහ පැමිණි විට ඔබට අවශ්ය දේ ගබඩා කරන්න. Meta ද විමසිය හැකි අතීත දැනුම්දීම් ඉතිහාසයක් තබා නොගන්නා නිසා.
Meta විසින්ම අසාර්ථක delivery එක යෙදුමට පැය 36ක් දක්වා නැවත උත්සාහ කරයි, එබැවින් එකම event එක විටින් විට දෙවරක් ළඟා විය හැක: comment ID හෝ පණිවිඩයේ mid මත deduplicate කරන්න.
handler එක තවත් කුමක් පරීක්ෂා කළ යුතුද?
Meta payloads හි පළමු handler එක වරදවාගන්නා කරුණු කිහිපයක්:
is_echo:is_echotrue ලෙස සකසූ පණිවිඩ event එකක් ගිණුම විසින්ම යවන ලද්දකි, එබැවින් පිළිතුරක් අවශ්ය නැත.- Story replies: Story එකට පිළිතුරු දෙන DM එකක
reply_toඇත, Story හි ID සහ URL සමඟ. - Story mentions: attachment type එක
story_mentionවන පණිවිඩයක් ලෙස පැමිණේ. - time: Meta දැනුම්දීම යැවූ වේලාව, comment හෝ පණිවිඩය සිදු වූ වේලාව නොවේ. පණිවිඩයේ තමන්ගේ timestamp එක messaging entry එකේ ඇත.
- Album IDs: comment events වල ඒවා නොමැත. comment ID සමඟ album එක සොයන්න.
සාමාන්ය වැරදි
- පිළිතුර දීමට පෙර වැඩ කිරීම. Forwarding නැවත උත්සාහ නොකරයි, එබැවින් වහාම 2xx ආපසු දී event එක පසුව සකසන්න.
- Parsed JSON මත signature verify කිරීම. HMAC එය පැමිණි ආකාරයටම raw body මත ගණනය කරන්න.
- Echo වලට පිළිතුරු දීම. is_echo සකසූ පණිවිඩ event එකක් ගිණුම විසින් යවන ලද්දකි, එයට පිළිතුරු දීම loop එකක් ආරම්භ කරයි.
- Deduplication මඟ හැරීම. Meta අසාර්ථකතාවකින් පසු එම event එක නැවත delivery කළ හැක, එබැවින් comment ID හෝ පණිවිඩයේ mid මත යතුරු කරන්න.
easyCoexistence Instagram ගිණුමේ comments, mentions සහ DMs ඒවා පැමිණෙන ගමන්ම ඔබේ HTTPS endpoint එකට යවයි, එම ගිණුම සඳහා secret එකකින් අත්සන් කර, මාර්ගයේ කිසිදු copy එකක් තබා නොගෙන. Claude හෝ ChatGPT වලින් set_social_webhook_destination මගින් හෝ Partner API සමඟ එය ක්රියාත්මක කරන්න. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එක් කරන විට අඩු වෙමින්, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
Instagram webhook එකේ time field එකෙන් අදහස් වන්නේ කුමක්ද?
Meta දැනුම්දීම යැවූ වේලාව, comment හෝ පණිවිඩය සිදු වූ වේලාව නොවේ. DM එකේ තමන්ගේ timestamp එක messaging entry එකේ ඇත.
Meta අසාර්ථක Instagram webhook delivery නැවත උත්සාහ කරනවාද?
ඔව්. Meta අසාර්ථක delivery එකක් යෙදුමට පැය 36ක් දක්වා නැවත උත්සාහ කරයි, එබැවින් එකම event එක විටින් විට දෙවරක් ළඟා විය හැක: comment ID හෝ පණිවිඩයේ mid මත deduplicate කරන්න. easyCoexistence එක් event එකක් ඔබේ endpoint එකට එක් වරක් පමණක් යවයි, එබැවින් ඉක්මනින් 2xx පිළිතුරු දෙන්න.
එක් Instagram webhook delivery එකකට updates කීයක් අඩංගු විය හැකිද?
Meta batch කරන විට 1,000 දක්වා, එහෙත් Meta batching සහතික නොකරයි. පළමු item එක පමණක් කියවීම වෙනුවට සම්පූර්ණ entry array එක හරහා loop කරන්න.
Mentions සඳහා තමන්ගේම event එකක් තිබේද?
Instagram Login සමඟ නැත. Meta mentions comments දැනුම්දීමට ඇතුළත් කරයි, එබැවින් ඒවා comments හා එම මාර්ගයෙන්ම පැමිණේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ