Messenger प्रोफाइल API: अभिवादन, Get Started बटन, आइस ब्रेकर र स्थायी मेनु
Facebook Page को Messenger प्रोफाइल /{page-id}/messenger_profile मार्फत, Page एक्सेस टोकन र pages_messaging सहित सेट गरिन्छ: POST ले get_started, greeting, ice_breakers, persistent_menu र commands जस्ता गुणहरू लेख्छ, GET ले fields सहित तिनलाई पढ्छ, र DELETE ले fields array मा नाम दिइएकाहरू हटाउँछ। Meta ले प्रत्येक Page का लागि प्रत्येक 10 मिनेटमा 10 कलसम्म अनुमति दिन्छ, र पठाइएका गुणहरू मात्र अधिलेखन हुन्छन्।
easyCoexistence ले Page का Messenger कुराकानीहरूमा 24 घण्टाको विन्डोभित्र send_social_dm ले जवाफ दिन्छ, Claude, ChatGPT वा तपाईंको आफ्नै कोडबाट, नयाँ म्यासेजहरू आउँदा तपाईंको endpoint मा पठाइन्छन्।
प्रत्येक 10 मिनेटको अन्तरालमा प्रति Page Messenger Profile API कलको अनुमति।
API ले सेट गर्न सक्ने आइस ब्रेकरको अधिकतम संख्या; दुवै सेट हुँदा API का आइस ब्रेकरले Get Started बटनलाई प्राथमिकता पाउँछन्।
स्थायी मेनुको शीर्ष-स्तरका वस्तुहरूको अधिकतम संख्या; प्रत्येक वस्तुको शीर्षक 30 वर्णमा सीमित छ।
Page-स्तरको स्थायी मेनु अद्यावधिक हुन लाग्ने समय; एक व्यक्तिको लागि सेट गरिएको मेनु वास्तविक समयमा अद्यावधिक हुन्छ।
अभिवादन पाठ, जुन Meta को अभिवादन सन्दर्भ अनुसार Messenger for Android र iOS मा अब काम गर्दैन।
Messenger प्रोफाइलमा के समावेश हुन्छ?
Facebook Page को Messenger अनुभव सुरु हुने सेटिङहरू। Meta को Messenger Profile API ले यी गुणहरू सूचीबद्ध गर्छ, जसलाई एउटै एन्डपोइन्टमा सेट र पढिन्छ; Development Mode मा रहेको एपका लागि यी सेटिङ एपमा भूमिका भएका व्यक्तिहरूलाई मात्र देखिन्छन्:
गुणहरू कसरी पढिन्छन्, सेट गरिन्छन् र मेटिन्छन्?
एउटै एन्डपोइन्टमा तीन विधिले, Page को टोकनसहित कल गरेर। POST ले JSON body मा गुणहरू लिन्छ र नाम दिइएकाहरूलाई मात्र अधिलेखन गर्छ, GET ले fields लाई अल्पविरामले छुट्याइएको सूचीको रूपमा लिन्छ, र DELETE ले JSON body लिन्छ जसको fields array ले हटाउनुपर्ने कुरा नाम दिन्छ; 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 बटन कसरी काम गर्छ?
यो स्वागत स्क्रिनमा बस्छ, जसमा Page को नाम, प्रोफाइल तस्बिर, कभर फोटो र व्यवसायले सामान्यतया जवाफ दिन लिने समय देखिन्छ। ट्याप गर्दा Get Started कुराकानीमा पोस्ट हुन्छ, get_started.payload messaging_postbacks event का रूपमा एपमा पठाइन्छ, र मानक म्यासेजिङ विन्डो खुल्छ। Meta ले नोट गर्छ कि Messenger, Facebook एपको इन-एप ब्राउजरभित्र चल्दा यो बटन समर्थित हुँदैन, र स्थायी मेनु चलाउन पहिले यो बटन सेट गर्नुपर्छ।
अभिवादन पाठ अझै काम गर्छ?
फोनहरूमा यो काम गर्दैन। Meta को सन्दर्भको शीर्षक अब [Deprecated] Greeting Text हो: यो सुविधा Messenger for Android र iOS मा काम गर्दैन, र API ले greeting गुण स्वीकार गर्न सक्ने भए पनि ग्राहकहरूले यो देख्दैनन्, त्यसैले Meta ले डेभलपरहरूलाई यसबाट बच्न आग्रह गर्छ। दस्तावेजमा उल्लेख भएअनुसार greeting मा प्रत्येक लोकेलको लागि एउटा पाठ हुन्छ, default अनिवार्य हुन्छ, 160 वर्णसम्म हुन सक्छ, {{user_first_name}}, {{user_last_name}} वा {{user_full_name}} ले व्यक्तिगत बनाउन सकिन्छ, र यसलाई सेट गर्न Page मा Administrator भूमिका चाहिन्छ।
आइस ब्रेकर कसरी काम गर्छन्?
यिनले व्यक्तिले ट्याप गर्न सक्ने 4 सम्म प्रश्नहरू देखाउँछन्, जसबाट कुराकानी सुरु गर्न सकिन्छ; प्रश्न थ्रेडमा व्यक्तिले सोधेजस्तै पोस्ट हुन्छ, र यसको पेलोड postback event को रूपमा फर्कन्छ। अप्रिल 2022 देखि यिनीहरू स्थानीयकृत छन्: ice_breakers को प्रत्येक object मा call_to_actions र locale हुन्छ, default locale अनिवार्य छ, र ice_breakers को DELETE ले सबै हटाउँछ। Meta ले नयाँ कुराकानीका लागि प्रतिस्पर्धा गर्ने तत्वहरूलाई यसरी क्रम दिन्छ:
- दुवै सेट हुँदा API का आइस ब्रेकरले Get Started बटनभन्दा प्राथमिकता पाउँछन्।
- दुवै Page इनबक्समा सेट गरिएका कस्टम प्रश्नभन्दा अगाडि आउँछन्, र API आइस ब्रेकर सेट भएको बेला ती प्रश्नहरूको सम्पादन असक्षम हुन्छ।
स्थायी मेनु कसरी बनाइन्छ?
menus को array हो, प्रत्येक लोकेलका लागि एउटा, default अनिवार्य हुन्छ, र प्रत्येकमा type web_url वा postback भएका 20 call_to_actions सम्म हुन्छन्। शीर्षक 30 वर्णसम्म र postback पेलोड 1,000 सम्म हुन सक्छ, र composer_input_disabled लाई true सेट गर्दा मेनु, बटन र webview मात्र अन्तरक्रियाको माध्यम रहन्छ। देखिनुअघि Meta का आवश्यकताहरू:
- Get Started बटन पहिल्यै सेट भएको, र
pages_messagingअनुमति। - प्रकाशित Page, र एप सार्वजनिक सेट गरिएको।
- सेट गर्ने व्यक्तिका लागि Page मा Administrator भूमिका।
- Facebook एपको इन-एप ब्राउजरबाहिर, iOS वा Android मा Messenger v106 वा त्यसभन्दा नयाँ।
- Page-स्तरका परिवर्तनहरू 24 घण्टासम्म लाग्न सक्छन्; एक व्यक्तिको मेनु,
custom_user_settingsमार्फत PSID सहित सेट गरिएको, वास्तविक समयमा अद्यावधिक हुन्छ।
कमाण्ड भनेको के हो?
व्यक्तिले जुनसुकै बेला प्रयोग गर्न सक्ने कुञ्जी शब्दहरू, कम्पोजरको छेउको कमाण्ड मेनुबाट, स्ल्यास वा at चिन्ह टाइप गरेर, वा मेल खाने शब्द टाइप गर्दा देखिने पपओभरबाट। प्रत्येक लोकेलमा 1 देखि 100 सम्म कमाण्ड हुन्छन्, नाम 1 देखि 32 वर्णसम्म र अगाडि स्ल्यास नभएको, र विवरण 1 देखि 64 वर्णसम्म; कमाण्ड सेट हुँदा तिनीहरू स्थायी मेनुभन्दा प्राथमिकतामा हुन्छन्। प्रयोग भएका कमाण्डहरू messages event भित्र message.commands मा एपसम्म पुग्छन्।
whitelisted_domains र account_linking_url ले के गर्छन्?
दुवैले कुराकानी बाहिरको अनुभव चलाउँछन्। whitelisted_domains ले Messenger webview ले Messenger Extensions SDK र checkbox plugin का लागि खोल्न सक्ने 50 डोमेनसम्म सूचीबद्ध गर्छ, प्रत्येक HTTPS मार्फत पूर्ण रूपमा योग्य नामसहित सेवा दिएको, कहिल्यै IP ठेगाना वा localhost नहुने, र यसलाई सेट गर्न Page मा Administrator भूमिका चाहिन्छ। account_linking_url भनेको HTTPS कलब्याक हो, जसले व्यक्तिको Messenger खातालाई व्यवसायसँगको खातासँग जोड्छ।
easyCoexistence ले Page को Messenger प्रोफाइल कसरी सेट गर्छ?
यसले गर्दैन: कुनै उपकरणले {page-id}/messenger_profile कल गर्दैन, र Page टोकनहरू दिइँदैनन्, त्यसैले प्रोफाइल सेट गर्नु यो जडानबाहिर पर्छ। व्यक्तिहरूले चलाउने कमाण्डहरू easyCoexistence ले अगाडि पठाउने र अटोमेसनले पढ्ने messages event मा आउँछन्; Meta ले messaging_postbacks event का रूपमा रिपोर्ट गर्ने ट्यापहरू, जुन Get Started, postback मेनु वस्तु र आइस ब्रेकरबाट आउँछन्, अगाडि पठाइँदैनन्, किनभने Page हरू feed, messages र mention मा सदस्यता लिएका छन्।
सामान्य गल्तीहरू
- Get Started भन्दा पहिले स्थायी मेनु सेट गर्नु। Meta का आवश्यकताहरूमा Get Started बटन पर्छ, त्यसैले पहिले get_started सेट गर्नुहोस्।
- default लोकेल छोड्नु। आइस ब्रेकर, मेनु र कमाण्ड प्रत्येकलाई फलब्याकका रूपमा locale default सेट भएको object चाहिन्छ।
- लुपमा प्रोफाइल API कल गर्नु। Meta ले प्रत्येक Page का लागि प्रत्येक 10 मिनेटमा 10 कल मात्र दिन्छ, त्यसैले धेरै गुणहरू एउटै POST मा राख्नुहोस्।
- मेनु परिवर्तन तुरुन्तै देखिने आशा गर्नु। Page-स्तरको मेनु अद्यावधिक मानिसहरूसम्म पुग्न 24 घण्टासम्म लाग्न सक्छ।
Messenger प्रोफाइल सेट गर्नु यसका उपकरणहरूमा पर्दैन। US$ 9 देखि US$ 0.75 सम्म प्रति कनेक्सन प्रति महिना, कनेक्सन थप्दै जाँदा घट्दै जान्छ, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
स्थायी मेनु प्रति व्यक्ति फरक हुन सक्छ?
हो। व्यक्तिको PSID सहितको custom_user_settings ले त्यो व्यक्तिका लागि Page को मेनुलाई ओभरराइड गर्छ, वास्तविक समयमा अद्यावधिक हुन्छ, र प्रत्येक व्यक्तिका लागि 10 मिनेटमा 10 कल अनुमति दिन्छ।
Messenger प्रोफाइलले कुन लोकेल समर्थन गर्छ?
Meta को समर्थित लोकेल सूचीमा भएकाहरू, जस्तै en_GB, pt_BR वा ja_JP, साथै default, जुन व्यक्तिको लोकेलसँग कुनै मेल नखाँदा प्रयोग हुने फलब्याक हो।
Page को Messenger प्रोफाइल कसले परिवर्तन गर्न सक्छ?
pages_messaging बोकेको Page टोकन भएको एप। स्थायी मेनु, अभिवादन र डोमेन सूची सेट गर्न Page मा Administrator भूमिका पनि चाहिन्छ।
Facebook Page का लागि easyCoexistence को मूल्य कति हो?
प्रत्येक Page एउटा कनेक्सन हो: US$ 9 देखि US$ 0.75 सम्म प्रति कनेक्सन प्रति महिना, कनेक्सनको संख्या बढ्दै जाँदा मूल्य घट्दै जान्छ, र पहिलो 3 दिन निःशुल्क छन्।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको