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

Facebook منشن ویب ہک: جب کوئی آپ کے پیج کو منشن کرے

Facebook کے پیج ویب ہکس کا mention فیلڈ کسی ایپ کو اس وقت بتاتا ہے جب کوئی پوسٹ یا کمنٹ میں پیج کو @منشن کرے۔ Meta ایک تبدیلی بھیجتا ہے جس کا فیلڈ mention ہوتا ہے، اور اس کی ویلیو میں post_id، کمنٹ کے لیے comment_id، message میں متن، منسلک لنکس اور میڈیا، اور item اور verb شامل ہو سکتے ہیں، جو X-Hub-Signature-256 کے دستخط کے ساتھ POST میں آتا ہے۔

easyCoexistence ہر کنیکٹ کیے گئے پیج کو feed اور messages کے ساتھ mention فیلڈ پر سبسکرائب کرتا ہے، اور اس کے منشن ایونٹس آتے ہی آپ کے HTTPS اینڈ پوائنٹ پر فارورڈ کرتا ہے، اس پیج کے لیے مخصوص راز سے سائن شدہ اور بغیر کوئی کاپی رکھے، تاکہ آپ کے ایجنٹ کو ہر منشن کا اسی وقت پتا چل جائے جب وہ ہوتا ہے۔

mention

پیج کے نئے منشنز کے لیے پیج ویب ہک فیلڈ، جن میں کمنٹس اور پوسٹس دونوں میں منشن شامل ہیں۔

pages_manage_metadata

وہ اجازت جو MODERATE اختیارات والے پیج ایڈمن کو دینی ہوگی، اس سے پہلے کہ پیج ویب ہکس ایپ کے کال بیک URL تک پہنچیں۔

@ + name

لوگ پوسٹ یا کمنٹ میں پیج کو کیسے منشن کرتے ہیں: @ ٹائپ کریں اور پیج کا نام، پھر اسے منتخب کریں۔

36 hours

Meta ناکام پیج نوٹیفکیشن کو کتنی دیر تک، کم ہوتی تعدد کے ساتھ، دوبارہ بھیجتا رہتا ہے، اس سے پہلے کہ اسے چھوڑ دے۔

tagged_time

وہ فیلڈ جو /{page-id}/tagged ایج ہر عوامی پوسٹ کے ساتھ شامل کرتا ہے جس میں پیج کو ٹیگ کیا گیا ہو۔

منشن ویب ہک کو کیا ٹرگر کرتا ہے؟

کوئی شخص کسی پوسٹ یا کمنٹ میں پیج کو منشن کرے۔ Facebook پر منشن @ ٹائپ کر کے اور پیج کا نام لکھ کر، پھر تجاویز میں سے اسے منتخب کر کے کیا جاتا ہے۔ Meta کا حوالہ فیلڈ کو پیج کے نئے منشنز کے طور پر بیان کرتا ہے، جن میں کمنٹس اور پوسٹس میں منشن شامل ہیں۔ Facebook کا Help Center بتاتا ہے کہ پیج کی سیٹنگز لوگوں کو اسے منشن کرنے سے روک سکتی ہیں۔

منشن نوٹیفکیشن کیسا لگتا ہے؟

ایک POST جس کا object ہو page، اور منشن ہونے والے پیج کے لیے ایک entry: اس کا ID، وقت، اور changes ارے جس کا فیلڈ mention ہو۔ Meta کا حوالہ ویلیو کے فیلڈز کی فہرست دیتا ہے مگر کوئی نمونہ نہیں دیتا، اس لیے پوسٹ میں یہ منشن اسی فہرست سے بنایا گیا ہے:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

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

یہ ویلیو کے فیلڈز ہیں، جیسے Meta کے حوالے میں درج ہیں؛ کون سے فیلڈز ایک نوٹیفکیشن میں آتے ہیں، یہ پوسٹ یا کمنٹ پر منحصر ہے:

  • post_id: وہ پوسٹ کا ID جس میں پیج کو منشن کیا گیا۔
  • comment_id: کمنٹ کا ID، جب منشن کسی کمنٹ میں ہو؛ parent_id: اس کے پیرنٹ کا ID۔
  • message: وہ متن جس میں منشن ہے۔
  • link، photo، photos اور video: پوسٹ یا کمنٹ میں منسلک چیزوں کے لنکس۔
  • item اور verb: آبجیکٹ کی قسم اور اس کے ساتھ کیا ہوا، انہی فہرستوں سے جو feed فیلڈ استعمال کرتا ہے۔
  • created_time: جب پوسٹ یا کمنٹ بنایا گیا۔
  • from اور message_tags: مصنف اور متن میں ٹیگ کیے گئے پروفائلز، دونوں صرف Workplace کے لیے نشان زد۔
  • مزید فیلڈز بھی درج ہیں: action، album_id، event_id، photo_id، video_id، share_id، published، reaction_type، recipient_id اور open_graph_story_id، یہ سب درج ہیں۔

منشن کے لیے کون سی اجازت درکار ہے؟

pages_manage_metadata، جسے دینے کے لیے Meta کو MODERATE اختیارات والے پیج ایڈمن کی ضرورت ہے، اس سے پہلے کہ پیج ویب ہکس کسی ایپ تک پہنچیں۔ پیج کو POST /{page-id}/subscribed_apps کے ذریعے سبسکرائب کیا جاتا ہے، جس میں mention subscribed_fields میں ہو، اور اس کے لیے CREATE_CONTENT، MANAGE یا MODERATE ٹاسک رکھنے والے کسی شخص کا پیج ٹوکن استعمال ہوتا ہے، ساتھ pages_manage_metadata اور pages_show_list کے۔ ایپ بھی mention کو سبسکرائب کرتی ہے، کیونکہ فیلڈز صرف تب ڈیلیور ہوتے ہیں جب دونوں سطحوں پر سبسکرائب ہوں، اور وہ پیجز جو ایپ میں کسی کردار کے بغیر چلائے جاتے ہیں، انہیں Advanced Access میں یہ اجازتیں چاہئیں۔

منشن کرنے والی پوسٹ یا کمنٹ کو کیسے پڑھیں؟

اس کے ID سے، پیج کے ٹوکن کے ساتھ، جہاں Meta اجازت دے۔ پیج ٹوکن ان پوسٹس کو پڑھتا ہے جو پیج کو یا پیج کی طرف سے شائع ہوئی ہوں؛ دوسرے پیجز کی عوامی طور پر شیئر کی گئی پوسٹس کے لیے pages_manage_posts اور Page Public Content Access فیچر درکار ہیں، پیج ایڈمن کے ٹوکن پر؛ اور Meta کسی شخص کی اپنی پوسٹ پڑھنے کو اس شخص کی user_posts اجازت سے جوڑتا ہے۔

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

پیج اپنے منشنز کہاں اور دیکھ سکتا ہے؟

tagged ایج پر۔ GET /{page-id}/tagged ان عوامی پوسٹس کی فہرست دیتا ہے جن میں پیج کو ٹیگ کیا گیا ہو، ہر ایک کے ساتھ tagged_time، جو ویب ہک لگنے سے پہلے کی پوسٹس بھی شامل کرتا ہے۔ اس کے لیے CREATE_CONTENT، MANAGE یا MODERATE ٹاسک رکھنے والے کسی شخص کا پیج ٹوکن چاہیے، ساتھ pages_read_user_content اور pages_show_list کے، اور Meta کہتا ہے کہ Page Public Content Access فیچر درکار ہو سکتا ہے۔ کسی شخص کی پوسٹ پر، Meta صرف اسی شخص کو from فیلڈ واپس دیتا ہے جس نے اسے لکھا۔

easyCoexistence منشن ایونٹس کیسے ڈیلیور کرتا ہے؟

یہ ہر پیج کو، جب وہ کنیکٹ ہو، feed اور messages کے ساتھ mention پر سبسکرائب کرتا ہے۔ اس کی ایپ ہر ڈیلیوری پر X-Hub-Signature-256 چیک کرتی ہے، فوراً Meta کو جواب دیتی ہے، اور پیج کا ہر entry بغیر تبدیلی کے اس HTTPS اینڈ پوائنٹ پر POST کرتی ہے جو آپ set_social_webhook_destination یا Partner API پر PUT /channels/:id/webhook سے سیٹ کرتے ہیں:

  • X-EC-Signature میں t=<unix>,v1=<hex> ہوتا ہے: ٹائم اسٹیمپ کا HMAC-SHA256، ایک ڈاٹ، اور خام باڈی کا، جو پیج کے دستخطی راز سے سائن ہوتا ہے۔
  • یہ راز whsec_ سے شروع ہوتا ہے اور ایک بار دکھایا جاتا ہے؛ URL دوبارہ سیٹ کرنے سے نیا راز جاری ہوتا ہے، اور null URL فارورڈنگ روک دیتا ہے۔
  • ہر entry ایک بار بھیجی جاتی ہے، 8 سیکنڈ تک انتظار کرتے ہوئے، ایک HTTPS پتے کو جو عوامی IP پر حل ہوتا ہو، بغیر کسی redirect کے اور بغیر کوئی کاپی رکھے۔
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

عام غلطیاں

  • entry.time کو منشن کا لمحہ سمجھنا۔ Meta اسے نوٹیفکیشن بھیجنے کے وقت پر سیٹ کرتا ہے؛ ویلیو میں created_time پوسٹ یا کمنٹ کی تاریخ بتاتا ہے۔
  • کسی ناکام لک اپ کو خراب ایونٹ سمجھنا۔ Meta خبردار کرتا ہے کہ منشن نوٹیفکیشنز میں کچھ post_id اور comment_id قدریں کوئری نہیں ہو سکتیں، اجازت یا رازداری کی وجہ سے، اس لیے میسج کا متن ایونٹ سے ہی محفوظ کریں۔
  • جواب دینے سے پہلے پوسٹ لانا۔ فارورڈز کی دوبارہ کوشش نہیں ہوتی، اس لیے فوراً 2xx لوٹائیں اور پوسٹ بعد میں دیکھیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

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

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

کیا منشن ویب ہک بتاتا ہے کہ پیج کو کس نے منشن کیا؟

پیج کے لیے نہیں: Meta کا حوالہ from کو صرف Workplace کے لیے نشان زد کرتا ہے۔ ID سے پوسٹ یا کمنٹ دیکھنے سے، جہاں Meta کی اجازتیں اجازت دیں، اس کا مصنف واپس مل سکتا ہے۔

کیا پیج کے سبسکرائب ہونے سے پہلے کے منشنز مل سکتے ہیں؟

ویب ہک سے نہیں، کیونکہ Meta کوئی نوٹیفکیشن ہسٹری نہیں رکھتا جسے query کیا جا سکے۔ tagged ایج وہ عوامی پوسٹس دیتا ہے جن میں پیج کو ٹیگ کیا گیا ہو۔

منشن فیلڈ feed سے کیسے مختلف ہے؟

feed فیلڈ پیج کی اپنی فیڈ پر تبدیلیاں بتاتا ہے، جیسے وہاں کی پوسٹس، کمنٹس اور ری ایکشنز؛ mention بتاتا ہے کہ پیج کو کسی پوسٹ یا کمنٹ میں @ منشن کیا گیا۔ ہر فیلڈ الگ سے سبسکرائب ہوتا ہے۔

کیا easyCoexistence کے کمنٹ اصول منشنز پر لاگو ہوتے ہیں؟

نہیں۔ کمنٹ اصول اور آٹومیشن feed فیلڈ کے کمنٹس اور Messenger کے میسجز پر چلتے ہیں؛ mention کی تبدیلیاں اسی طرح آگے بھیجی جاتی ہیں جیسے Meta نے بھیجی تھیں۔

مزید پڑھیں

Facebook Page ویب ہک فیلڈز: مکمل فہرستMeta کی دستاویز کردہ 64 Facebook Page ویب ہک فیلڈز: feed، mention، messages جیسے Messenger فیلڈز، پروفائل فیلڈز، اور ہر ایک کی درکار اجازت۔Facebook Page feed ویب ہک: کمنٹس، پوسٹس اور ری ایکشنز کے ایونٹسFacebook Page فیڈ ویب ہک کیا بھیجتا ہے: کمنٹس، پوسٹس اور ری ایکشنز، آئٹم اور ورب فیلڈز، میٹا کا پے لوڈ ڈھانچہ، اور Page کیسے سبسکرائب کرتا ہے۔Facebook پیج کو ویب ہکس کے لیے سبسکرائب کرنا: subscribed_apps ایجPOST /{page-id}/subscribed_apps سے Facebook پیج کو ویب ہک فیلڈز کے لیے سبسکرائب کرنا: ٹوکن، ٹاسک، ایپ سطح کی سبسکرپشن، چیک اور ہٹانا۔Facebook ویب ہک کی تصدیق: hub.challenge اور X-Hub-Signature-256Facebook ویب ہک کی تصدیق: جب hub.verify_token مماثل ہو تو hub.challenge واپس کریں، پھر ہر ایونٹ پر ایپ سیکرٹ سے X-Hub-Signature-256 چیک کریں۔Facebook کمنٹ-to-DM آٹومیشن: پیج پوسٹ پر کمنٹ کرنے والوں کو Messenger میسج بھیجیںFacebook کمنٹ-to-DM سیٹ اپ کریں: کی ورڈ چنیں، میسج اور اختیاری عوامی جواب لکھیں، ایک پیج پوسٹ یا سب چنیں، اور اسے 24/7 چلنے دیں۔

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

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

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

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