Facebook पेज को वेबहुक से सब्सक्राइब करना: subscribed_apps एज
POST /{page-id}/subscribed_apps से Facebook पेज को किसी ऐप के वेबहुक से सब्सक्राइब किया जाता है। इसमें subscribed_fields के रूप में feed,messages जैसे फ़ील्ड भेजे जाते हैं, और पेज का एक्सेस टोकन उस व्यक्ति का होना चाहिए जिसके पास CREATE_CONTENT, MANAGE या MODERATE टास्क हो, साथ में pages_manage_metadata और pages_show_list की परमिशन दी गई हो। Meta किसी फ़ील्ड की इवेंट तभी भेजता है जब ऐप भी उसे सब्सक्राइब करे; GET सब्सक्रिप्शन दिखाता है और DELETE उसे हटाता है।
easyCoexistence हर उस पेज को, जिसे आप कनेक्ट करते हैं, subscribed_apps से feed, messages और mention पर सब्सक्राइब करता है, हटाने पर अनसब्सक्राइब करता है, और हर पेज के इवेंट उसके अपने सीक्रेट से साइन करके आपके HTTPS एंडपॉइंट तक भेजता है, एक MCP कनेक्टर या Partner एपीआई से।
केवल वे फ़ील्ड वेबहुक भेजते हैं जो पेज और ऐप, दोनों स्तरों पर सब्सक्राइब हों; पेज ऐप से ज़्यादा फ़ील्ड सूचीबद्ध कर सकता है।
पेज के टास्क, जिनमें से एक टोकन वाले व्यक्ति के पास सब्सक्रिप्शन पढ़ने या बनाने के लिए होना चाहिए।
DELETE से जब कोई ऐप पेज से अपनी वेबहुक सब्सक्रिप्शन हटाता है, तब success के साथ यह लौटता है।
/{app-id}/subscriptions को ऐप-स्तर सब्सक्रिप्शन पढ़ने, बनाने या हटाने के लिए क्या चाहिए।
मैसेंजर डिलीवरी विफल होने के बाद Meta ऐप को पेज से अनसब्सक्राइब कर देता है, और ऐप को फिर से सब्सक्राइब करना होता है।
subscribed_apps एज क्या करता है?
यह पेज पर ऐप इंस्टॉल करता है और तय करता है कि ऐप पेज के कौन से वेबहुक फ़ील्ड प्राप्त करेगा। Meta सूचनाएँ तभी भेजता है जब पेज पर ऐप इंस्टॉल हो और पेज की सेटिंग में ऐप प्लेटफ़ॉर्म बंद न किया गया हो, और केवल उन फ़ील्ड के लिए जो दोनों स्तरों पर सब्सक्राइब हों: पेज के, इस एज के ज़रिए, और ऐप के, जो ऐप डैशबोर्ड में या /{app-id}/subscriptions से सेट होते हैं। पेज को ऐप से ज़्यादा फ़ील्ड सब्सक्राइब किए जा सकते हैं।
पेज को सब्सक्राइब कैसे करें?
एज पर POST के साथ, subscribed_fields में कॉमा से अलग किए गए फ़ील्ड, और पेज का एक्सेस टोकन भेजें। सफल कॉल 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 और बाकी मैसेंजर फ़ील्ड:
pages_messagingभी, ऐसे व्यक्ति के टोकन पर जो MESSAGING टास्क कर सके। - leadgen: ADVERTISE टास्क, साथ में
leads_retrieval,pages_read_engagementऔरads_management। - GET से सब्सक्रिप्शन पढ़ने के लिए भी वही टास्क और परमिशन चाहिए जो उसे बनाने के लिए।
फ़ील्ड को किस एक्सेस स्तर की ज़रूरत है?
Advanced Access की, पेज और ऐप की अपनी भूमिकाओं से बाहर के लोगों के लिए। Standard Access के साथ मैसेंजर सूचनाएँ केवल उन्हीं लोगों से आती हैं जिनकी ऐप पर कोई भूमिका हो, जैसे उसके एडमिन, डेवलपर और टेस्टर; Advanced Access, जो App Review के ज़रिए हर परमिशन के लिए मिलता है और बिज़नेस पुष्टि माँगता है, ऐप के ग्राहकों के लिए इन्हें खोलता है। Meta की मैसेंजर गाइड में ऐप को प्रकाशित करना भी पूर्व-शर्तों में शामिल है।
ऐप-स्तर सब्सक्रिप्शन क्या है?
दूसरा हिस्सा: वे फ़ील्ड जिन्हें ऐप खुद सुनता है, अपने कॉलबैक यूआरएल के साथ। इसे ऐप डैशबोर्ड में या 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 खुद भी इसे हटा देता है: मैसेंजर डिलीवरी एक घंटे तक विफल रहने के बाद ऐप को पेज से अनसब्सक्राइब कर दिया जाता है, और उसके एंडपॉइंट के फिर से काम करने पर ऐप को दोबारा सब्सक्राइब करना होता है।
कनेक्ट होने पर easyCoexistence क्या करता है?
उस हर पेज को सब्सक्राइब करता है जिसे व्यक्ति चुनता है, उस पेज का टोकन सेव करने के ठीक बाद: POST /{page-id}/subscribed_apps, जिसमें subscribed_fields feed,messages,mention होते हैं। अगर Meta मना करे, तो पेज कनेक्टेड रहता है और list_social_accounts last_error में कारण दिखाता है। पेज हटाने पर टोकन हटाने से पहले DELETE /{page-id}/subscribed_apps भेजा जाता है, और कोई टूल subscribed_apps या टोकन पथों तक नहीं पहुंचता, इसलिए सब्सक्रिप्शन सिर्फ easyCoexistence संभालता है।
आम गड़बड़ियाँ
- उपयोगकर्ता एक्सेस टोकन से एज को कॉल करना। यह उस पेज का पेज एक्सेस टोकन लेता है जिसे सब्सक्राइब किया जा रहा है।
- पेज को सब्सक्राइब करना, ऐप को नहीं। फ़ील्ड कॉलबैक तक तभी पहुँचता है जब ऐप की अपनी सब्सक्रिप्शन में भी वह शामिल हो।
- messages को सब्सक्राइब करते समय pages_messaging छोड़ देना। Meta इसे माँगता है, ऐसे टोकन पर जो MESSAGING टास्क कर सके।
- आउटेज के बाद दोबारा सब्सक्राइब करना भूल जाना। एक घंटे की विफल मैसेंजर डिलीवरी ऐप को अनसब्सक्राइब कर देती है, और POST फिर से भेजे जाने तक इवेंट रुक जाते हैं।
प्रति कनेक्शन प्रति माह US$ 9 से घटकर US$ 0.75 तक, जैसे-जैसे आप कनेक्शन जोड़ते हैं; पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
हर पेज को अलग से सब्सक्राइब करना होगा?
हाँ। subscribed_apps हर पेज के अपने टोकन से काम करता है, जबकि page ऑब्जेक्ट के लिए ऐप-स्तर सब्सक्रिप्शन उन पेज पर लागू होता है जिन्होंने ऐप इंस्टॉल किया है।
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 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित