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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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

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

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

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

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

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

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

• अगर आप लैटिन अमेरिका में हैं, तो उत्तरी अमेरिका का क्षेत्र चुनें.
• अगर आप अफ़्रीका में हैं, तो यूरोप क्षेत्र चुनें.
• अगर आप ऑस्ट्रेलिया में हैं, तो एशिया पैसिफ़िक क्षेत्र चुनें.

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

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

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

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

• बातचीत वाली: उन एजेंट के लिए जो उपयोगकर्ताओं के साथ कई बार बातचीत करते हैं.
• सामान्य मैसेज या एक मैसेज: यह उन एजेंट के लिए है जो बार-बार जवाब मिलने की उम्मीद किए बिना मैसेज भेजते हैं.

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

एजेंट को लॉन्च करने से पहले ही, उसकी बिलिंग कैटगरी बदली जा सकती है. अगर आपको लॉन्च के बाद बिलिंग कैटगरी बदलनी है, तो [e-mail] पर ईमेल करें.

आरबीएम बिलिंग मॉडल के बारे में ज़्यादा जानकारी के लिए, आरबीएम बिलिंग के बारे में अक्सर पूछे जाने वाले सवाल देखें.

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

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

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

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

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

एजेंट बनाना

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

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

एजेंट बनाने के लिए:

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

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

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

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

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 के सबसे सही तरीके देखें और जानें कि एजेंट मैसेज कैसे भेजते और पाते हैं.