لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

Instagram ویب ہک ایونٹس: تبصرے، منشنز اور DMs

Instagram ویب ہک ایونٹس پروفیشنل اکاؤنٹ پر ہونے والی سرگرمی کو اسی وقت رپورٹ کرتے ہیں: نئے تبصرے، @منشنز اور DMs۔ Meta ہر ایک کو JSON کی صورت میں جڑی ہوئی ایپ کے HTTPS اینڈ پوائنٹ پر POST کرتا ہے اور اس اینڈ پوائنٹ پر ناکام ڈیلیوری کو 36 گھنٹے تک دوبارہ بھیجتا ہے۔ easyCoexistence ہر ایونٹ کو ایک بار آپ کے اینڈ پوائنٹ تک آگے بھیجتا ہے، ہر اکاؤنٹ کے لیے دستخط شدہ، اور دوبارہ کوشش نہیں کی جاتی۔ Instagram Login کے ساتھ منشنز تبصروں کی اطلاع کے اندر آتے ہیں۔

36 hours

Meta ایپ کے اینڈ پوائنٹ پر ناکام ڈیلیوری کو چھوڑنے سے پہلے کتنی دیر تک دوبارہ کوشش کرتا رہتا ہے۔

1,000

Meta زیادہ تر اپ ڈیٹس کو ایک ہی ویب ہک ڈیلیوری میں اکٹھا کرتا ہے، اگرچہ وہ اس کی ضمانت نہیں دیتا۔

is_echo

وہ فلیگ جو Meta ان میسج ایونٹس پر لگاتا ہے جو اکاؤنٹ نے خود بھیجے ہوں۔

Public

صرف پبلک اکاؤنٹس کے میڈیا پر تبصروں اور منشنز کی اطلاعات شروع ہوتی ہیں۔

کون سے ایونٹس ہیں؟

ایک پروفیشنل اکاؤنٹ کے لیے جو 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 کے ساتھ۔ نیا تبصرہ یوں نظر آتا ہے:

A forwarded comment event
{
  "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 منٹ سے پرانا ٹائم اسٹیمپ مسترد کریں۔

Node.js: verifying X-EC-Signature
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_echo true پر سیٹ ہونے والا میسج ایونٹ خود اکاؤنٹ نے بھیجا ہوتا ہے، اس لیے اسے جواب کی ضرورت نہیں۔
  • 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 کے ساتھ یہ کام کرنا

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 منشنز کو تبصروں کی اطلاع میں شامل کرتا ہے، اس لیے یہ تبصروں والے راستے پر ہی پہنچتے ہیں۔

مزید پڑھیں

API کے ذریعے Instagram کمنٹس کا انتظامInstagram کا API کمنٹس پڑھتا، ان کا جواب دیتا، چھپاتا اور حذف کرتا ہے: عوامی جواب، ہر کمنٹ پر سات دن میں ایک نجی جواب، اور لاگو قواعد۔API کے ذریعے Instagram DMs اور 24 گھنٹے کی ونڈوInstagram DMs API کے ذریعے کام کرتے ہیں: کون اکاؤنٹ کو میسج کر سکتا ہے، 24 گھنٹے کی ونڈو، پرائیویٹ جوابات، اور Allow access to messages سیٹنگ۔Instagram API کے عام ایرر کوڈز اور ان کا مطلبInstagram API کی عام خرابیاں اور ان کا مطلب: ایکسپائر ٹوکن، ریٹ لمٹ، میڈیا جو Meta حاصل نہیں کر سکتا، پبلشنگ کی حد اور بند DM ونڈو۔کون سے Instagram اکاؤنٹس API کے ساتھ کام کرتے ہیں: کاروبار، کری ایٹر یا پرسنلInstagram کا API پروفیشنل اکاؤنٹس کے ساتھ کام کرتا ہے، کاروبار یا کری ایٹر۔ کون سا چنیں، سوئچ کرنے سے کیا بدلتا ہے، اور ایپ میں کیسے سوئچ کریں۔Instagram کمنٹس ویب ہک: پے لوڈ، ہر فیلڈ کی تفصیلکسی اکاؤنٹ کی پوسٹس اور Reels پر کمنٹ آنے پر Instagram کا کمنٹس ویب ہک کیا بھیجتا ہے، پے لوڈ کی ہر فیلڈ، اس میں کیا شامل نہیں ہوتا، اور عام خرابیاں۔Instagram میسجز ویب ہک: DM پے لوڈ، ایکو اور فیلڈزInstagram کا میسجز ویب ہک DM کے لیے کیا بھیجتا ہے: بھیجنے والے کی ID، متن، اٹیچمنٹس، Story کے جواب، ایکو، فیلڈ بہ فیلڈ، اور 24 گھنٹے کی ونڈو۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ