फ़ेसबुक मेंशन वेबहुक: जब कोई आपके पेज को मेंशन करे
फ़ेसबुक के पेज वेबहुक का mention फ़ील्ड तब ऐप को सूचित करता है जब कोई पोस्ट या कमेंट में पेज को @मेंशन करता है। Meta field को mention पर सेट करके एक change भेजता है, जिसकी value में post_id, कमेंट के लिए comment_id, message में टेक्स्ट, जुड़े लिंक और मीडिया, तथा item और verb हो सकते हैं। यह POST X-Hub-Signature-256 से हस्ताक्षरित होता है।
easyCoexistence आपके जोड़े हर पेज को feed और messages के साथ mention फ़ील्ड पर सब्सक्राइब करता है, और उसके मेंशन इवेंट आते ही आपके HTTPS एंडपॉइंट पर आगे भेजता है, हर पेज के लिए अलग सीक्रेट से हस्ताक्षरित और बिना कोई कॉपी रखे, ताकि आपका एजेंट हर मेंशन के होते ही उसके बारे में जान ले।
नए मेंशन के लिए पेज वेबहुक फ़ील्ड, जिसमें कमेंट और पोस्ट में मेंशन शामिल हैं।
अनुमति जो पेज एडमिन जिसके पास MODERATE विशेषाधिकार हैं, पेज वेबहुक ऐप के कॉलबैक यूआरएल तक पहुँचने से पहले देना ज़रूरी है।
लोग पोस्ट या कमेंट में पेज को कैसे मेंशन करते हैं: @ टाइप करें और पेज का नाम, फिर उसे चुनें।
Meta कितनी देर तक विफल पेज सूचना को घटती आवृत्ति के साथ दोबारा भेजता है, इसके बाद उसे छोड़ देता है।
वह फ़ील्ड जो /{page-id}/tagged एज हर सार्वजनिक पोस्ट में जोड़ता है जिसमें पेज को टैग किया गया है।
मेंशन वेबहुक किस चीज़ से शुरू होता है?
किसी के पोस्ट या कमेंट में पेज को मेंशन करने से। Facebook पर मेंशन @ टाइप करके और पेज का नाम चुनकर किया जाता है, और Meta का संदर्भ इस फ़ील्ड को पेज के नए मेंशन, जिनमें कमेंट और पोस्ट में मेंशन शामिल हैं, के रूप में बताता है। Facebook का Help Center बताता है कि पेज की सेटिंग लोगों को उसे मेंशन करने से रोक सकती हैं।
मेंशन सूचना कैसी दिखती है?
एक POST जिसका object page है और मेंशन किए गए पेज की एक entry: उसका ID, समय, और changes array जिसका field mention है। Meta के संदर्भ में value के फ़ील्ड सूचीबद्ध हैं पर कोई नमूना नहीं दिया गया, इसलिए पोस्ट में यह मेंशन उसी सूची से इस तरह बनाया गया है:
{
"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 के संदर्भ में value के फ़ील्ड हैं; कौन सा फ़ील्ड सूचना में आता है यह पोस्ट या कमेंट पर निर्भर है:
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, जिसे पेज वेबहुक ऐप तक पहुँचने से पहले MODERATE विशेषाधिकार वाले पेज एडमिन को देना होता है। पेज को POST /{page-id}/subscribed_apps के ज़रिए सब्सक्राइब किया जाता है, जिसके subscribed_fields में mention हो, और इसके लिए 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 अनुमति से जोड़ता है।
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 करता है जो आपने Partner एपीआई पर set_social_webhook_destination या PUT /channels/:id/webhook से सेट किया:
- X-EC-Signature में t=<unix>,v1=<hex> होता है: टाइमस्टैम्प, एक बिंदु (.) और raw body का HMAC-SHA256, जो पेज के साइनिंग सीक्रेट से बनता है।
- सीक्रेट whsec_ से शुरू होता है और एक बार दिखाया जाता है; यूआरएल दोबारा सेट करने पर नया सीक्रेट जारी होता है, और null यूआरएल फ़ॉरवर्डिंग रोक देता है।
- हर entry एक बार भेजी जाती है, 8 सेकंड तक इंतज़ार करते हुए, ऐसे HTTPS पते पर जो एक सार्वजनिक IP पर हल होता है, बिना किसी रीडायरेक्ट के और बिना कोई कॉपी रखे।
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 इसे सूचना भेजे जाने के समय पर सेट करता है; value में created_time पोस्ट या कमेंट की तारीख बताता है।
- किसी लुकअप की विफलता को टूटा हुआ इवेंट समझना। Meta चेतावनी देता है कि मेंशन सूचनाओं में कुछ post_id और comment_id मान अनुमति की कमी या गोपनीयता के कारण क्वेरी नहीं किए जा सकते, इसलिए मैसेज का टेक्स्ट इवेंट से ही रखें।
- फ़ॉरवर्ड का जवाब देने से पहले पोस्ट लाना। फ़ॉरवर्ड दोबारा नहीं भेजे जाते, इसलिए तुरंत 2xx लौटाएँ और पोस्ट बाद में खोजें।
US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने के साथ घटती हुई कीमत, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या मेंशन वेबहुक बताता है कि पेज को किसने मेंशन किया?
पेज के मामले में नहीं: Meta का संदर्भ from को केवल Workplace के लिए चिह्नित करता है। ID से पोस्ट या कमेंट खोजने पर, जहाँ Meta की अनुमतियाँ अनुमति दें, उसका लेखक मिल सकता है।
क्या पेज सब्सक्राइब होने से पहले के मेंशन मिल सकते हैं?
वेबहुक से नहीं, क्योंकि Meta के पास क्वेरी करने के लिए सूचना इतिहास नहीं रहता। tagged एज उन सार्वजनिक पोस्ट की सूची देता है जिनमें पेज को टैग किया गया है।
मेंशन फ़ील्ड feed से कैसे अलग है?
feed पेज की अपनी फ़ीड पर बदलाव बताता है, जैसे वहाँ की पोस्ट, कमेंट और रिएक्शन; mention बताता है कि पेज को किसी पोस्ट या कमेंट में @मेंशन किया गया। हर फ़ील्ड अलग से सब्सक्राइब होता है।
क्या easyCoexistence के कमेंट नियम मेंशन पर लागू होते हैं?
नहीं। नियम और ऑटोमेशन feed फ़ील्ड के कमेंट और Messenger मैसेज पर काम करते हैं; mention में होने वाले बदलाव ठीक वैसे ही आपके एंडपॉइंट पर आगे भेजे जाते हैं जैसे Meta ने भेजे।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित