Messenger प्रोफ़ाइल एपीआई: अभिवादन, Get Started बटन, आइस ब्रेकर और पर्सिस्टेंट मेनू
Facebook पेज की Messenger प्रोफ़ाइल /{page-id}/messenger_profile के ज़रिए, पेज एक्सेस टोकन और pages_messaging के साथ सेट होती है: POST से get_started, greeting, ice_breakers, persistent_menu और commands जैसी प्रॉपर्टी लिखी जाती हैं, GET से fields के साथ उन्हें पढ़ा जाता है, और DELETE से fields एरे में नामित प्रॉपर्टी हटाई जाती हैं। Meta हर पेज के लिए हर 10 मिनट में 10 कॉल की अनुमति देता है, और केवल भेजी गई प्रॉपर्टी ही ओवरराइट होती है।
easyCoexistence Claude, ChatGPT या आपके अपने कोड से किसी Page की Messenger बातचीतों का जवाब 24 घंटे की विंडो के भीतर send_social_dm से देता है, जबकि नए मैसेज आते ही आपके एंडपॉइंट पर भेजे जाते हैं।
हर 10 मिनट के अंतराल में प्रति पेज Messenger Profile एपीआई कॉल की अनुमति।
एपीआई द्वारा सेट किए जा सकने वाले आइस ब्रेकर की अधिकतम संख्या; दोनों सेट हों तो एपीआई आइस ब्रेकर को Get Started बटन पर प्राथमिकता मिलती है।
पर्सिस्टेंट मेनू में टॉप-लेवल आइटम की अधिकतम संख्या; हर आइटम का शीर्षक 30 अक्षरों तक सीमित।
पेज-स्तरीय पर्सिस्टेंट मेनू अपडेट में लगने वाला समय; किसी एक व्यक्ति के लिए सेट मेनू रीयल टाइम में अपडेट होता है।
अभिवादन टेक्स्ट, जो Meta के greeting संदर्भ के अनुसार Android और iOS पर Messenger में अब काम नहीं करता।
Messenger प्रोफ़ाइल में क्या होता है?
वे सेटिंग जिनसे पेज के Messenger अनुभव की शुरुआत होती है। Meta की Messenger Profile एपीआई इन प्रॉपर्टी को सूचीबद्ध करती है, और हर एक को उसी एंडपॉइंट पर सेट और पढ़ा जाता है; Development Mode में मौजूद ऐप के लिए ये सेटिंग केवल उन लोगों को दिखती हैं जिनके पास ऐप पर कोई भूमिका है:
प्रॉपर्टी कैसे पढ़ी, सेट और हटाई जाती हैं?
पेज के टोकन से, एक ही एंडपॉइंट पर तीन मेथड के ज़रिए। POST में प्रॉपर्टी की JSON बॉडी जाती है और केवल नामित प्रॉपर्टी ओवरराइट होती हैं, GET में fields कॉमा से अलग सूची के रूप में जाते हैं, और DELETE में JSON बॉडी होती है जिसके fields एरे में वे नाम होते हैं जिन्हें हटाना है; POST और DELETE का जवाब result success होता है। एक ही कॉल में Get Started बटन और मेनू सेट करना:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Get Started बटन कैसे काम करता है?
यह स्वागत स्क्रीन पर दिखता है, जहाँ पेज का नाम, प्रोफ़ाइल फ़ोटो, कवर फ़ोटो और व्यवसाय आमतौर पर जवाब देने में कितना समय लेता है, यह दिखाया जाता है। टैप करने पर बातचीत में Get Started भेजा जाता है, get_started.payload ऐप को messaging_postbacks इवेंट के रूप में भेजा जाता है, और मानक मैसेजिंग विंडो खुलती है। Meta ध्यान दिलाता है कि जब Messenger, Facebook ऐप के इन-ऐप ब्राउज़र में चलता है तो यह बटन समर्थित नहीं है, और पर्सिस्टेंट मेनू के लिए पहले इसका सेट होना ज़रूरी है।
क्या अभिवादन टेक्स्ट अब भी काम करता है?
फ़ोन पर नहीं। Meta के संदर्भ का शीर्षक अब [Deprecated] Greeting Text है: यह सुविधा Android और iOS पर Messenger में अब काम नहीं करती, और एपीआई greeting प्रॉपर्टी स्वीकार कर सकता है फिर भी ग्राहक उसे नहीं देखेंगे, इसलिए Meta डेवलपर्स से इसे न इस्तेमाल करने को कहता है। दस्तावेज़ के अनुसार greeting में हर लोकेल के लिए एक टेक्स्ट होता है, default अनिवार्य है, अधिकतम 160 अक्षर का, और {{user_first_name}}, {{user_last_name}} या {{user_full_name}} से निजीकृत किया जा सकता है; इसे सेट करने के लिए पेज पर Administrator भूमिका चाहिए।
आइस ब्रेकर कैसे काम करते हैं?
ये अधिकतम 4 सवालों की सूची हैं, जिन्हें व्यक्ति टैप करके बातचीत शुरू कर सकता है; सवाल थ्रेड में ऐसे पोस्ट होता है जैसे व्यक्ति ने खुद पूछा हो, और उसका पेलोड postback इवेंट के रूप में वापस आता है। अप्रैल 2022 से ये लोकलाइज़्ड हैं: ice_breakers का हर ऑब्जेक्ट call_to_actions और locale रखता है, default लोकेल अनिवार्य है, और ice_breakers का DELETE उन सबको हटा देता है। Meta उन तत्वों को रैंक करता है जो नई बातचीत के लिए आपस में प्रतिस्पर्धा करते हैं:
- एपीआई आइस ब्रेकर को Get Started बटन पर प्राथमिकता मिलती है, जब दोनों सेट हों।
- दोनों, पेज इनबॉक्स में सेट किए गए कस्टम सवालों से पहले आते हैं, जिनका संपादन API आइस ब्रेकर सेट होने पर बंद रहता है।
पर्सिस्टेंट मेनू कैसे बनता है?
मेनू का एरे है, हर लोकेल के लिए एक, जिसमें default अनिवार्य है, और हर मेनू में web_url या postback प्रकार के अधिकतम 20 call_to_actions होते हैं। शीर्षक अधिकतम 30 अक्षर, postback पेलोड अधिकतम 1,000, और composer_input_disabled को true सेट करने पर मेनू, बटन और webview ही बातचीत का एकमात्र तरीका रह जाते हैं। दिखने से पहले Meta की आवश्यकताएँ:
- पहले से सेट Get Started बटन, और
pages_messagingअनुमति। - एक प्रकाशित पेज, और ऐप का public पर सेट होना।
- जो इसे सेट करता है, उसके पास पेज पर Administrator भूमिका।
- iOS या Android पर Messenger v106 या बाद का वर्शन, Facebook ऐप के इन-ऐप ब्राउज़र के बाहर।
- पेज-स्तरीय बदलाव में 24 घंटे तक लग सकते हैं; किसी एक व्यक्ति के लिए मेनू, PSID के साथ
custom_user_settingsके ज़रिए सेट होने पर, रीयल टाइम में अपडेट होता है।
कमांड क्या होते हैं?
ऐसे कीवर्ड जिन्हें व्यक्ति कभी भी लॉन्च कर सकता है: कंपोज़र के पास के कमांड मेनू से, स्लैश या @ टाइप करके, या मिलता-जुलता शब्द टाइप करने पर पॉपओवर से। हर लोकेल में 1 से 100 कमांड होते हैं, नाम 1 से 32 अक्षर का, शुरू में slash के बिना, और विवरण 1 से 64 अक्षर का; कमांड सेट होने पर वे पर्सिस्टेंट मेनू से पहले प्राथमिकता पाते हैं। लॉन्च किए गए कमांड message.commands में messages इवेंट के भीतर ऐप तक पहुँचते हैं।
whitelisted_domains और account_linking_url क्या करते हैं?
दोनों बातचीत के बाहर के अनुभवों के लिए हैं। whitelisted_domains अधिकतम 50 डोमेन की सूची है जिन्हें Messenger webview Messenger Extensions SDK और checkbox plugin के लिए खोल सकता है; हर डोमेन HTTPS पर fully qualified name के तहत सेवा दे, कभी IP पता या localhost नहीं, और इसे सेट करने के लिए पेज पर Administrator भूमिका चाहिए। account_linking_url वह HTTPS कॉलबैक है जो व्यक्ति के Messenger खाते को कारोबार के खाते से जोड़ता है।
easyCoexistence पेज की Messenger प्रोफ़ाइल कैसे सेट करता है?
ऐसा नहीं करता: कोई टूल {page-id}/messenger_profile को कॉल नहीं करता, और Page टोकन सौंपे नहीं जाते, इसलिए प्रोफ़ाइल सेट करना इस कनेक्शन के दायरे से बाहर है। व्यक्तियों द्वारा लॉन्च किए गए कमांड उस messages इवेंट में आते हैं जिसे easyCoexistence आगे भेजता है और ऑटोमेशन पढ़ते हैं; Get Started, पोस्टबैक मेनू आइटम और आइस ब्रेकर से आने वाले टैप, जिन्हें Meta messaging_postbacks इवेंट के रूप में बताता है, आगे नहीं भेजे जाते, क्योंकि पेज feed, messages और mention की सदस्यता लेते हैं।
आम गड़बड़ियाँ
- पर्सिस्टेंट मेनू Get Started से पहले सेट करना। Meta की आवश्यकताओं में Get Started बटन शामिल है, इसलिए पहले get_started सेट करें।
- default लोकेल छोड़ना। आइस ब्रेकर, मेनू और कमांड में से हर एक को फ़ॉलबैक के रूप में locale: default वाला ऑब्जेक्ट चाहिए।
- प्रोफ़ाइल एपीआई को लूप में कॉल करना। Meta हर पेज के लिए हर 10 मिनट में 10 कॉल देता है, इसलिए कई प्रॉपर्टी एक POST में भेजें।
- मेनू बदलाव के तुरंत दिखने की उम्मीद। पेज-स्तरीय मेनू अपडेट लोगों तक पहुँचने में 24 घंटे तक ले सकता है।
Messenger प्रोफ़ाइल सेट करना इसके टूल में शामिल नहीं है। US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन बढ़ने पर दर घटती है, पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
पर्सिस्टेंट मेनू हर व्यक्ति के लिए अलग हो सकता है?
हाँ। व्यक्ति के PSID के साथ custom_user_settings उस व्यक्ति के लिए पेज के मेनू को ओवरराइड करता है, रीयल टाइम में अपडेट होता है, और प्रति व्यक्ति 10 मिनट में 10 कॉल की अनुमति देता है।
Messenger प्रोफ़ाइल कौन-से लोकेल सपोर्ट करती है?
वे जो Meta की समर्थित लोकेल सूची में हैं, जैसे en_GB, pt_BR या ja_JP, साथ में default, जो तब फ़ॉलबैक के रूप में चलता है जब व्यक्ति की लोकेल से कोई मेल न हो।
पेज की Messenger प्रोफ़ाइल कौन बदल सकता है?
pages_messaging वाला पेज टोकन रखने वाला ऐप। पर्सिस्टेंट मेनू, अभिवादन और डोमेन सूची के लिए पेज पर Administrator भूमिका भी चाहिए।
Facebook पेज के लिए easyCoexistence की कीमत कितनी है?
हर पेज एक कनेक्शन है: US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन की संख्या बढ़ने पर दर घटती है, और पहले 3 दिन निःशुल्क हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित