Facebook پیج کو ویب ہکس کے لیے سبسکرائب کرنا: subscribed_apps ایج
Facebook پیج کو POST /{page-id}/subscribed_apps کے ذریعے کسی ایپ کے ویب ہکس کے لیے سبسکرائب کیا جاتا ہے، جس میں subscribed_fields کے طور پر feed اور messages جیسے فیلڈز دیے جاتے ہیں، اور پیج ایکسیس ٹوکن جو CREATE_CONTENT، MANAGE یا MODERATE ٹاسک رکھنے والے شخص کا ہو، جبکہ pages_manage_metadata اور pages_show_list کی اجازت ہو۔ Meta کسی فیلڈ کے ایونٹس تب ہی بھیجتا ہے جب ایپ بھی اسے سبسکرائب کرے؛ GET سبسکرپشن دکھاتا ہے اور DELETE اسے ہٹا دیتا ہے۔
easyCoexistence آپ کے کنیکٹ کیے ہر پیج کو subscribed_apps کے ذریعے feed، messages اور mention کے لیے سبسکرائب کرتا ہے، اسے ہٹانے پر ان سبسکرائب کرتا ہے، اور پیج کے ایونٹس ایک MCP کنیکٹر یا Partner API کے ذریعے، ہر پیج کے لیے مخصوص سیکرٹ سے دستخط شدہ، آپ کے HTTPS اینڈ پوائنٹ تک پہنچاتا ہے۔
صرف وہ فیلڈز جو پیج اور ایپ، دونوں کی سطح پر سبسکرائب ہوں، ویب ہکس بھیجتی ہیں؛ کوئی پیج ایپ سے زیادہ فیلڈز کی فہرست رکھ سکتا ہے۔
پیج کے ٹاسکس، جن میں سے ایک ٹوکن کے پیچھے موجود شخص کو سبسکرپشن پڑھنے یا بنانے کے لیے چاہیے۔
DELETE کے ذریعے پیج سے ویب ہک سبسکرپشن ہٹانے پر success کے ساتھ واپس آتا ہے۔
ایپ کی سطح کی سبسکرپشن پڑھنے، بنانے یا حذف کرنے کے لیے /{app-id}/subscriptions کو کیا درکار ہے۔
ناکام Messenger ڈیلیوریز کا دورانیہ، جس کے بعد Meta ایپ کو پیج سے ان سبسکرائب کر دیتا ہے۔
subscribed_apps ایج کیا کرتا ہے؟
یہ ایپ کو پیج پر انسٹال کرتا ہے اور طے کرتا ہے کہ پیج کے کون سے ویب ہک فیلڈز ایپ وصول کرے گی۔ Meta اطلاعات صرف اس وقت بھیجتا ہے جب پیج پر ایپ انسٹال ہو اور پیج کی سیٹنگز میں ایپ پلیٹ فارم بند نہ کیا گیا ہو، اور صرف ان فیلڈز کے لیے جو دونوں سطحوں پر سبسکرائب ہوں: پیج کی سطح پر، اس ایج کے ذریعے، اور ایپ کی سطح پر، جو ایپ ڈیش بورڈ میں یا /{app-id}/subscriptions کے ذریعے طے ہوتی ہے۔ ایک پیج ایپ سے زیادہ فیلڈز کے لیے سبسکرائب ہو سکتا ہے۔
پیج کو کیسے سبسکرائب کیا جاتا ہے؟
subscribed_fields میں کامہ سے الگ فیلڈز کی فہرست کے ساتھ ایج پر POST بھیج کر، اور پیج کا ایکسیس ٹوکن دے کر۔ کامیاب کال success true واپس کرتی ہے، اور جو کال messages کی فہرست دیتی ہے اسے ٹوکن پر pages_messaging کی اجازت بھی چاہیے:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }کن ٹوکن، ٹاسکس اور اجازتوں کی ضرورت ہے؟
پیج ایکسیس ٹوکن جو ایک ہی پیج سے منسلک ہو اور اس شخص کا ہو جو اس پیج پر کارروائی کر سکتا ہو۔ Meta کی دستاویزات اور گائیڈز یہ شرائط طے کرتی ہیں:
- کوئی بھی فیلڈ: ایسا شخص جس کے پاس
CREATE_CONTENT، MANAGE یا MODERATE ٹاسک ہو، اورpages_manage_metadataکے ساتھpages_show_listکی اجازت ہو۔ - messages اور دیگر Messenger فیلڈز:
pages_messagingبھی، ایسے ٹوکن پر جو MESSAGING ٹاسک انجام دے سکنے والے شخص کا ہو۔ - leadgen کے لیے ADVERTISE ٹاسک، اور
leads_retrieval،pages_read_engagementاورads_managementکی اجازت درکار ہے۔ - GET کے ذریعے سبسکرپشن پڑھنے کے لیے بھی وہی ٹاسک اور اجازتیں درکار ہیں جو اسے بنانے کے لیے ہیں۔
فیلڈز کو کس رسائی کی سطح کی ضرورت ہے؟
Advanced Access کی، ان پیجز اور لوگوں کے لیے جو ایپ کے اپنے رولز سے باہر ہوں۔ Standard Access کے ساتھ Messenger کی اطلاعات صرف اُن لوگوں سے آتی ہیں جن کا ایپ پر کوئی رول ہو، جیسے ایڈمنز، ڈویلپرز اور ٹیسٹرز؛ Advanced Access، جو App Review کے ذریعے ہر اجازت کے لیے دی جاتی ہے اور کاروباری تصدیق کی تقاضا کرتی ہے، انہیں ایپ کے صارفین تک کھول دیتی ہے۔ Meta کی Messenger گائیڈ میں ایپ کو پبلش کرنا بھی پیشگی شرائط میں شامل ہے۔
ایپ کی سطح کی سبسکرپشن کیا ہے؟
یہ وہ دوسرا حصہ ہے: وہ فیلڈز جنہیں ایپ خود سنتی ہے، اپنے callback URL کے ساتھ۔ یہ ایپ ڈیش بورڈ میں یا ایپ ایکسیس ٹوکن کے ساتھ POST /{app-id}/subscriptions کے ذریعے طے ہوتی ہے، جس میں object=page، callback_url، fields، include_values اور verify_token دیے جاتے ہیں، اور یہ Meta کی تصدیق کی درخواست شروع کرتی ہے۔ اسی ایج پر GET ہر object کا callback_url، fields اور یہ کہ سبسکرپشن فعال ہے یا نہیں، دکھاتا ہے؛ نیا POST دوسری فیلڈز کو متاثر کیے بغیر فیلڈز میں ترمیم کرتا ہے، اور DELETE سب یا نامزد فیلڈز کو ہٹا دیتا ہے۔
پیج کے سبسکرائب کیے گئے ایپس کیسے چیک کریں؟
اسی ایج پر پیج کے ٹوکن کے ساتھ GET کے ذریعے۔ data array میں وہ ہر ایپ درج ہوتی ہے جو پیج پر انسٹال ہے، اس کے نام، ID اور subscribed_fields کے ساتھ، اور جب پیج پر کوئی ایپ انسٹال نہ ہو تو یہ خالی واپس آتا ہے:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}سبسکرپشن کیسے ہٹائی جاتی ہے؟
DELETE /{page-id}/subscribed_apps کے ذریعے، جو ایپ کو پیج سے الگ کر دیتا ہے؛ کوئی ایپ ایپ ایکسیس ٹوکن کے ساتھ اپنی سبسکرپشن خود ہٹا سکتی ہے، اور جواب میں success اور messaging_success ہوتے ہیں۔ Meta بھی خود سے اسے ہٹا دیتا ہے: Messenger کی ڈیلیوریز ایک گھنٹے تک ناکام رہیں تو ایپ کو پیج سے ان سبسکرائب کر دیا جاتا ہے، اور جب اس کا اینڈ پوائنٹ کام کرنے لگے تو اسے دوبارہ سبسکرائب کرنا پڑتا ہے۔
easyCoexistence کنیکٹ کے وقت کیا کرتا ہے؟
یہ ہر اس پیج کو سبسکرائب کرتا ہے جو شخص منتخب کرتا ہے، اس پیج کا ٹوکن محفوظ کرنے کے فوراً بعد، subscribed_fields کو feed,messages,mention پر سیٹ کرتے ہوئے POST /{page-id}/subscribed_apps کال کرتا ہے۔ اگر Meta انکار کرے تو پیج کنیکٹ رہتا ہے اور list_social_accounts وجہ last_error میں دکھاتا ہے۔ پیج ہٹانے پر ٹوکن ختم کرنے سے پہلے DELETE /{page-id}/subscribed_apps بھیجا جاتا ہے، اور کوئی ٹول subscribed_apps یا token کے راستوں تک نہیں پہنچتا، اس لیے سبسکرپشن صرف easyCoexistence کے زیرِ انتظام رہتی ہے۔
عام غلطیاں
- پیج کے بجائے یوزر ایکسیس ٹوکن کے ساتھ ایج کو کال کرنا۔ اس کے لیے اس پیج کا پیج ایکسیس ٹوکن درکار ہے جسے سبسکرائب کیا جا رہا ہے۔
- پیج کو سبسکرائب کرنا مگر ایپ کو نہیں۔ کوئی فیلڈ کال بیک تک تبھی پہنچتی ہے جب ایپ کی اپنی سبسکرپشن میں بھی وہ شامل ہو۔
- messages کو سبسکرائب کرتے وقت pages_messaging کو چھوڑ دینا۔ Meta اسے لازم قرار دیتا ہے، اور وہ ٹوکن ایسے شخص کا ہونا چاہیے جو MESSAGING ٹاسک انجام دے سکتا ہو۔
- سروس میں خلل کے بعد دوبارہ سبسکرائب کرنا بھول جانا۔ ایک گھنٹے کی ناکام Messenger ڈیلیوریز ایپ کو ان سبسکرائب کر دیتی ہیں، اور POST دوبارہ بھیجے جانے تک ایونٹس بند رہتے ہیں۔
فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا مجھے ہر پیج کو الگ سے سبسکرائب کرنا ہوگا؟
ہاں۔ subscribed_apps ہر پیج کے لیے، اس پیج کے اپنے ٹوکن کے ساتھ کام کرتا ہے، جبکہ page object کے لیے ایپ کی سطح کی سبسکرپشن ان پیجز پر لاگو ہوتی ہے جنہوں نے ایپ انسٹال کی ہے۔
subscribed_apps خرابی 200 کیوں واپس کرتا ہے؟
Meta اس ایج کے لیے 200 کو اجازت کی خرابی کے طور پر درج کرتا ہے۔ جانچیں کہ ٹوکن میں pages_manage_metadata اور pages_show_list ہوں اور وہ CREATE_CONTENT، MANAGE یا MODERATE رکھنے والے شخص کا ہو۔
کیا Graph API Explorer سے کسی پیج کو سبسکرائب کیا جا سکتا ہے؟
ہاں۔ Meta کی گائیڈ ایپ منتخب کرتی ہے، pages_manage_metadata کے ساتھ یوزر ٹوکن لیتی ہے، اسے پیج کے ٹوکن سے تبدیل کرتی ہے اور {page-id}/subscribed_apps پر POST بھیجتی ہے۔
کیا easyCoexistence سے کنیکٹ شدہ پیج پر ویب ہک فیلڈز شامل کی جا سکتی ہیں؟
اس کے ٹولز کے ذریعے نہیں۔ کوئی بھی ٹول subscribed_apps کے راستوں تک نہیں پہنچتا، اور پیج feed، messages اور mention، یعنی وہ فیلڈز جو easyCoexistence آگے بھیجتا ہے، پر سبسکرائب رہتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ