जब तक एजेंट को लॉन्च नहीं किया जाता, तब तक वह सिर्फ़ बताए गए टेस्ट डिवाइसों से कम्यूनिकेट कर सकता है. इससे आपको अपने एजेंट को इंटरनल तौर पर टेस्ट करने का मौका मिलता है, ताकि असली उपयोगकर्ताओं को गलती से रिलीज़ होने से पहले ही ऐक्सेस न मिल जाए.
किसी RBM एजेंट से कम्यूनिकेट करने के लिए, टेस्ट डिवाइस पर आरसीएस की सुविधा चालू होनी चाहिए. ध्यान दें कि कुछ Android डिवाइसों पर, आरसीएस की सुविधा डिफ़ॉल्ट रूप से चालू नहीं होती. अपने डिवाइस पर आरसीएस की सुविधा का स्टेटस देखने के लिए, अपने डिवाइस पर आरसीएस की सुविधा का स्टेटस देखना लेख पढ़ें.
एजेंट, हर दिन ज़्यादा से ज़्यादा 20 टेस्टर को न्योता भेज सकते हैं. हालांकि, वे कुल 200 न्योते ही भेज सकते हैं.
अपने डिवाइस पर आरसीएस की सुविधा का स्टेटस देखना
- Messages ऐप्लिकेशन में, Messages की सेटिंग पर जाएं.
- आरसीएस चैट पर टैप करें. अगर आपको "आरसीएस चैट" की सुविधा नहीं दिखती है, तो चैट करने की सुविधाएं पर टैप करें.
- स्थिति वैल्यू ढूंढें.
अगर आपके डिवाइस पर आरसीएस की सुविधा काम नहीं करती है, तो Messages और Carrier Services ऐप्लिकेशन के प्री-रिलीज़ वर्शन का इस्तेमाल करके, अपने डिवाइस पर आरसीएस की सुविधा चालू करें.
अगर आपके डिवाइस पर आरसीएस की सुविधा चालू है, तो टेस्टर को न्योता भेजा जा सकता है. जब डिवाइस न्योता स्वीकार कर लेता है, तब वह आपके एजेंट से मैसेज पर बातचीत शुरू कर सकता है.
अपने डिवाइस पर आरसीएस की सुविधा चालू करना
Android डिवाइस पर आरसीएस की सुविधा चालू करने के लिए, Messages ऐप्लिकेशन में आरसीएस चैट की सुविधा चालू करें.
आपके डिवाइस पर आरसीएस की सुविधा चालू होने पर, टेस्टर को न्योता भेजा जा सकता है.
जांच करने वाले को न्योता भेजना
आरसीएस की सुविधा वाले किसी डिवाइस को टेस्टर बनने का न्योता भेजने के लिए, टेस्टर का न्योता भेजें. जब डिवाइस न्योता स्वीकार कर लेता है, तब आपका एजेंट उस डिवाइस को मैसेज, इवेंट, और अनुरोध भेज सकता है.
अगर डिवाइस पर आरसीएस की सुविधा चालू नहीं है, उसने टेस्टर के न्योते का जवाब नहीं दिया है या न्योता अस्वीकार कर दिया है, तो आपके एजेंट को डिवाइस से कम्यूनिकेट करने की कोशिश करते समय 403 PERMISSION_DENIED
गड़बड़ी का मैसेज मिलेगा.
कंसोल
Business Communications डेवलपर कंसोल की मदद से, टेस्टर को न्योता भेजने के लिए:
- Business Communications Developer Console खोलें. इसके बाद, RBM वाले Google खाते से साइन इन करें और अपने एजेंट पर क्लिक करें.
- बाईं ओर मौजूद मेन्यू में, डिवाइस चुनें.
- टेस्ट डिवाइसों की सूची में टेस्ट डिवाइस जोड़ने के लिए, डिवाइस का फ़ोन नंबर डालें. इसमें देश कोड और एरिया कोड भी शामिल करें. एक से ज़्यादा फ़ोन नंबर जोड़ने के लिए, उन्हें कॉमा से अलग करें.
किसी डिवाइस को सूची में जोड़ने पर, उसे न्योता भेजा जाता है. उपयोगकर्ता को अपने डिवाइस पर न्योता देने वाला मैसेज दिखता है. उसके पास इसे स्वीकार करने या अस्वीकार करने का विकल्प होता है.
टेस्ट डिवाइस की सूची में, हर उस डिवाइस के लिए टेस्टर को न्योता भेजने की स्थिति के बारे में जानकारी दी जाती है जिसे आपने अपने एजेंट को टेस्ट करने के लिए न्योता भेजा है.
एपीआई
RBM Management API की मदद से, टेस्टर को न्योता भेजने के लिए:
इस कोड का इस्तेमाल करें. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए,
testers
देखें.
cURL
curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \ -d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'
Node.js
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Send the tester invite to the device rbmApiHelper.sendTesterInvite('+12223334444', function(response) { console.log(response); });
Java
import com.google.rbm.RbmApiHelper; … try { // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Register the device as a tester rbmApiHelper.registerTester("+12223334444"); } catch(Exception e) { e.printStackTrace(); }
Python
# Reference to RBM Python client helper from rcs_business_messaging import rbm_service # Send the tester invite to a device rbm_service.invite_tester('+12223334444')
C#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); // Register the device as a tester rbmApiHelper.RegisterTester("+12223334444");
अगर 200 से ज़्यादा न्योते भेजे जाते हैं, तो RBM प्लैटफ़ॉर्म, जवाब में 429 RESOURCE_EXHAUSTED
गड़बड़ी कोड दिखाता है.
जांच करने वाले को न्योता फिर से भेजना
अगर ज़रूरी हो, तो टेस्टर को न्योता दोबारा भेजा जा सकता है. नतीजा, डिवाइस के मौजूदा न्योते की स्थिति पर निर्भर करता है.
डिवाइस की स्थिति | नतीजा |
PENDING
|
टेस्टर को न्योता भेजने का अनुरोध, डिवाइस पर भेज दिया जाता है. |
ACCEPTED
|
जांच करने वाले व्यक्ति को उस डिवाइस पर न्योता नहीं भेजा जाता है जिस पर ACCEPTED की स्थिति बनी रहती है.
|
DECLINED
|
टेस्टर को भेजा गया न्योता अस्वीकार कर दिया गया है. न्योता फिर से भेजने से पहले, आपको टेस्ट डिवाइस को हटाना होगा. ऐसा न करने पर, अनुरोध पूरा नहीं किया जा सकेगा. |
जब डिवाइस, टेस्टर का न्योता स्वीकार कर लेता है, तो वह आपके एजेंट के लिए, टेस्ट डिवाइस बन जाता है. डिवाइस पर मैसेज, इवेंट, और सुविधाओं की जांच करके, अपने एजेंट की सुविधाओं और वर्कफ़्लो को टेस्ट किया जा सकता है.
टेस्ट डिवाइस के लिए मिले न्योते की स्थिति पाना
किसी टेस्टर को न्योता भेजने पर, वह अपने डिवाइस पर न्योता स्वीकार या अस्वीकार कर सकता है. डिवाइस के न्योते की स्थिति के बारे में जानने के लिए, एपीआई से क्वेरी की जा सकती है.
कंसोल
Business Communications Developer Console की मदद से, किसी टेस्ट डिवाइस पर न्योता पाने की स्थिति देखने के लिए:
- Business Communications Developer Console खोलें. इसके बाद, RBM वाले Google खाते से साइन इन करें और अपने एजेंट पर क्लिक करें.
- बाईं ओर मौजूद मेन्यू में, डिवाइस चुनें.
- टेस्ट डिवाइसों की सूची में टेस्ट डिवाइस जोड़ने के लिए, डिवाइस का फ़ोन नंबर डालें. इसमें देश कोड और एरिया कोड भी शामिल करें. एक से ज़्यादा फ़ोन नंबर जोड़ने के लिए, उन्हें कॉमा से अलग करें.
जब किसी टेस्ट डिवाइस को सूची में जोड़ा जाता है, तब स्टेटस कॉलम में जाकर उसका स्टेटस देखा जा सकता है.
एपीआई
RBM Management API की मदद से, टेस्ट डिवाइस के लिए भेजे गए न्योते की स्थिति जानने के लिए:
इस कोड का इस्तेमाल करें. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए,
testers
देखें.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
सभी टेस्ट डिवाइसों की स्थिति पाना
आपने जिन डिवाइसों को टेस्टर के तौर पर शामिल होने का न्योता भेजा है उनके न्योते की स्थिति के बारे में क्वेरी की जा सकती है.
कंसोल
Business Communications Developer Console में, सभी टेस्ट डिवाइसों के लिए न्योते का स्टेटस देखने के लिए:
- Business Communications Developer Console खोलें. इसके बाद, RBM वाले Google खाते से साइन इन करें और अपने एजेंट पर क्लिक करें.
- बाईं ओर मौजूद मेन्यू में, डिवाइस चुनें.
- टेस्ट डिवाइसों की सूची में टेस्ट डिवाइस जोड़ने के लिए, डिवाइस का फ़ोन नंबर डालें. इसमें देश कोड और एरिया कोड भी शामिल करें. एक से ज़्यादा फ़ोन नंबर जोड़ने के लिए, उन्हें कॉमा से अलग करें.
जब किसी टेस्ट डिवाइस को सूची में जोड़ा जाता है, तब स्टेटस कॉलम में जाकर, उसका स्टेटस देखा जा सकता है.
एपीआई
RBM Management API की मदद से, सभी टेस्ट डिवाइसों के लिए न्योते का स्टेटस देखने के लिए:
इस कोड का इस्तेमाल करें. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए,
testers
देखें.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
टेस्ट डिवाइस हटाना
टेस्ट डिवाइस को हटाने पर, वह डिवाइस लॉन्च नहीं किए गए एजेंट से मैसेज नहीं पा सकेगा. आरबीएम प्लैटफ़ॉर्म, आपके एजेंट से भेजे गए उन मैसेज को नहीं मिटाता जो टेस्ट डिवाइस पर भेजे जा रहे हैं या उस पर सेव हैं.
कंसोल
Business Communications Developer Console से किसी टेस्ट डिवाइस को हटाने के लिए:
- Business Communications Developer Console खोलें. इसके बाद, RBM वाले Google खाते से साइन इन करें और अपने एजेंट पर क्लिक करें.
- बाईं ओर मौजूद मेन्यू में, डिवाइस चुनें.
- टेस्ट डिवाइसों की सूची में डिवाइस चुनें और मेन्यू पर क्लिक करें.
- डिवाइस हटाएं पर क्लिक करें.
एपीआई
RBM Management API की मदद से, टेस्ट डिवाइस हटाने के लिए:
इस कोड का इस्तेमाल करें. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए,
testers
देखें.
cURL
curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"