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

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

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

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

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

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

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

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

अपने डिवाइस पर आरसीएस की सुविधा का स्टेटस देखना

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

2. चैट करने की सुविधाएं पर टैप करें. इसके बाद, स्थिति की वैल्यू ढूंढें.

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

अगले चरण

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

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

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

एजेंट के क्षेत्र की पहचान करना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

एजेंट बनाना

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

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

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

1. Business Communications डेवलपर कंसोल पर जाएं और RCS for Business के पार्टनर के तौर पर इस्तेमाल किए जाने वाले 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!"
  },
  "messageTrafficType": "PROMOTION"
}'

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

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

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

अगले चरण

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

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