Instagram کمنٹس ویب ہک: پے لوڈ، ہر فیلڈ کی تفصیل
جب کوئی شخص کسی پیشہ ورانہ اکاؤنٹ کے میڈیا پر کمنٹ کرے، یا کسی کمنٹ کا جواب دے، تو Instagram کا comments فیلڈ ایپ کو مطلع کرتا ہے، جس میں Reels بھی شامل ہیں۔ Meta ایک تبدیلی بھیجتا ہے جس کا field comments پر سیٹ ہوتا ہے، اور جس کی value میں کمنٹ کا id اور متن، from میں مصنف کا Instagram-scoped ID اور صارف نام، میڈیا کا id اور product type، اور اگر کمنٹ جواب ہو تو parent_id ہوتا ہے۔
easyCoexistence ہر جڑے ہوئے Instagram اکاؤنٹ کو comments کے لیے سبسکرائب کرتا ہے، اور Meta سے اس کے لیے آنے والے comments ایونٹس کو، جیسے ہی وہ آتے ہیں، آپ کے HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے، اس اکاؤنٹ کے سیکرٹ سے دستخط شدہ اور بغیر کوئی نقل محفوظ کیے۔
کمنٹ جواب ہو تو موجود ہوتا ہے، اور اس کمنٹ کا ID رکھتا ہے جس کا یہ جواب ہے۔
جب اکاؤنٹ اپنے میڈیا پر کمنٹ کرے تو اس کے اپنے ID کے ساتھ from میں شامل کیا جاتا ہے۔
لائیو براڈکاسٹ کے دوران کمنٹس کے لیے ایک الگ فیلڈ ہے، اور براڈکاسٹ ختم ہونے پر اس کی اطلاعات رک جاتی ہیں۔
comments اور live_comments کی اطلاعات کے لیے ضروری ہے؛ نجی اکاؤنٹس کے میڈیا پر کوئی اطلاع نہیں آتی۔
کمنٹ کرنے والے کو ایک نجی جواب بھیجنے کے لیے باقی وقت، جو کمنٹ کے ID کے ذریعے طے ہوتا ہے۔
comments فیلڈ کب فائر ہوتی ہے؟
جب کوئی شخص پیشہ ورانہ اکاؤنٹ کے میڈیا پر کمنٹ کرے یا اکاؤنٹ کا ذکر کرے، اور ایپ اور اکاؤنٹ دونوں اس فیلڈ کو سبسکرائب کر چکے ہوں۔ ہر کمنٹ اطلاع میں ایک تبدیلی کے طور پر آتا ہے، اور یہ صورتیں ایک ہی ساخت رکھتی ہیں:
- پوسٹ، Reel، اسٹوری یا اشتہار پر نیا کمنٹ، جس میں media.
media_product_typeبتاتا ہے کہ میڈیا کس سطح پر ہے۔ - موجودہ کمنٹ کے نیچے جواب، جس میں
parent_idہوتا ہے، یعنی اس کمنٹ کا ID جس کا یہ جواب ہے۔ - اکاؤنٹ کا اپنے میڈیا پر کیا گیا کمنٹ، بشمول اس کے جوابات: from.id اکاؤنٹ کا اپنا ID ہوتا ہے، اور from میں
self_ig_scoped_idشامل ہوتا ہے۔ - اکاؤنٹ کا @mention: Instagram Login کے ساتھ Meta mentions کو الگ فیلڈ کے بجائے comments کی اطلاع میں شامل کرتا ہے۔
- لائیو براڈکاسٹ کے دوران کمنٹ ایک الگ فیلڈ
live_commentsپر آتا ہے، اسی value ساخت کے ساتھ، اور براڈکاسٹ ختم ہونے پر رک جاتا ہے۔
comments کی اطلاع کیسی ہوتی ہے؟
ایک POST درخواست جس کے JSON میں object کی قدر instagram ہو اور ایک entry array ہو۔ ہر entry ایک پیشہ ورانہ اکاؤنٹ ہے: اس کا ID، وہ وقت جب Meta نے اطلاع بھیجی، اور ایک changes array جس میں ہر کمنٹ کے لیے ایک تبدیلی ہو۔ Reel پر جواب کچھ یوں دکھتا ہے:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}ہر فیلڈ کا کیا مطلب ہے؟
وہ فیلڈز جو Meta کا ویب ہک ریفرنس کمنٹ کے لیے بیرونی سے اندرونی ترتیب میں درج کرتا ہے:
- entry[].id: پیشہ ورانہ اکاؤنٹ کا ID، یعنی وہ
user_idجو /me اس کے لیے واپس کرتا ہے۔ اس سے معلوم ہوتا ہے کہ کمنٹ کس اکاؤنٹ کا ہے۔ - entry[].time: وہ وقت جب Meta نے اطلاع بھیجی، Unix timestamp کی شکل میں۔ یہ وہ وقت نہیں جب کمنٹ لکھا گیا تھا۔
- changes[].field: comments، یا لائیو براڈکاسٹ کے لیے
live_comments۔ value پڑھنے سے پہلے اسے چیک کریں۔ - value.id: کمنٹ کا ID، جسے عوامی یا نجی طور پر جواب دینے، چھپانے یا حذف کرنے کے لیے استعمال کیا جاتا ہے۔
- value.text: کمنٹ کا متن، جو صرف اس صورت میں شامل ہوتا ہے جب کمنٹ میں متن ہو۔
- value.from.id اور value.from.username: مصنف کا Instagram-scoped ID اور صارف نام۔ value.from.
self_ig_scoped_idاس صورت میں ظاہر ہوتا ہے جب کمنٹ اکاؤنٹ نے خود لکھا ہو۔ - value.media.id اور value.media.
media_product_type: جس میڈیا پر کمنٹ ہوا اور اس کی سطح؛ Meta کا میڈیا ریفرنس AD، FEED، STORY اور REELS نام دیتا ہے۔ - value.
parent_id: جواب کی صورت میں، اس کمنٹ کا ID جس کا یہ جواب ہے۔ اوپر کی سطح کے کمنٹ میں یہ نہیں ہوتا۔ - value.media.
ad_id،ad_titleاورoriginal_media_id: ریفرنس میں ان کمنٹس کے لیے درج ہیں جو کسی اشتہار پر کیے گئے ہوں۔
comments فیلڈ کیا رپورٹ نہیں کرتی؟
Meta کے سیٹ اپ گائیڈ اور ریفرنس کے مطابق کچھ ایسی چیزیں جو ہینڈلر کو متوقع ہو سکتی ہیں، ایونٹ سے باہر رکھی جاتی ہیں یا کبھی بھیجی نہیں جاتیں:
- نجی اکاؤنٹ کے میڈیا پر کمنٹس: Meta ان کے لیے کمنٹ یا mention کی کوئی اطلاع نہیں بھیجتا۔
- البم IDs: ایونٹ میں یہ شامل نہیں ہوتے، اور Meta کہتا ہے کہ البم کو کمنٹ کے ID سے تلاش کریں۔
- ڈائنامک اشتہارات میں استعمال ہونے والے میڈیا کے لیے Ad IDs۔
- کمنٹ کی تخلیق کا وقت: GET /<
COMMENT_ID>?fields=timestamp اسے ISO 8601 میں واپس کرتا ہے۔ - براڈکاسٹ ختم ہونے کے بعد لائیو کمنٹس، جب لائیو میڈیا کی اطلاعات رک جاتی ہیں۔
- اسٹوری mentions، جنہیں Meta کا mentions API سپورٹ نہیں کرتا؛ یہ اکاؤنٹ تک اس کے بجائے DMs کے ذریعے پہنچتے ہیں۔
- پچھلے ایونٹس: Meta اطلاعات کی ہسٹری نہیں رکھتا جس سے پوچھا جا سکے، اس لیے ہر ایونٹ آنے پر جو درکار ہو وہ محفوظ کریں۔
comments فیلڈ کو کیا چاہیے؟
Instagram Login کے ساتھ اجازتیں instagram_business_basic اور instagram_business_manage_comments، اور Advanced Access درکار ہیں، جو Meta comments اور live_comments کی اطلاعات کے لیے لازمی قرار دیتا ہے۔ ایپ کو App Dashboard میں Live ہونا اور comments کو سبسکرائب کیا ہوا ہونا چاہیے، اور ہر اکاؤنٹ کو POST /<IG_ID>/subscribed_apps کے ذریعے سبسکرائب کرنا ہوگا، جس کے subscribed_fields میں comments شامل ہو۔ Meta کمنٹس کے لیے پولنگ کے بجائے اس ویب ہک کی زور دار سفارش کرتا ہے، کیونکہ اس سے ریٹ لمٹ بچتی ہے۔
ایونٹ سے کمنٹ کا جواب کیسے دیں؟
اس میں موجود IDs کے ساتھ۔ message کے ساتھ POST /<COMMENT_ID>/replies، value.id استعمال کرتے ہوئے کمنٹ کے نیچے عوامی جواب بھیجتا ہے۔ recipient.comment_id کو value.id پر سیٹ کرکے POST /<IG_ID>/messages، مصنف کو ایک نجی جواب بھیجتا ہے، کمنٹ کے 7 دن کے اندر، یا لائیو براڈکاسٹ کے دوران جب تک وہ چلتی ہے۔ from.id ایک Instagram-scoped ID ہے، مگر اس پر براہِ راست بھیجا گیا DM ناکام ہوتا ہے جب تک وہ شخص اکاؤنٹ کو میسج نہ کرے، اس لیے نجی جواب ہی DM کے ذریعے ان تک پہنچنے کا طریقہ ہے۔
easyCoexistence کمنٹ کو کیسے آگے بھیجتا ہے؟
جیسے ہی وہ آتا ہے، جب اکاؤنٹ کے لیے ایک اینڈ پوائنٹ set_social_webhook_destination کے ذریعے Claude یا ChatGPT سے، یا Partner API پر PUT /channels/:id/webhook کے ذریعے سیٹ کیا جا چکا ہو۔ easyCoexistence ہر جڑے ہوئے اکاؤنٹ کو ان فیلڈز کے لیے سبسکرائب کرتا ہے جو اس کے کمنٹس، mentions اور DMs لاتی ہیں، ہر ڈیلیوری پر Meta کا دستخط چیک کرتا ہے، فوراً Meta کو جواب دیتا ہے، اور اس اکاؤنٹ کی ہر entry ایک لفافے میں آپ کے HTTPS URL پر POST کرتا ہے:
- platform اور
external_id: instagram، اور اکاؤنٹ کا Instagram ID، جو entry.id کے برابر ہوتا ہے۔ account_id: easyCoexistence میں کنکشن کا ID، وہی جوlist_social_accountsواپس کرتا ہے اور جسے MCP ٹولز لیتے ہیں۔- entry: اکاؤنٹ کے لیے Meta کی entry، بغیر تبدیلی کے، تاکہ ایک گروپ شدہ ڈیلیوری ہر entry کے لیے ایک POST بن جائے۔ Meta کی object فیلڈ اور X-Hub-Signature-256 آگے نہیں بھیجے جاتے۔
- ڈیلیوری: ایک کوشش، 8 سیکنڈ تک انتظار، بغیر ری ڈائریکٹ کی پیروی کے، ایک HTTPS پتے پر جو عوامی IP پر حل ہوتا ہو۔ کوئی نقل محفوظ نہیں رکھی جاتی اور کچھ دوبارہ کوشش نہیں کی جاتی۔
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": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}کمنٹ سے DM والے قواعد اسی ایونٹ کے ساتھ کیا کرتے ہیں؟
یہ اسے آگے بھیجے جانے کے ساتھ ساتھ پڑھتے ہیں۔ کوئی قاعدہ اس وقت مماثل ہوتا ہے جب کمنٹ میں اس کے کلیدی الفاظ میں سے کوئی ہو، حروف کی حالت کو نظر انداز کرتے ہوئے، ایک منتخب پوسٹ پر یا ان سب پر، اور وہ مصنف کو قاعدے کا DM نجی جواب کے طور پر بھیجتا ہے، اور اگر قاعدے میں عوامی جواب ہو تو وہ بھی۔ اکاؤنٹ کے اپنے کمنٹس چھوڑ دیے جاتے ہیں، کمنٹ پر شروع ہونے والے خودکار عمل ان کمنٹس کو لیتے ہیں جن کا کسی قاعدے نے جواب نہیں دیا، اور وہ کمنٹ جس کا کسی قاعدے نے جواب دیا ہو، پھر بھی آپ کے اینڈ پوائنٹ تک پہنچتا ہے۔ قاعدے کا عوامی جواب اکاؤنٹ کی طرف سے ایک نئے comments ایونٹ کے طور پر واپس آ سکتا ہے۔
عام غلطیاں
- comment_id تلاش کرنا: Instagram Login کے تحت کمنٹ کا ID value.id میں ہوتا ہے؛ comment_id Meta کے دوسرے لاگ ان سیٹ اپس کے پے لوڈ میں ہوتا ہے۔
- اکاؤنٹ کے اپنے کمنٹس کا جواب دینا: اس کے جوابات comments ایونٹس کے طور پر واپس آتے ہیں جن میں from.id، entry.id کے برابر ہوتا ہے، اور جو خودکار عمل ان کا جواب دیتا ہے وہ خود اپنے ساتھ بات کرنے لگتا ہے۔
- entry.time کو کمنٹ کا وقت سمجھنا: یہ وہ وقت ریکارڈ کرتا ہے جب Meta نے اطلاع بھیجی؛ کمنٹ کی اپنی timestamp فیلڈ بتاتی ہے کہ وہ کب لکھا گیا۔
- لائیو کمنٹس کا comments فیلڈ پر انتظار: یہ live_comments پر آتے ہیں، جسے اپنی الگ سبسکرپشن درکار ہے، اور براڈکاسٹ ختم ہوتے ہی خاموش ہو جاتے ہیں۔
کمنٹ سے DM کے قواعد اور خودکار عمل انہی کمنٹس کا 24 گھنٹے جواب دیتے ہیں۔ US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ، کنکشن بڑھانے کے ساتھ قیمت کم ہوتی جاتی ہے، اور پہلے 3 دن کا فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا Instagram کمنٹس ویب ہک میں کمنٹس کے جوابات شامل ہوتے ہیں؟
ہاں۔ جواب اپنے الگ comments ایونٹ کے طور پر آتا ہے، جس میں parent_id اس کمنٹ کا ID رکھتا ہے جس کا وہ جواب ہے۔
کیا Reels کے کمنٹس Instagram کمنٹس ویب ہک کو فائر کرتے ہیں؟
ہاں۔ Reel پر کمنٹ پوسٹ والے کمنٹ کی طرح comments فیلڈ پر آتا ہے، اور media.media_product_type ان دونوں کو الگ کرتا ہے۔
میرا Instagram کمنٹس ویب ہک فائر کیوں نہیں ہو رہا؟
زیادہ تر صورتوں میں ایپ Live نہیں ہوتی یا اس کے پاس Advanced Access نہیں ہوتا، اکاؤنٹ کو /subscribed_apps کے ذریعے کبھی سبسکرائب نہیں کیا گیا، میڈیا کسی نجی اکاؤنٹ کا ہے، یا کمنٹ لائیو پر تھا، جو live_comments استعمال کرتا ہے۔
کیا comments ویب ہک میں کمنٹ کرنے والے کا صارف نام شامل ہوتا ہے؟
ہاں۔ value.from میں اس شخص کا صارف نام اس کے Instagram-scoped ID کے ساتھ ہوتا ہے، اس لیے یہ دکھانے کے لیے کہ کس نے کمنٹ کیا، کسی اضافی کال کی ضرورت نہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ