Instagram ویب ہک ایونٹس: تبصرے، منشنز اور DMs
Instagram ویب ہک ایونٹس پروفیشنل اکاؤنٹ پر ہونے والی سرگرمی کو اسی وقت رپورٹ کرتے ہیں: نئے تبصرے، @منشنز اور DMs۔ Meta ہر ایک کو JSON کی صورت میں جڑی ہوئی ایپ کے HTTPS اینڈ پوائنٹ پر POST کرتا ہے اور اس اینڈ پوائنٹ پر ناکام ڈیلیوری کو 36 گھنٹے تک دوبارہ بھیجتا ہے۔ easyCoexistence ہر ایونٹ کو ایک بار آپ کے اینڈ پوائنٹ تک آگے بھیجتا ہے، ہر اکاؤنٹ کے لیے دستخط شدہ، اور دوبارہ کوشش نہیں کی جاتی۔ Instagram Login کے ساتھ منشنز تبصروں کی اطلاع کے اندر آتے ہیں۔
Meta ایپ کے اینڈ پوائنٹ پر ناکام ڈیلیوری کو چھوڑنے سے پہلے کتنی دیر تک دوبارہ کوشش کرتا رہتا ہے۔
Meta زیادہ تر اپ ڈیٹس کو ایک ہی ویب ہک ڈیلیوری میں اکٹھا کرتا ہے، اگرچہ وہ اس کی ضمانت نہیں دیتا۔
وہ فلیگ جو Meta ان میسج ایونٹس پر لگاتا ہے جو اکاؤنٹ نے خود بھیجے ہوں۔
صرف پبلک اکاؤنٹس کے میڈیا پر تبصروں اور منشنز کی اطلاعات شروع ہوتی ہیں۔
کون سے ایونٹس ہیں؟
ایک پروفیشنل اکاؤنٹ کے لیے جو Instagram Login سے جڑا ہو، تین قسم کی سرگرمیاں ایونٹس کے طور پر پہنچتی ہیں:
- تبصرے: اکاؤنٹ کے میڈیا پر نیا تبصرہ، جس کے ساتھ تبصرے کا ID، مصنف کا Instagram-scoped ID اور یوزر نیم، متن، اور میڈیا ID اور ٹائپ ہوتی ہے۔
- منشنز: Instagram Login کے ساتھ یہ تبصروں کی اطلاع کے اندر آتے ہیں، اپنے الگ فیلڈ کے طور پر نہیں۔
- میسجز: اکاؤنٹ کو آیا ہوا DM، جس میں بھیجنے والا، وصول کنندہ، ٹائم اسٹیمپ اور خود میسج ہوتا ہے، بشمول ٹیکسٹ، اٹیچمنٹس اور Story کے جوابات۔
ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں؟
Meta Instagram ویب ہکس اس ایپ کو بھیجتا ہے جس سے اکاؤنٹ جڑا ہو۔ easyCoexistence انہیں وصول کرتا ہے اور ہر ایک کو، جیسے ہی پہنچتا ہے، اس HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے جو آپ نے اس اکاؤنٹ کے لیے سیٹ کیا ہے، اور اس اکاؤنٹ کے لیے مخصوص خفیہ کلید سے دستخط کرتا ہے۔
اینڈ پوائنٹ set_social_webhook_destination کے ذریعے Claude یا ChatGPT سے سیٹ کریں، یا PUT /channels/:id/webhook کے ذریعے Partner API سے۔ دستخط کی کلید ایک بار دکھائی جاتی ہے، اینڈ پوائنٹ دوبارہ سیٹ کرنے سے نئی جاری ہوتی ہے، اور URL کی جگہ null دینے سے فارورڈنگ بند ہو جاتی ہے۔
ڈیلیوری کیسی نظر آتی ہے؟
ایک POST درخواست جس کا JSON باڈی ہوتا ہے، جس میں platform، account_id (وہ کنکشن جو list_social_accounts دیتا ہے)، Instagram اکاؤنٹ کا external_id، اور entry ہوتا ہے: ایونٹ کے لیے Meta کی ویب ہک entry، بغیر تبدیلی کے۔ DM اسی طرح پہنچتا ہے، لیکن changes کی جگہ messaging array کے ساتھ۔ نیا تبصرہ یوں نظر آتا ہے:
{
"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>" }
}
}
]
}
}ڈیلیوری کی تصدیق کیسے کریں؟
ہر ڈیلیوری ایک X-EC-Signature ہیڈر لے کر آتی ہے جس کی شکل t=<unix>,v1=<hex> ہوتی ہے، جہاں v1 ٹائم اسٹیمپ، ایک ڈاٹ اور خام درخواست باڈی کا HMAC-SHA256 ہے، جو اکاؤنٹ کی دستخطی کلید سے بنایا جاتا ہے۔ اسے خام باڈی پر ویسے ہی حساب کریں جیسے وہ موصول ہوئی، کنسٹنٹ ٹائم میں موازنہ کریں، اور 5 منٹ سے پرانا ٹائم اسٹیمپ مسترد کریں۔
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));
}کیا ڈیلیوری دوبارہ بھیجی جاتی ہے؟
easyCoexistence ایسا نہیں کرتا: فارورڈنگ ہر ایونٹ کو ایک بار، میموری میں، آگے بھیجتی ہے اور دوبارہ کوشش کے لیے کوئی کاپی نہیں رکھتی۔ فوراً 2xx کے ساتھ جواب دیں اور کام بعد میں کریں، اور جو کچھ درکار ہو وہ موصول ہوتے ہی محفوظ کر لیں، کیونکہ Meta پچھلی اطلاعات کی ایسی تاریخ بھی نہیں رکھتا جس سے پوچھ گچھ ہو سکے۔
خود Meta ناکام ڈیلیوری کو ایپ تک 36 گھنٹے تک دوبارہ بھیجتا ہے، اس لیے کبھی کبھار ایک ہی ایونٹ آپ تک دو بار پہنچ سکتا ہے: تبصرے کے ID یا میسج کے mid کی بنیاد پر ڈپلیکیٹ ہٹائیں۔
ہینڈلر کو مزید کیا جانچنا چاہیے؟
کچھ تفصیلات Meta کے پے لوڈز میں ہیں جو پہلے ہینڈلر کو الجھا دیتی ہیں:
is_echo:is_echotrue پر سیٹ ہونے والا میسج ایونٹ خود اکاؤنٹ نے بھیجا ہوتا ہے، اس لیے اسے جواب کی ضرورت نہیں۔- Story replies: وہ DM جو کسی Story کا جواب ہو، اس میں Story کا ID اور URL کے ساتھ
reply_toہوتا ہے۔ - Story منشنز: یہ ایک میسج کے طور پر آتے ہیں جس کی اٹیچمنٹ ٹائپ
story_mentionہوتی ہے۔ - time: یہ وہ وقت ہے جب Meta نے اطلاع بھیجی، نہ کہ جب تبصرہ یا میسج کیا گیا؛ میسج کا اپنا ٹائم اسٹیمپ اس کی messaging entry میں ہوتا ہے۔
- البم IDs: تبصروں کے ایونٹس میں یہ شامل نہیں ہوتے؛ تبصرے کے ID سے البم تلاش کریں۔
عام غلطیاں
- جواب دینے سے پہلے کام کرنا۔ فارورڈنگ دوبارہ کوشش نہیں کرتی، اس لیے فوراً 2xx واپس کریں اور ایونٹ بعد میں پراسیس کریں۔
- پارس شدہ JSON پر دستخط کی تصدیق کرنا۔ HMAC کو خام باڈی پر حساب کریں، بالکل ویسے جیسے وہ پہنچی تھی۔
- ایکوز کا جواب دینا۔ is_echo سیٹ والا میسج ایونٹ وہ ہے جو اکاؤنٹ نے بھیجا، اور اس کا جواب ایک لوپ شروع کر دیتا ہے۔
- ڈپلیکیشن ہٹانا چھوڑ دینا۔ ناکامی کے بعد Meta وہی ایونٹ دوبارہ بھیج سکتا ہے، اس لیے تبصرے کے ID یا میسج کے mid کو کلید بنائیں۔
easyCoexistence Instagram اکاؤنٹ کے تبصرے، منشنز اور DMs جیسے ہی پہنچتے ہیں آپ کے HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے، اس اکاؤنٹ کی خفیہ کلید سے دستخط شدہ اور راستے میں کوئی کاپی رکھے بغیر۔ اسے set_social_webhook_destination کے ذریعے Claude یا ChatGPT سے آن کریں، یا Partner API سے۔ فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشنز بڑھتے ہیں قیمت کم ہوتی جاتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
Instagram ویب ہک میں time فیلڈ کا کیا مطلب ہے؟
یہ وہ وقت ہے جب Meta نے اطلاع بھیجی، نہ کہ جب تبصرہ یا میسج کیا گیا۔ DM کا اپنا ٹائم اسٹیمپ اس کی messaging entry میں ہوتا ہے۔
کیا Meta ناکام Instagram ویب ہک ڈیلیوریاں دوبارہ بھیجتا ہے؟
ہاں۔ Meta ناکام ڈیلیوری کو ایپ تک 36 گھنٹے تک دوبارہ بھیجتا ہے، اس لیے کبھی کبھار ایک ہی ایونٹ دو بار پہنچ سکتا ہے: تبصرے کے ID یا میسج کے mid کی بنیاد پر ڈپلیکیٹ ہٹائیں۔ easyCoexistence ہر ایونٹ آپ کے اینڈ پوائنٹ کو ایک بار آگے بھیجتا ہے، اس لیے فوراً 2xx کے ساتھ جواب دیں۔
ایک Instagram ویب ہک ڈیلیوری میں کتنی اپ ڈیٹس ہو سکتی ہیں؟
Meta کے اکٹھا کرنے پر 1,000 تک، اگرچہ Meta اکٹھا کرنے کی ضمانت نہیں دیتا۔ صرف پہلے آئٹم کو پڑھنے کے بجائے پورے entry array پر لوپ چلائیں۔
کیا منشنز کا اپنا ایونٹ ہوتا ہے؟
Instagram Login کے ساتھ نہیں۔ Meta منشنز کو تبصروں کی اطلاع میں شامل کرتا ہے، اس لیے یہ تبصروں والے راستے پر ہی پہنچتے ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ