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

Instagram میسجز ویب ہک: DM پے لوڈ، ایکو اور فیلڈز

Instagram کا میسجز ویب ہک فیلڈ کسی پروفیشنل اکاؤنٹ کے DMs کو ان کے پہنچتے ہی بھیجتا ہے: متن، اٹیچمنٹس، شیئرز، Story کے جوابات، منشنز، ان لائن جوابات اور حذف شدہ میسجز۔ ہر ایونٹ ایک messaging array میں ہوتا ہے جس میں بھیجنے والے کی Instagram-scoped ID، وصول کنندہ، ٹائم اسٹیمپ اور ایک message object ہوتا ہے، اور اکاؤنٹ کے اپنے بھیجے ہوئے میسجز اسی فیلڈ پر واپس آتے ہیں جن میں is_echo کی ویلیو true ہوتی ہے۔

easyCoexistence ہر جڑے ہوئے Instagram اکاؤنٹ کو messages کے لیے سبسکرائب کرتا ہے اور اس کے DMs، جن میں ایکو بھی شامل ہیں، آتے ہی آپ کے HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے، اس اکاؤنٹ کے secret کے ساتھ دستخط شدہ؛ فارورڈنگ کوئی نقل نہیں رکھتی، اور DMs بطور ڈیفالٹ محفوظ نہیں کیے جاتے۔

is_echo

اکاؤنٹ کے خود بھیجے گئے میسج کے ایونٹ پر is_echo کو true پر سیٹ کیا جاتا ہے۔

24 hours

زیادہ تر صارف اقدامات کے لیے معیاری میسجنگ ونڈو، جس کے دوران ایپ اس شخص کو جواب دے سکتی ہے۔

ig_post

شیئر کی گئی پوسٹ کے لیے اٹیچمنٹ کی قسم؛ پرانی شیئر قسم صرف یکم فروری 2026 تک سپورٹ ہوئی۔

story_mention

DM ایونٹ کی اٹیچمنٹ کی وہ قسم جو Meta بھیجتا ہے جب کوئی شخص اپنی Story میں اکاؤنٹ کا ذکر کرے۔

2534041

ایرر سب کوڈ، کوڈ 200 کے تحت، جب اکاؤنٹ کے مالک نے Instagram ڈائریکٹ میسجز تک رسائی بند کی ہو۔

میسجز فیلڈ کب فائر ہوتا ہے؟

جب کوئی شخص پروفیشنل اکاؤنٹ کو DM بھیجتا ہے، اور جب اکاؤنٹ خود کوئی DM بھیجتا ہے۔ Meta کی مثالیں اور حوالہ جات ان صورتوں کی فہرست دیتے ہیں، جن میں سے ہر ایک ایک message object کے ساتھ messaging ایونٹ ہے:

  • متن، اور میڈیا بطور اٹیچمنٹس: تصاویر، ویڈیو، آڈیو اور فائلیں۔
  • شیئر کی گئی پوسٹ یا Reel، بطور ig_post، ig_reel یا reel اٹیچمنٹ۔
  • اکاؤنٹ کی Story پر جواب، reply_to.story کے ساتھ، اور وہ Story جس میں اکاؤنٹ کا ذکر ہو، بطور story_mention اٹیچمنٹ۔
  • کسی پچھلے میسج کا ان لائن جواب، reply_to.mid کے ساتھ، اور quick reply، quick_reply.payload کے ساتھ۔
  • وہ میسج جو شخص نے حذف کیا (is_deleted)، غیر معاون میڈیا (is_unsupported)، اور کسی ایسے شخص کا میسج جس نے Click-to-Direct اشتہار پر کلک کیا تھا (referral)۔
  • اکاؤنٹ کا بھیجا ہوا میسج، جو is_echo کی ویلیو true کے ساتھ واپس آتا ہے۔

میسجز نوٹیفکیشن کیسا دکھتا ہے؟

ایک POST جس کے JSON میں object کی ویلیو instagram ہوتی ہے۔ کمنٹ کے برعکس، میسج اکاؤنٹ کے entry کے اندر messaging array میں ہوتا ہے، اور ہر عنصر میں sender، recipient، timestamp اور message ہوتے ہیں۔ اکاؤنٹ کی Story پر جواب کچھ یوں دکھتا ہے:

A messages notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "<MESSAGE_TEXT>",
            "reply_to": {
              "story": {
                "url": "<CDN_URL_FOR_THE_STORY>",
                "id": "<STORY_ID>"
              }
            }
          }
        }
      ]
    }
  ]
}

ہر فیلڈ کا کیا مطلب ہے؟

وہ فیلڈز جو Meta نے Instagram Login کے تحت میسج ایونٹ کے لیے دستاویز کیے ہیں، باہر سے اندر کی طرف:

  • entry[].id: پروفیشنل اکاؤنٹ کی ID۔ entry[].time: وہ وقت جب Meta نے نوٹیفکیشن بھیجا؛ Meta کے messaging نمونوں میں یہ ملی سیکنڈ میں ہوتا ہے۔
  • sender.id اور recipient.id: آنے والے DM پر، شخص کی Instagram-scoped ID اور اکاؤنٹ کی ID؛ ایکو پر، یہی دونوں الٹ ترتیب میں۔
  • timestamp: جب میسج بھیجا گیا؛ Meta کے نمونوں میں ملی سیکنڈ میں۔ میسجز کو اسی سے ترتیب دیں، آمد کے وقت سے نہیں۔
  • message.mid: میسج ID، ڈپلیکیٹ ہٹانے، ردعمل دینے، اور reply_to.mid کے ساتھ اس میسج کا جواب دینے کے لیے۔
  • message.text: جب میسج میں متن ہو تو شامل۔
  • message.attachments[]: ہر ایک میں type اور payload، عموماً url کے ساتھ۔ شیئر کی گئی پوسٹ کے ig_post payload میں ig_post_media_id اور title شامل ہوتے ہیں، جو اس کا کیپشن ہے۔
  • message.reply_to: ان لائن جواب کے لیے mid، یا Story کے جواب کے لیے story، جس میں Story کا url اور id ہو۔
  • message.quick_reply.payload اور message.referral: چنا گیا quick reply، اور Click-to-Direct اشتہار کا ref، ad_id، source، type اور ads_context_data۔
  • message.is_deleted، is_echo، is_self اور is_unsupported: صرف اس صورت میں شامل جب ان کی ویلیو true ہو۔
  • message.admin_text اور handoff_reason: اہل ایپس پر، ایک نوٹس کہ کوئی Meta ایپلیکیشن، جیسے Meta Business Agent، نے گفتگو منتقل کی؛ یہ mid یا text کے بغیر بھی آ سکتا ہے۔

ایکو کیسے کام کرتے ہیں؟

جب اکاؤنٹ کوئی میسج بھیجتا ہے، Meta اس کے لیے بھی ایک messages ایونٹ بھیجتا ہے، جس میں is_echo کی ویلیو true ہوتی ہے۔ اس صورت میں sender.id اکاؤنٹ ہوتا ہے اور recipient.id اس شخص کی Instagram-scoped ID، اور وہ ٹیسٹ میسج جو اکاؤنٹ خود کو بھیجے، is_self بھی رکھتا ہے۔ ایکو وہ ریکارڈ رکھتے ہیں جو اکاؤنٹ نے کہا، جو گفتگو کے لاگ کے لیے ضروری ہے، لیکن جو ہینڈلر یہ فیصلہ کرے کہ جواب دینا ہے یا نہیں، اسے انہیں چھوڑ دینا ہوگا۔ جب اکاؤنٹ کسی میسج پر ردعمل دیتا یا ردعمل ہٹاتا ہے تو Meta کوئی ایکو نہیں بھیجتا۔

An echo of a message the account sent
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448061203,
      "messaging": [
        {
          "sender": { "id": "<IG_ID>" },
          "recipient": { "id": "<IGSID>" },
          "timestamp": 1793448060950,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "<REPLY_TEXT>",
            "is_echo": true
          }
        }
      ]
    }
  ]
}

کس ID پر جواب دیں؟

sender.id، شخص کی Instagram-scoped ID۔ Meta اسے اس وقت بناتا ہے جب کوئی شخص اکاؤنٹ کو میسج کرے یا اس کے میڈیا پر کمنٹ کرے، اور یہ اس شخص اور اس اکاؤنٹ کے لیے خاص ہوتی ہے۔ POST /<IG_ID>/messages، جس میں recipient.id کو اس پر سیٹ کیا گیا ہو، جواب بھیجتا ہے۔ ایونٹ میں کوئی نام یا یوزر نیم نہیں ہوتا؛ GET /<IGSID> کے ساتھ name اور username جیسی فیلڈز واپس آتی ہیں، کیونکہ جس شخص نے اکاؤنٹ کو میسج کیا ہو، اس نے وہ رضامندی دی ہوتی ہے جو اس lookup کے لیے درکار ہے۔

ایک میسج 24 گھنٹے کی ونڈو کیسے کھولتا ہے؟

کوئی ایپ کسی شخص کو صرف اسی وقت میسج کر سکتی ہے جب اس نے اکاؤنٹ کو میسج کیا ہو، اور صرف اس معیاری میسجنگ ونڈو کے اندر جو اس کا اقدام کھولتا ہے۔ زیادہ تر اقدامات کے لیے یہ 24 گھنٹے رہتی ہے، اور Click-to-Direct اشتہار پر کلک کے بعد بھیجے گئے پہلے میسج سے 7 دن تک۔ شخص کا نیا میسج نئی ونڈو کھولتا ہے، اس لیے اس کا آخری ٹائم اسٹیمپ ٹریک کریں؛ ایکو اکاؤنٹ کا اپنا میسج ہے اور کوئی ونڈو نہیں بڑھاتا۔ شخص کے لکھے ہوئے جوابات Meta کی الگ 7 دن کی Human Agent ونڈو استعمال کر سکتے ہیں، جو human_agent کے ٹیگ سے نشان زد ہو۔

messages ایونٹ میں کیا نہیں ہوتا؟

Meta کے messaging حوالہ جات کے مطابق کچھ چیزیں جو ہینڈلر تلاش کر سکتا ہے، غائب ہیں:

  • شخص کا نام یا یوزر نیم: صرف Instagram-scoped ID، جسے GET /<IGSID> حل کرتا ہے۔
  • ایک بار دیکھے جانے والا میڈیا: یہ URL کے بغیر عارضی اٹیچمنٹ کے طور پر آتا ہے۔
  • کیروسیل کی درست تصویر: کیروسیل پوسٹ کی ایک تصویر پر ردعمل یا فارورڈ، پہلی تصویر رپورٹ کرتا ہے۔
  • ردعمل، ایڈٹس اور ریڈ رسیپٹس، جو اپنی الگ فیلڈز پر آتے ہیں۔
  • ریڈ مارک: webhook سے ڈیلیور ہونے والا میسج، جواب بھیجے جانے تک Instagram ان باکس میں غیر پڑھا رہتا ہے۔

Meta کون سی دوسری messaging فیلڈز درج کرتا ہے؟

Meta کی فیلڈ فہرست اور Instagram Login کی مثالیں messages کے علاوہ یہ نام دیتی ہیں، جن میں سے ہر ایک کا اپنا messaging ایونٹ ہے۔ easyCoexistence ہر اکاؤنٹ کو صرف messages، comments اور mentions کے لیے سبسکرائب کرتا ہے، اس لیے ان میں سے کوئی بھی وہ حصہ نہیں جو یہ آگے بھیجتا ہے:

  • message_reactions: شخص کسی میسج پر ردعمل دیتا ہے یا ردعمل ہٹاتا ہے، جس میں reaction.mid، action کی ویلیو react یا unreact، اور reaction اور emoji ہوتے ہیں۔
  • message_edit: شخص میسج ایڈٹ کرتا ہے، جس میں message_edit.mid، نیا متن اور num_edit ہوتے ہیں۔
  • messaging_postbacks: شخص کوئی icebreaker یا template بٹن دباتا ہے، جس میں postback.mid، title اور payload ہوتے ہیں۔
  • messaging_referral: گفتگو میں پہلے سے موجود شخص ref پیرامیٹر والا ig.me لنک کھولتا ہے۔
  • messaging_seen: شخص میسج پڑھتا ہے، جس میں read.mid ہوتا ہے۔
  • messaging_optins، messaging_handover اور standby: آخری دو ان ایپس کے لیے جو Meta کے handover پروٹوکول کے تحت گفتگو شیئر کرتی ہیں۔

اکاؤنٹ کو کیا آن کرنا ہوگا؟

میسجز تک رسائی کی اجازت دیں۔ Meta تقاضا کرتا ہے کہ پروفیشنل اکاؤنٹ اسے آن کرے، پھر API کے ذریعے اس کے میسجز منیج ہو سکتے ہیں، Instagram ایپ میں Settings، Messages and story replies، Message controls، Connected tools کے تحت۔ جب تک یہ بند ہے، کوڈ 200، سب کوڈ 2534041 کے ساتھ بھیجنا ناکام ہوتا ہے۔ ایپ کو instagram_business_basic اور instagram_business_manage_messages بھی درکار ہیں، اور جن اکاؤنٹس کی وہ مالک یا منیجر نہیں، ان کی خدمت کے لیے Advanced Access بھی۔

easyCoexistence DM کو کیسے آگے بھیجتا ہے؟

کمنٹ کی طرح: اکاؤنٹ کے لیے Meta جو بھی entry بھیجتا ہے، وہ آپ کے HTTPS اینڈ پوائنٹ پر platform، account_id، external_id اور entry کے لفافے میں POST کی جاتی ہے، اکاؤنٹ کے secret کے ساتھ X-EC-Signature میں دستخط شدہ، ایک بار، اور کوئی نقل محفوظ کیے بغیر۔ ایکو باقی کے ساتھ آگے بھیجے جاتے ہیں، اس لیے جواب دینے سے پہلے is_echo چیک کریں۔ جواب دینے کے لیے send_social_dm کو account_id اور ایونٹ کے sender.id کو recipient_id کے طور پر کال کریں، 24 گھنٹے کی ونڈو کے اندر۔ DM پر شروع ہونے والے آٹومیشنز انہی ایونٹس پر چلتے ہیں۔

A forwarded DM with an image
{
  "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": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
          ]
        }
      }
    ]
  }
}

عام غلطیاں

  • ایکو کا جواب دینا۔ جس ایونٹ پر is_echo سیٹ ہو وہ اکاؤنٹ کا اپنا میسج ہے، اور اس کا جواب اکاؤنٹ کو خود اپنے ساتھ ایک لوپ میں ڈال دیتا ہے۔
  • یہ فرض کرنا کہ میسج میں ہمیشہ متن ہوگا۔ اٹیچمنٹس، شیئرز، Story mentions اور حذف شدہ میسجز بغیر text فیلڈ کے آتے ہیں، اس لیے میسج آبجیکٹ میں جو موجود ہو اس کے مطابق فیصلہ کریں۔
  • میسجز کو آمد کے وقت سے ترتیب دینا۔ Meta ناکامی کے بعد میسجز غلط ترتیب میں ڈیلیور کر سکتا ہے، اس لیے انہیں ٹائم اسٹیمپ سے ترتیب دیں۔
  • time اور timestamp کو سیکنڈ سمجھ کر پارس کرنا۔ Meta کے messaging نمونے دونوں ملی سیکنڈ میں دیتے ہیں، اور انہیں سیکنڈ سمجھ کر پڑھا جائے تو وہ بہت دور مستقبل کی تاریخیں بن جاتے ہیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

send_social_dm 24 گھنٹے کی ونڈو کے اندر جواب دیتا ہے، اور آٹومیشنز ایک مقررہ متن یا AI کے ساتھ خود جواب دے سکتی ہیں۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں کنکشن بڑھتے ہیں کم ہوتی جاتی ہے، پہلے 3 دن مفت۔

اکثر پوچھے جانے والے سوالات

کیا Instagram میسج webhook کے ٹائم اسٹیمپ سیکنڈز میں ہیں یا ملی سیکنڈز میں؟

Meta کے messaging نمونوں میں ملی سیکنڈز میں، timestamp اور entry time دونوں کے لیے۔ انہیں سیکنڈ سمجھ کر پڑھا جائے تو وہ بہت دور مستقبل کی تاریخیں بن جاتے ہیں۔

Instagram DM webhook سے بھیجنے والے کا یوزر نیم کیسے حاصل کروں؟

GET /<IGSID> کو name اور username جیسی فیلڈز کے ساتھ کال کریں۔ ایونٹ میں صرف شخص کی Instagram-scoped ID ہوتی ہے۔

میرے Instagram DM webhooks کیوں نہیں آ رہے؟

چیک کریں کہ اکاؤنٹ نے Allow access to messages آن کیا ہوا ہے، وہ /subscribed_apps کے ذریعے messages کے لیے سبسکرائب ہے، اور ایپ Live ہے جس کے پاس ان اکاؤنٹس کے لیے Advanced Access ہے جن کی وہ مالک نہیں۔

کیا easyCoexistence Instagram میسج ردعمل آگے بھیجتا ہے؟

نہیں۔ ردعمل message_reactions پر آتے ہیں، اور easyCoexistence اکاؤنٹس کو messages، comments اور mentions کے لیے سبسکرائب کرتا ہے۔

مزید پڑھیں

Instagram کمنٹس ویب ہک: پے لوڈ، ہر فیلڈ کی تفصیلکسی اکاؤنٹ کی پوسٹس اور Reels پر کمنٹ آنے پر Instagram کا کمنٹس ویب ہک کیا بھیجتا ہے، پے لوڈ کی ہر فیلڈ، اس میں کیا شامل نہیں ہوتا، اور عام خرابیاں۔Instagram ویب ہک تصدیق: hub.challenge اور X-Hub-Signature-256Instagram ویب ہک کا سیٹ اپ: hub.challenge کا جواب دیں، X-Hub-Signature-256 جانچیں، ہر اکاؤنٹ سبسکرائب کریں اور دوبارہ کوششیں سنبھالیں۔Instagram ویب ہک ایونٹس: تبصرے، منشنز اور DMsInstagram کے تبصرے، منشنز اور DMs آپ کے اینڈ پوائنٹ تک ویب ہک ایونٹس کے طور پر کیسے پہنچتے ہیں، ہر پے لوڈ میں کیا ہوتا ہے، اور کیا جانچنا ہے۔API کے ذریعے Instagram DMs اور 24 گھنٹے کی ونڈوInstagram DMs API کے ذریعے کام کرتے ہیں: کون اکاؤنٹ کو میسج کر سکتا ہے، 24 گھنٹے کی ونڈو، پرائیویٹ جوابات، اور Allow access to messages سیٹنگ۔Instagram نجی جواب API: DM کے ذریعے کمنٹ کا جواب دیںMeta کے API سے Instagram نجی جواب بھیجیں: POST /<IG_ID>/messages، کمنٹ کی ID کے ساتھ، ہر کمنٹ پر ایک، 7 دن کے اندر، اور ایرر 2534025۔API کے ذریعے Instagram منشنز: @mention تلاش کرنا اور ان کا جواب دیناAPI کے ذریعے Instagram کے @mentions کیسے آتے ہیں، Instagram Login کے ساتھ کمنٹس ویب ہک پر، اور کمنٹس اور کیپشن میں ان کا جواب کیسے دیں۔

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

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

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

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