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

Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹس

Facebook کے Page ویب ہکس میں messages فیلڈ اس وقت فائر ہوتا ہے جب کوئی شخص Page کو Messenger میسج بھیجتا ہے، اور ایک messaging ایرے فراہم کرتا ہے جس میں سینڈر کی Page-scoped ID، Page کی ID، ٹائم اسٹیمپ اور میسج کی mid اس کے متن یا اٹیچمنٹس کے ساتھ شامل ہوتے ہیں۔ mention فیلڈ Page کے پوسٹس اور کمنٹس میں نئے منشنز کی اطلاع دیتا ہے، اور دونوں کو X-Hub-Signature-256 سے سائن کیا جاتا ہے۔

easyCoexistence ہر جڑے ہوئے Page کے Messenger میسجز اور منشنز کو آتے ہی آپ کے HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے، اس Page کے لیے مخصوص سیکرٹ سے سائن کر کے، اور بغیر کوئی کاپی رکھے، جبکہ send_social_dm 24 گھنٹے کی ونڈو کے اندر جواب دیتا ہے۔

5 seconds

Meta کو Messenger ویب ہک اینڈ پوائنٹ سے ہر اطلاع کا جواب 200 OK کے ساتھ کتنی جلدی درکار ہے۔

1 hour

اگر ڈیلیوری اتنی دیر تک ناکام رہے تو Meta ایپ کی Page ویب ہکس سے سبسکرپشن ختم کر دیتا ہے، جب تک وہ دوبارہ سبسکرائب نہ کرے۔

PSID

messages ایونٹ میں سینڈر کی Page-scoped ID، جو ہر شخص اور Page کے جوڑے کے لیے منفرد ہوتی ہے۔

Workplace only

Meta کا حوالہ mention ایونٹ کی سینڈر فیلڈ کو کیسے نشان زد کرتا ہے۔

No history

پچھلی ویب ہک اطلاعات بعد میں دوبارہ کیوری نہیں کی جا سکتیں، اس لیے وصول کنندہ کو جو ضروری ہو وہ خود محفوظ کرنا ہوگا۔

messages فیلڈ کیا بھیجتا ہے؟

جب کوئی شخص Page کو Messenger میسج بھیجتا ہے تو اطلاع آتی ہے۔ Meta متنی میسجز یا اٹیچمنٹس والے میسجز بھیجتا ہے، جو تصاویر، آڈیو، ویڈیو، فائلیں یا اسٹیکرز، اور دیگر اقسام بھی ہو سکتے ہیں، اور شیئر کیا گیا لنک فال بیک اٹیچمنٹ کے طور پر بھی آ سکتا ہے۔ پچھلے میسج کا جواب reply_to فیلڈ میں اس میسج کی mid رکھتا ہے، اور کوئیک ریپلائی اپنا پے لوڈ لاتا ہے۔

messages ایونٹ کیسا دکھتا ہے؟

feed تبدیلیوں کے برعکس، میسج Page کی entry کے اندر messaging ایرے میں آتا ہے۔ ہر ایونٹ میں sender شامل ہوتا ہے، یعنی شخص کی Page-scoped ID؛ recipient، یعنی Page؛ ایک ٹائم اسٹیمپ؛ اور message، جس میں اس کی mid اور متن ہوتا ہے، یا attachments جن میں type اور payload URL ہوتے ہیں:

A messages event, as Meta sends it
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1458692752478,
      "messaging": [
        {
          "sender": { "id": "<PSID>" },
          "recipient": { "id": "<PAGE_ID>" },
          "timestamp": 1458692752478,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "hello, world!"
          }
        }
      ]
    }
  ]
}

mention فیلڈ کیا بھیجتا ہے؟

جب کسی پوسٹ یا کمنٹ میں Page کا ذکر ہو تو mention فیلڈ کے ساتھ ایک change ایونٹ آتا ہے، جس میں post_id یا comment_id، میسج، کوئی لنک، تصویر یا ویڈیو، اور item اور verb شامل ہوتے ہیں۔ Meta خبردار کرتا ہے کہ کچھ پوسٹ اور کمنٹ IDs اجازت کی کمی یا رازداری کی وجہ سے کیوری نہیں ہو سکتیں، اور اس کا حوالہ sender فیلڈ کو صرف Workplace کے لیے بتاتا ہے، اس لیے کوئی منشن اپنے مصنف کے بغیر بھی آ سکتا ہے۔

کون سے Messenger فیلڈز آگے نہیں بھیجے جاتے؟

easyCoexistence Pages کو صرف messages کے لیے سبسکرائب کرتا ہے، message_echoes، messaging_postbacks، message_reads یا message_deliveries کے لیے نہیں، اس لیے وہ میسجز جو Page بھیجتا ہے، بٹن ٹیپس، اور ریڈ یا ڈیلیوری رسیدیں آگے نہیں بھیجی جاتیں۔ send_social_dm کے ذریعے بھیجا گیا جواب اس کے بجائے اپنا میسج ID واپس کرتا ہے۔

ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں؟

Meta Page کی ویب ہکس اس ایپ کو بھیجتا ہے جسے Page نے انسٹال کیا ہو، پوری ایپ کے لیے ایک کال بیک URL کے ذریعے۔ easyCoexistence ہر ڈیلیوری پر Meta کا X-Hub-Signature-256 چیک کرتا ہے، فوراً Meta کو جواب دیتا ہے، اور جڑے ہوئے Page کی ہر entry کو اس HTTPS اینڈ پوائنٹ پر آگے بھیجتا ہے جو آپ نے اس کے لیے مقرر کیا ہو، جو اسی Page کے اپنے سیکرٹ سے سائن کیا جاتا ہے۔ اسے Claude یا ChatGPT سے set_social_webhook_destination کے ذریعے، یا Partner API پر PUT /channels/:id/webhook سے سیٹ کریں؛ سیکرٹ ایک بار دکھایا جاتا ہے، اسے دوبارہ سیٹ کرنے سے نیا جاری ہوتا ہے، اور null URL آگے بھیجنا بند کر دیتا ہے۔

آگے بھیجا گیا ایونٹ کیسا دکھتا ہے؟

ایک POST ہوتی ہے جس میں platform، list_social_accounts کا دیا ہوا account_id (جو Page کے کنکشن کا ہوتا ہے)، Page کی ID بطور external_id، اور entry شامل ہوتے ہیں، یعنی Page کے لیے Meta کی entry بغیر کسی تبدیلی کے۔ sender.id وہی recipient_id ہے جو 24 گھنٹے کی ونڈو کے اندر جواب کے لیے send_social_dm لیتا ہے:

A forwarded messages event
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400000,
    "messaging": [
      {
        "sender": { "id": "<PSID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399000,
        "message": { "mid": "<MESSAGE_ID>", "text": "<MESSAGE_TEXT>" }
      }
    ]
  }
}

آگے بھیجے گئے ایونٹ کی تصدیق کیسے کریں؟

ہر آگے بھیجی گئی POST میں X-EC-Signature ہیڈر ہوتا ہے جس کی شکل t=<unix>,v1=<hex> ہے، جہاں v1 ٹائم اسٹیمپ، ایک ڈاٹ اور خام body کا HMAC-SHA256 ہے، جو Page کے سائننگ سیکرٹ سے کیا ہوا ہے۔ body کو بالکل ویسے حساب کریں جیسے وہ موصول ہوئی، constant time میں موازنہ کریں، اور 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 ایسا نہیں کرتا۔ ہر entry ایک بار، میموری میں آگے بھیجی جاتی ہے، بغیر کسی کاپی کے جس سے دوبارہ کوشش ہو سکے؛ آگے بھیجنے کے عمل میں جواب کے لیے 8 سیکنڈ انتظار کیا جاتا ہے، ری ڈائریکٹ فالو نہیں کیے جاتے، اور صرف ایسے HTTPS پتے پر بھیجا جاتا ہے جو عوامی IP پر حل ہوتا ہو۔ Meta نوٹ کرتا ہے کہ پچھلی اطلاعات بعد میں کیوری نہیں ہو سکتیں، اس لیے جو ضروری ہو وہ آتے ہی محفوظ کریں۔ Meta کی طرف سے ناکام ڈیلیوری چند بار فوراً دوبارہ بھیجی جاتی ہے، اس لیے وہی میسج کبھی کبھار دو بار پہنچ سکتا ہے: اس کی mid پر ڈپلیکیٹ ہٹائیں۔

عام غلطیاں

  • جواب سے پہلے کام کرنا۔ فارورڈنگ دوبارہ کوشش نہیں کرتی، اس لیے فوراً 2xx لوٹائیں اور ایونٹ بعد میں پروسیس کریں۔
  • پارس شدہ JSON پر دستخط کی تصدیق کرنا۔ HMAC کو خام body پر بالکل ویسے حساب کریں جیسے وہ پہنچی تھی۔
  • فرض کرنا کہ میسج میں ہمیشہ متن ہوتا ہے۔ اسٹیکر، تصویر یا شیئر کیا گیا لنک attachments میں آتا ہے، اور اس میں text فیلڈ نہیں ہوتی۔
  • ڈپلیکیٹ ہٹانا چھوڑ دینا۔ Meta ناکامی کے بعد ایونٹ دوبارہ بھیج سکتا ہے، اس لیے کارروائی سے پہلے mid کی بنیاد پر پہچانیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

فارورڈنگ set_social_webhook_destination یا Partner API سے آن کریں۔ US$ 9 سے US$ 0.75 تک فی کنکشن ماہانہ، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی جاتی ہے، پہلے 3 دن فری ٹرائل میں شامل ہیں۔

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

easyCoexistence Page کو کون سے ویب ہک فیلڈز سبسکرائب کرتا ہے؟

Messenger کے لیے messages، منشنز کے لیے mention، اور Page کی پوسٹس اور کمنٹس کے لیے feed ہے۔

کیا Messenger کے اسٹیکر یا تصویر کے ساتھ متن آتا ہے؟

نہیں۔ اسٹیکر، تصویر یا شیئر کیا گیا لنک attachments میں آتا ہے، ہر ایک کے ساتھ type اور payload URL ہوتا ہے، اور میسج میں text فیلڈ نہیں ہوتی۔

Messenger ویب ہک اینڈ پوائنٹ کتنی جلدی جواب دے؟

5 سیکنڈ کے اندر 200 OK۔ ناکام ڈیلیوری کے 1 گھنٹے بعد Meta ایپ کی Page ویب ہکس سے سبسکرپشن ختم کر دیتا ہے۔

فارورڈ کیے گئے میسج کا جواب کیسے دوں؟

24 گھنٹے کے اندر، جب شخص کا میسج آیا ہو، send_social_dm کو recipient_id کے طور پر ایونٹ کا sender.id دے کر کال کریں۔

مزید پڑھیں

Facebook Page feed ویب ہک: کمنٹس، پوسٹس اور ری ایکشنز کے ایونٹسFacebook Page فیڈ ویب ہک کیا بھیجتا ہے: کمنٹس، پوسٹس اور ری ایکشنز، آئٹم اور ورب فیلڈز، میٹا کا پے لوڈ ڈھانچہ، اور Page کیسے سبسکرائب کرتا ہے۔Messenger 24 گھنٹے کی ونڈو: Facebook Page کب کسی کو میسج کر سکتا ہےفیس بک Page کب Messenger پر کسی کو میسج کر سکتا ہے: معیاری 24 گھنٹے کی ونڈو، اسے کھولنے والے اقدامات، اور اشتہار کے بعد 7 دن تک۔Facebook نجی جوابات API: پیج پر تبصرہ کرنے والے کو میسج کریںمیٹا کے API سے فیس بک نجی جواب بھیجیں: کمنٹ کی ID کے ساتھ POST /{page-id}/messages، 7 دن کے اندر ایک Messenger میسج، اور خرابیاں۔Facebook Page API اجازتیں اور ایپ ریویو کی ضروریاتنو فیس بک پیج اجازتیں، ان سے کیا کھلتا ہے، اور Meta کا ایپ ریویو ان کے لیے کیا مانگتا ہے: ایڈوانسڈ ایکسیس، کاروباری تصدیق، اور اسکرین ریکارڈنگ۔Facebook Page ایکسیس ٹوکن: کتنی دیر چلتا ہے اور کیا اسے بے اثر کرتا ہےFacebook Page کا ایکسیس ٹوکن جس کی میعاد ختم نہیں ہوتی: اسے کیسے حاصل کیا جاتا ہے، کون اسے حاصل کر سکتا ہے، اور Meta کب اسے قبول نہیں کرتا۔Facebook ایرر 551: یہ شخص Messenger پر دستیاب نہیںFacebook ایرر 551، یہ شخص ابھی دستیاب نہیں: Messenger اس شخص تک نہیں پہنچ سکا، جس نے Page کو بلاک کیا ہو یا اکاؤنٹ غیر فعال کیا ہو۔

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

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

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

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