Facebook उल्लेख वेबहुक: कसैले तपाईंको Page लाई उल्लेख गर्दा
Facebook को Page वेबहुकको mention फिल्डले कसैले पोस्ट वा कमेन्टमा Page लाई @उल्लेख गर्दा एपलाई सूचित गर्छ। Meta ले फिल्ड mention मा सेट गरिएको change पठाउँछ, जसको value मा post_id, कमेन्टको लागि comment_id, message मा टेक्स्ट, संलग्न link र media, तथा item र verb हुन सक्छन्। यो POST X-Hub-Signature-256 ले हस्ताक्षर गरिएको हुन्छ।
easyCoexistence ले तपाईंले जडान गरेको प्रत्येक Page लाई feed र messages सँगै mention फिल्डमा सब्स्क्राइब गर्छ, र उल्लेख घटनाहरू आउँदा तपाईंको HTTPS endpoint मा पठाउँछ।
Page का नयाँ उल्लेखका लागि Page वेबहुक फिल्ड, कमेन्ट र पोस्टमा भएका उल्लेख समेत।
Page प्रशासकले MODERATE अधिकारसहित दिनुपर्ने अनुमति, जसबिना Page वेबहुक एपको कलब्याक यूआरएलसम्म पुग्दैनन्।
Facebook मा कसैले Page लाई पोस्ट वा कमेन्टमा उल्लेख गर्ने तरिका: @ टाइप गरेर Page को नाम, अनि त्यसलाई छान्ने।
Meta ले असफल भएको Page सूचना घट्दो आवृत्तिमा कति पटकसम्म पुनः प्रयास गर्छ, र त्यसपछि हटाउँछ।
/{page-id}/tagged edge ले Page ट्याग गरिएका प्रत्येक सार्वजनिक पोस्टमा थप्ने फिल्ड।
कुन कुराले उल्लेख वेबहुक सुरु गराउँछ?
कसैले पोस्ट वा कमेन्टमा Page लाई उल्लेख गर्दा। Facebook मा उल्लेख गर्न @ टाइप गरेर Page को नाम टाइप गर्नुहुन्छ र सुझावबाट छान्नुहुन्छ। Meta को सन्दर्भ पुस्तिकाले यो फिल्डलाई Page का नयाँ उल्लेख, कमेन्ट र पोस्टमा भएका उल्लेखसहित भनेर वर्णन गर्छ। Facebook को सहायता केन्द्रले भन्छ, Page का सेटिङले मानिसहरूलाई त्यसलाई उल्लेख गर्नबाट रोक्न सक्छन्।
उल्लेख सूचना कस्तो देखिन्छ?
object को मान page भएको POST, जसमा उल्लेख गरिएको Page को लागि एउटा entry हुन्छ: त्यसको ID, समय, र changes array जसको field mention हुन्छ। Meta को सन्दर्भ पुस्तिकाले मानका फिल्डहरू सूचीबद्ध गर्छ तर नमुना दिँदैन, त्यसैले पोस्टमा भएको यो उल्लेख त्यही सूचीबाट यसरी बनाइएको हो:
{
"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: वस्तुको प्रकार र त्यसमा के भयो, फिड फिल्डले प्रयोग गर्ने सूचीबाटै।
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, जुन Page वेबहुक एपसम्म पुग्नुअघि MODERATE अधिकार भएको Page प्रशासकले दिनुपर्छ। Page लाई POST /{page-id}/subscribed_apps मार्फत सब्स्क्राइब गरिन्छ, जसको subscribed_fields मा mention छ, CREATE_CONTENT, MANAGE वा MODERATE कार्य भएको कसैको Page टोकन प्रयोग गरेर, pages_manage_metadata र pages_show_list सहित। एपले पनि mention मा सब्स्क्राइब गर्छ, किनकि दुवै स्तरमा सब्स्क्राइब भएका फिल्ड मात्र पठाइन्छ; एपमा भूमिका नभएका मानिसहरूले चलाएका Page लाई Advanced Access मा ती अनुमति चाहिन्छ।
उल्लेख गर्ने पोस्ट वा कमेन्ट कसरी पढ्ने?
त्यसको ID द्वारा, Page को टोकनसँग, जहाँ Meta अनुमति दिन्छ। Page टोकनले Page मा वा Page द्वारा प्रकाशित पोस्ट पढ्छ; अन्य Page का सार्वजनिक रूपमा साझा भएका पोस्टका लागि pages_manage_posts र Page Public Content Access सुविधा चाहिन्छ, Page प्रशासकको टोकनमा; र मानिसको आफ्नै पोस्ट पढ्नु त्यस व्यक्तिको 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>Page ले आफ्ना उल्लेख अरू कहाँ पाउन सक्छ?
tagged edge मा। GET /{page-id}/tagged ले Page ट्याग गरिएका सार्वजनिक पोस्टहरू सूचीबद्ध गर्छ, प्रत्येकसँग tagged_time सहित, जसमा वेबहुक सेटअप हुनुअघिका पोस्ट पनि पर्छन्। यसका लागि CREATE_CONTENT, MANAGE वा MODERATE कार्य भएको कसैको Page टोकन चाहिन्छ, pages_read_user_content र pages_show_list सहित, र Meta भन्छ Page Public Content Access सुविधा आवश्यक हुन सक्छ। कसैको व्यक्तिगत पोस्टमा, Meta ले from मा लेखकलाई मात्र फर्काउँछ।
easyCoexistence ले उल्लेख घटनाहरू कसरी पठाउँछ?
Page जडान हुँदा त्यसलाई feed र messages सँगै mention मा सब्स्क्राइब गर्छ। एपले प्रत्येक डेलिभरीमा X-Hub-Signature-256 जाँच्छ, Meta लाई तुरुन्तै प्रतिक्रिया दिन्छ, र Page का प्रत्येक entry लाई जस्ताको तस्तै, set_social_webhook_destination वा Partner API मा PUT /channels/:id/webhook मार्फत तपाईंले सेट गर्नुभएको HTTPS endpoint मा POST गर्छ:
- X-EC-Signature मा t=<unix>,v1=<hex> हुन्छ: timestamp, एउटा बिन्दु र raw body को HMAC-SHA256, जुन Page को हस्ताक्षर गोप्य कुञ्जीले सुरक्षित छ।
- गोप्य कुञ्जी whsec_ बाट सुरु हुन्छ र एकपटक मात्र देखाइन्छ; URL फेरि सेट गर्दा नयाँ जारी हुन्छ, र null यूआरएलले फर्वार्डिङ रोक्छ।
- प्रत्येक entry एकपटक मात्र पठाइन्छ, 8 सेकेन्डसम्म पर्खेर, सार्वजनिक IP मा समाधान हुने HTTPS ठेगानामा; कुनै redirect पछ्याइँदैन र कुनै प्रति राखिँदैन।
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 प्रतिक्रिया फर्काउनुहोस् र पछि पोस्ट खोज्नुहोस्।
त्यो Page का लागि छुट्टै गोप्य कुञ्जीले हस्ताक्षरित हुन्छ, र कुनै प्रति राखिँदैन, ताकि तपाईंको एजेन्टले प्रत्येक उल्लेख हुनासाथ थाहा पाओस्। प्रति जडान प्रति महिना US$ 9 देखि US$ 0.75 सम्म, थप जडान गर्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
उल्लेख वेबहुकले उल्लेख गर्ने व्यक्ति बताउँछ?
Page को लागि होइन: Meta को सन्दर्भले from लाई केवल Workplace मा चिन्हित गर्छ। पोस्ट वा कमेन्टको ID ले खोज्दा Meta को अनुमतिले अनुमति दिएमा त्यसको लेखक फर्कन सक्छ।
Page सब्स्क्राइब हुनुअघिका उल्लेख पाउन सकिन्छ?
वेबहुकबाट होइन, किनभने Meta ले क्वेरी गर्न सकिने सूचना इतिहास राख्दैन। tagged edge ले Page ट्याग गरिएका सार्वजनिक पोस्टहरू सूचीबद्ध गर्छ।
उल्लेख फिल्ड feed भन्दा कसरी फरक छ?
feed फिल्डले Page को आफ्नै फिडमा परिवर्तन रिपोर्ट गर्छ, जस्तै त्यहाँका पोस्ट, कमेन्ट र प्रतिक्रिया; mention ले Page लाई पोस्ट वा कमेन्टमा @उल्लेख गरिएको रिपोर्ट गर्छ। प्रत्येक फिल्ड आफैँमा सब्स्क्राइब हुन्छ।
easyCoexistence का कमेन्ट नियमहरूले उल्लेखमा काम गर्छन्?
छैनन्। नियम र स्वचालनले feed फिल्डका कमेन्ट र Messenger म्यासेजमा काम गर्छन्; mention परिवर्तनहरू Meta ले पठाएजस्तै तपाईंको endpoint मा फर्वार्ड हुन्छन्।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको