अपना पहला एजेंट बनाएं

एजेंट प्रोग्राम के हिसाब से अपने-आप बनने वाली इकाई, जो किसी ब्रैंड की ओर से उपयोगकर्ताओं को मैसेज भेजती है. एजेंट में, उपयोगकर्ताओं के इंटरैक्शन वाला कोई भी इंटरफ़ेस और इंटरैक्शन को बेहतर बनाने के लिए ज़रूरी कोड या इन्फ़्रास्ट्रक्चर शामिल होता है. एजेंट, सूचना भेजने जैसे एकतरफ़ा अनुभव दे सकते हैं. इसके अलावा, वे बातचीत वाले अनुभव दे सकते हैं और उपयोगकर्ताओं के जवाबों पर प्रतिक्रिया दे सकते हैं.

उपयोगकर्ता अपने डिवाइसों पर, आरसीएस की सुविधा वाले मैसेजिंग ऐप्लिकेशन, जैसे कि Google Messages के ज़रिए एजेंट से इंटरैक्ट करते हैं. इस शुरुआती लेख में, आपको एक बुनियादी RBM एजेंट बनाना होगा. यह एजेंट, टेस्ट डिवाइस पर एक आसान मैसेज भेज सकता है और जवाब पा सकता है.

ज़रूरी शर्तें

एजेंट का इस्तेमाल शुरू करने से पहले, आपको इन चीज़ों की ज़रूरत होगी:

• उस ब्रैंड का नाम जिसका प्रतिनिधित्व आपका एजेंट करेगा
• आपके एजेंट का
  • नाम
  • वह इलाका जहां एजेंट काम करेगा
  • बिलिंग की कैटगरी
  • इस्तेमाल का उदाहरण
• आपके पास एक ऐसा Android डिवाइस हो जिस पर चालू फ़ोन नंबर हो
• सैंपल कोड चलाने वाली डेवलपमेंट मशीन

टेस्ट डिवाइस सेट अप करना

लॉन्च नहीं किए गए आरबीएम एजेंट के साथ बातचीत करने के लिए, जांच वाले डिवाइस में आरसीएस की सुविधा चालू होनी चाहिए. हालांकि, सभी Android डिवाइसों पर डिफ़ॉल्ट रूप से आरसीएस मैसेज नहीं मिल सकते. अपने डिवाइस पर आरसीएस की सुविधाओं का स्टेटस देखा जा सकता है. साथ ही, ज़रूरत पड़ने पर, Messages और Carrier Services ऐप्लिकेशन के रिलीज़ होने से पहले के वर्शन का इस्तेमाल करके, अपने डिवाइस को कॉन्फ़िगर करके आरसीएस की सुविधाएं चालू की जा सकती हैं.

अपने डिवाइस पर आरसीएस की सुविधाओं के काम करने की स्थिति देखना

1. Messages ऐप्लिकेशन में, button पर टैप करें. इसके बाद, Settings पर टैप करें.

2. Chat की सुविधाएं पर टैप करें और स्थिति वैल्यू देखें.

   अगर स्टेटस कनेक्ट है के तौर पर दिखता है, तो इसका मतलब है कि आपके डिवाइस पर आरसीएस की सुविधा चालू है.

अगले चरण

अगर आपके डिवाइस पर आरसीएस चालू है, तो अपना एजेंट सेट अप किया जा सकता है. अगर आपके डिवाइस पर आरसीएस की सुविधा चालू नहीं है, तो आरबीएम एजेंट की जांच करने से पहले, आपको अपने डिवाइस पर आरसीएस की सुविधा चालू करनी होगी.

अपना एजेंट सेट अप करना

आरबीएम एजेंट, उपयोगकर्ताओं को मैसेज, इवेंट, और अन्य अनुरोध भेजने के लिए, RBM API का इस्तेमाल करते हैं. एजेंट बनाते समय, आपके पास RBM API का ऐक्सेस चालू करने और अपने एजेंट की बुनियादी जानकारी देने का विकल्प होता है.

एजेंट के इलाके की पहचान करना

आरबीएम एपीआई, तीन रीजनल एंडपॉइंट के साथ काम करता है. इससे कारोबारों को क्षेत्रीय और कारोबार से जुड़ी ज़रूरी शर्तों का पालन करने में मदद मिलती है. RBM एजेंट, इनमें से किसी एक क्षेत्र में मौजूद हो सकते हैं:

• उत्तरी अमेरिका
• यूरोप
• एशिया पैसिफ़िक

एजेंट बनाते समय, वहां के नियम-कानूनों, ज़रूरी शर्तों, और असली उपयोगकर्ताओं से उस इलाके की दूरी के आधार पर उसका इलाका चुनें. ध्यान दें कि क्षेत्र, देश के हिसाब से नहीं होता. इससे उस इलाके की पहचान होती है जहां आपका एजेंट काम करता है. Google इस जानकारी का इस्तेमाल यह तय करने के लिए करता है कि मैसेज का डेटा कहां सेव किया जाए और मैसेज ट्रैफ़िक को सही तरीके से कैसे रूट किया जाए.

ध्यान दें: एजेंट बनाने के बाद, उसके इलाके की जानकारी नहीं बदली जा सकती.

एजेंट की बिलिंग कैटगरी तय करना

मोबाइल और इंटरनेट की सेवा देने वाली जो कंपनियां अपने नेटवर्क पर आरबीएम कॉन्टेंट को मंज़ूरी देती हैं वे इस बिलिंग फ़्रेमवर्क का इस्तेमाल करके, अपने सदस्यों को आरबीएम मैसेज डिलीवर करने के लिए भी शुल्क लेती हैं:

• बातचीत - किसी तय समयावधि में, एक से ज़्यादा A2P और P2A मैसेज वाली बातचीत के लिए शुल्क.
• एक मैसेज - रिच आरबीएम कॉन्टेंट (जैसे, रिच कार्ड या कैरसेल वाला मैसेज) वाले एक मैसेज के लिए शुल्क.
• सामान्य मैसेज - 160 वर्णों तक के सादे टेक्स्ट मैसेज के लिए शुल्क.

एजेंट बनाते समय, बिलिंग की वह कैटगरी चुनें जो आपके एजेंट लॉजिक के व्यवहार से सबसे ज़्यादा मेल खाती हो:

• बातचीत वाला - यह एजेंट, उपयोगकर्ता के साथ जटिल इंटरैक्शन करता है. इसमें, दोनों तरफ़ से मैसेज भेजे और पाए जाते हैं.

नीचे दी गई दो कैटगरी, बातचीत वाले बिलिंग इवेंट कभी नहीं बनाती हैं. डिलीवर किए गए कॉन्टेंट के आधार पर, कैरियर हर मैसेज के लिए बुनियादी मैसेज या सिंगल मैसेज की कीमत लेते हैं.

• सिंगल मैसेज - यह एजेंट आम तौर पर रिच मैसेज भेजता है और शायद ही कभी जवाब पाने की उम्मीद करता है.
• सामान्य मैसेज - यह एजेंट, एसएमएस को आरबीएम में अपग्रेड करता है और आम तौर पर, मैसेज का जवाब मिलने की उम्मीद नहीं करता. आम तौर पर, एजेंट से 160 वर्णों तक के सादे टेक्स्ट मैसेज भेजने की उम्मीद की जाती है. हालांकि, एजेंट पर कोई पाबंदी नहीं है. अगर उसे प्रोग्राम किया जाता है, तो वह बेहतर कॉन्टेंट भेज सकता है. इसके लिए, उससे तय की गई कीमत ली जाएगी.

एजेंट लॉन्च करने से पहले, उसकी बिलिंग कैटगरी बदली जा सकती है. बिलिंग की किसी दूसरी कैटगरी पर स्विच करने के बारे में बातचीत करने के लिए, हमसे संपर्क करें.

एजेंट के इस्तेमाल के उदाहरण की पहचान करना

हर आरबीएम एजेंट के लिए, पहले से तय किया गया इस्तेमाल का उदाहरण होना ज़रूरी है. इससे यह पता चलता है कि एजेंट, असली उपयोगकर्ताओं के साथ किस तरह की बातचीत करेगा. साथ ही, इससे कारोबारों को कारोबार के नियमों का पालन करने में मदद मिलती है. RBM को चार तरह के कामों के लिए इस्तेमाल किया जा सकता है:

• OTP: खाते की पुष्टि करने या लेन-देन की पुष्टि करने के लिए, एक बार इस्तेमाल होने वाले पासवर्ड ज़रूरी होते हैं
• लेन-देन से जुड़ी जानकारी: ग्राहक की मौजूदा सेवाओं या प्रॉडक्ट से जुड़ी जानकारी शेयर करने के लिए सूचनाएं, अपडेट या सूचनाएं. जैसे, खाते में संदिग्ध गतिविधियों के लिए सूचनाएं, खरीदारी की पुष्टि, और शिपिंग की सूचनाएं.
• प्रमोशनल: नए या मौजूदा ग्राहकों को बिक्री, मार्केटिंग, और प्रमोशनल मैसेज भेजना. इनका मकसद, जागरूकता, यूज़र ऐक्टिविटी, और बिक्री बढ़ाना है.
• कई कामों के लिए इस्तेमाल: बातचीत वाले ऐसे फ़्लो जिनमें लेन-देन और प्रमोशन के उदाहरणों को एक साथ शामिल किया जाता है. जैसे, खाते से जुड़ी सूचना भेजना और फिर नए प्रॉडक्ट और सेवा के लिए छूट या अपग्रेड की सुविधा देना.

हर इस्तेमाल के उदाहरण को कब इस्तेमाल करना है, इस बारे में ज़्यादा जानकारी के लिए इस्तेमाल का सही उदाहरण चुनें लेख पढ़ें.

एजेंट को लॉन्च के लिए सबमिट करने के बाद, इस्तेमाल के उदाहरण में बदलाव नहीं किया जा सकता. अपना एजेंट सबमिट करने से पहले, अपने देश के लिए इस्तेमाल के उदाहरण और कारोबार के नियम देखना न भूलें.

एजेंट बनाना

Business Communications Developer Console में अपना एजेंट बनाने के लिए, इन निर्देशों का पालन करें.

ध्यान दें: RBM Management API का इस्तेमाल करके एजेंट बनाने के लिए, एजेंट मैनेज करना दस्तावेज़ देखें.

1. Business Communications डेवलपर कंसोल खोलें और अपने आरबीएम पार्टनर के Google खाते से साइन इन करें.
2. एजेंट बनाएं पर क्लिक करें.
3. एजेंट टाइप के लिए, आरसीएस बिज़नेस मैसेजिंग चुनें.
4. ब्रैंड के लिए, वह ब्रैंड चुनें जिसका प्रतिनिधित्व आपका एजेंट करेगा या नया ब्रैंड जोड़ें पर क्लिक करके उसका नाम डालें.
5. अपने एजेंट का नाम डालें. साथ ही, अपने एजेंट का इलाका, बिलिंग कैटगरी, और इस्तेमाल का उदाहरण चुनें. इसके बाद, एजेंट बनाएं पर क्लिक करें.
6. जब आपका एजेंट उपलब्ध हो, तो उसके नाम पर क्लिक करें.

एजेंट उपलब्ध होने के बाद, कारोबार और ब्रैंडिंग की जानकारी जोड़ी जा सकती है. एजेंट देखें.

अपने टेस्ट डिवाइस पर न्योता भेजना

अब आपके पास एक एजेंट है और आपका टेस्ट डिवाइस आरसीएस की सुविधा के साथ काम करता है. इसलिए, अपने डिवाइस को एजेंट की जांच करने का न्योता दिया जा सकता है.

1. बाईं ओर मौजूद नेविगेशन में, डिवाइस पर क्लिक करें.
2. टेस्ट डिवाइस जोड़ें के लिए, अपने डिवाइस का फ़ोन नंबर डालें और जोड़ें पर क्लिक करें.
3. अपने टेस्ट डिवाइस पर, अपने एजेंट के लिए टेस्टर का अनुरोध स्वीकार करें.

अगर आपको टेस्टिंग के लिए इस्तेमाल किए जा रहे डिवाइस पर न्योता नहीं मिलता है, तो पुष्टि करें कि आपके डिवाइस पर आरसीएस की सुविधा चालू है.

मैसेज भेजें

रजिस्टर किए गए टेस्ट डिवाइस की मदद से, आपका एजेंट अब मैसेज भेज सकता है.

एपीआई कॉल की पुष्टि सुरक्षित तरीके से करने के लिए, आपको सेवा खाते की कुंजी की ज़रूरत होगी. अगर आपने अब तक अपने पार्टनर खाते के लिए सेवा खाते की कुंजी नहीं बनाई है, तो अब इसे बनाने का समय आ गया है.

अपनी डेवलपमेंट मशीन पर टर्मिनल में, यह कमांड चलाएं:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

• अपने एजेंट के इलाके के हिसाब से, REGION को asia, europe या us से बदलें.
• PHONE_NUMBER को टेस्ट डिवाइस के फ़ोन नंबर से बदलें. देश का कोड, इलाके का कोड, और सबसे पहले + शामिल करें. हालांकि, सेपरेटर शामिल न करें. उदाहरण के लिए, [phone].
• AGENT ID की जगह अपना एजेंट आईडी डालें. यह आईडी, Business Communications डेवलपर कंसोल में एजेंट की जानकारी पेज पर मौजूद होता है.
• PATH_TO_SERVICE_ACCOUNT_KEY को उस की के पाथ से बदलें जिसे आपने पहले बनाया था.

आपको टेस्ट डिवाइस पर, अपने एजेंट से "नमस्ते, दुनिया!" मैसेज मिलेगा. अगर आपको टेस्ट डिवाइस पर कोई मैसेज नहीं मिलता है, तो पुष्टि करें कि आपने कमांड में फ़ोन नंबर और सेवा खाते की कुंजी के पाथ को सही तरीके से डाला है और फ़ॉर्मैट किया है.

सुझाए गए जवाब और रिच कार्ड जैसे अलग-अलग तरह के मैसेज भेजने के लिए, मैसेज भेजें लेख पढ़ें.

अगले चरण

अब आपका एजेंट, टेस्ट डिवाइस पर मैसेज भेज सकता है. इसलिए, अब आपके कारोबार की ज़रूरतों के हिसाब से कुछ बनाना होगा. अपनी पसंदीदा भाषा में सैंपल एजेंट पाएं और सैंपल के README में दिए गए निर्देशों का पालन करें.

सैंपल एजेंट कॉन्फ़िगर करने के बाद, RBM के सबसे सही तरीके देखें और जानें कि एजेंट मैसेज कैसे भेजते और पाते हैं.