आरबीएम पार्टनर के तौर पर रजिस्टर हो जाने के बाद, आपको पार्टनर खाता मिल जाएगा. अपने पार्टनर खाते की सेटिंग ऐक्सेस करने के लिए, Business Communications डेवलपर कंसोल खोलें और पार्टनर खाता सेटिंग पर क्लिक करें. यहां से, ये काम किए जा सकते हैं:
- अपने पार्टनर खाते की जानकारी अपडेट करना
- अपने खाते से जोड़े गए ब्रैंड को जोड़ना, उनमें बदलाव करना, और उन्हें हटाना
- खाते के उपयोगकर्ताओं को मैनेज करना
- एपीआई कॉल की पुष्टि करने के लिए, सेवा खाता और कुंजी बनाना
पार्टनर के खाते की जानकारी अपडेट करें
सेटिंग पेज पर जाकर, अपना पार्टनर आईडी देखा जा सकता है और यहां दी गई जानकारी को अपडेट किया जा सकता है:
| फ़ील्ड | ब्यौरा |
|---|---|
| पार्टनर का नाम | आपके पार्टनर खाते का नाम |
| डिसप्ले नेम | मोबाइल और इंटरनेट सेवा देने वाली कंपनी को मिलने वाली
आरबीएम बिलिंग रिपोर्ट में, उसका नाम दिखेगा (owner_name फ़ील्ड के तौर पर). मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, इसका इस्तेमाल आपकी पहचान एक भरोसेमंद पार्टनर के तौर पर करने के लिए करेंगी. साथ ही,
यह पक्का करने के लिए भी कि वे अपने सदस्यों तक पहुंचने के लिए, आरबीएम का इस्तेमाल करने के लिए इनवॉइस की सही जानकारी जनरेट करेंगी. आपका दिया गया नाम, मोबाइल और इंटरनेट सेवा देने वाली कंपनी के आपके समझौतों में इस्तेमाल किए गए नाम से मेल खाना चाहिए. |
| तकनीकी समस्या होने पर संपर्क | आपके एजेंट से जुड़ी कोई तकनीकी समस्या होने पर, Google इस व्यक्ति से संपर्क करेगा. आप चाहें, तो
|
| वेबहुक | यह आपके वेबहुक एंडपॉइंट का यूआरएल है. इसे अपडेट करने के लिए, **कॉन्फ़िगर करें** पर क्लिक करें. पार्टनर वेबहुक को कॉन्फ़िगर करने पर, वह आपके सभी एजेंट पर लागू हो जाता है. अगर आपको किसी एजेंट के लिए अलग वेबहुक का इस्तेमाल करना है, तो एजेंट के लिए वेबहुक को कॉन्फ़िगर करें. यह वेबहुक सिर्फ़ उस एजेंट पर लागू होगा. |
ब्रैंड मैनेज करें
आरबीएम पार्टनर के तौर पर, आपके पास ब्रैंड की ओर से एजेंट बनाने का विकल्प होता है.
पार्टनर खाते से जुड़े ब्रैंड जोड़ने, उनमें बदलाव करने, और उन्हें हटाने के लिए, खाता सेटिंग में ब्रैंड पेज पर जाएं.
कोई ब्रैंड जोड़ें
ब्रैंड जोड़ने के लिए, इनपुट फ़ील्ड में उसका नाम डालें और जोड़ें पर क्लिक करें.
ब्रैंड एट्रिब्यूट की वैल्यू में बदलाव करना
किसी ब्रैंड में बदलाव करने के लिए:
- ब्रैंड के नाम के बगल में मौजूद चेकबॉक्स पर क्लिक करें.
- बटन पर क्लिक करें. इसके बाद, नाम में बदलाव करें पर क्लिक करें.
- बदलाव करें और हो गया पर क्लिक करें.
किसी ब्रैंड को हटाना
ब्रैंड को हटाया नहीं जा सकता, अगर वह किसी एजेंट से जुड़ा हुआ है, भले ही वह एजेंट लॉन्च न हुआ हो.
किसी ब्रैंड को हटाने के लिए, ब्रैंड के नाम के बगल में मौजूद चेकबॉक्स पर क्लिक करें और मिटाएं पर क्लिक करें.
उपयोगकर्ताओं को मैनेज करना
खाता सेटिंग में मौजूद उपयोगकर्ता पेज पर जाकर, पार्टनर खाते के उपयोगकर्ताओं को मैनेज किया जा सकता है. पार्टनर खाता बनाने वाले उपयोगकर्ता को मालिक की भूमिका मिलती है. नए उपयोगकर्ता, मैनेजर या रीडर की भूमिका निभा सकते हैं.
- पार्टनर खाते के किसी भी और सभी एजेंट को मैनेज करने के लिए, मैनेजर Developer Console की सभी क्षमताओं को ऐक्सेस कर सकते हैं.
- पार्टनर खाते के किसी भी या सभी एजेंट को देखने के लिए, पाठकों के पास Developer Console का रीड ओनली ऐक्सेस होता है.
उपयोगकर्ता को जोड़ना
उपयोगकर्ता जोड़ने के लिए, इनपुट फ़ील्ड में उसका ईमेल पता डालें और उसकी भूमिका चुनें.
जब किसी नए उपयोगकर्ता को जोड़ा जाता है, तो उसे एक ईमेल मिलता है. इसमें बताया जाता है कि उसके पास पार्टनर खाते का ऐक्सेस है.
किसी उपयोगकर्ता को हटाना
उपयोगकर्ता को हटाने का तरीका:
- वह उपयोगकर्ता ढूंढें जिसे आपको हटाना है. इसके बाद, उनकी टेबल की लाइन में बटन पर क्लिक करें.
- उपयोगकर्ता को हटाएं को चुनें.
- हटाने की पुष्टि करें.
आपने जिस उपयोगकर्ता को हटाया है उसे एक ईमेल मिलता है. इसमें बताया जाता है कि अब उसके पास पार्टनर खाते का ऐक्सेस नहीं है.
मालिक की भूमिका वाले उपयोगकर्ता को नहीं हटाया जा सकता. मालिक को बदलने या हटाने के लिए, आपको सहायता टीम से संपर्क करना होगा.
उपयोगकर्ता की भूमिका बदलना
उपयोगकर्ता की भूमिका अपडेट करने के लिए:
- वह उपयोगकर्ता ढूंढें जिसे आपको अपडेट करना है. इसके बाद, उनकी टेबल की लाइन में बटन पर क्लिक करें.
- भूमिका में बदलाव करें चुनें.
- ड्रॉप-डाउन से कोई नई भूमिका चुनें.
- सेव करें पर क्लिक करें.
एपीआई कॉल की पुष्टि करने के लिए सेवा खाता सेट अप करें
RBM API को कॉल करने पर, कॉल की पुष्टि सेवा खाता कुंजी से की जाती है. इस कुंजी से आपको ब्रैंड और एजेंट बनाने और उन्हें मैनेज करने के साथ-साथ, एजेंट के तौर पर मैसेज और अनुरोध भेजने की सुविधा भी मिलती है.
सेवा खाता कुंजी जनरेट करने के लिए, यह तरीका अपनाएं:
- खाता सेटिंग में, सेवा खाते के पेज पर जाएं.
- कुंजी बनाएं पर क्लिक करें, फिर बनाएं पर क्लिक करें. आपका ब्राउज़र, सेवा खाता कुंजी डाउनलोड करता है.
अपनी सेवा खाता कुंजी को सुरक्षित और निजी जगह पर सेव करें. अपनी कुंजी सार्वजनिक रूप से शेयर न करें. आरबीएम एपीआई को ऐक्सेस करने के लिए, आपको बाद में इस कुंजी की ज़रूरत होगी.
अपने पार्टनर वेबहुक को कॉन्फ़िगर करें
वेबहुक, एक ऐसा एचटीटीपीएस कॉलबैक होता है जिसे पार्टनर ने बनाया है. इससे पता चलता है कि आपके एजेंट को मैसेज और इवेंट का जवाब कैसे देना चाहिए. वेबहुक को कॉन्फ़िगर करने के बाद, मैसेज पाना और इवेंट पाना शुरू किया जा सकता है.
पार्टनर वेबहुक को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
Business Communications डेवलपर कंसोल खोलें और अपने आरबीएम पार्टनर के Google खाते से साइन इन करें.
खाता सेटिंग खोलें.
आरसीएस बिज़नेस मैसेजिंग वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.
वेबहुक एंडपॉइंट यूआरएल के लिए, "https://" से शुरू होने वाला अपना वेबहुक यूआरएल डालें.
अपने
clientTokenकी वैल्यू नोट करें. आपको यह पुष्टि करनी होगी कि आपको जो मैसेज मिल रहे हैं वे Google से आ रहे हैं.दिए गए
clientTokenपैरामीटर वालेPOSTअनुरोध को स्वीकार करने के लिए, अपने वेबहुक को कॉन्फ़िगर करें. साथ ही, रिस्पॉन्स के मुख्य हिस्से के तौर पर,secretपैरामीटर की सादे टेक्स्ट वाली वैल्यू के साथ200 OKरिस्पॉन्स भेजें.उदाहरण के लिए, अगर आपके वेबहुक को यहां दिए गए बॉडी कॉन्टेंट के साथ
POSTअनुरोध मिलता है, तो{ "clientToken":"SJENCPGJESMGUFPY", "secret":"1234567890" }इसके बाद, आपके वेबहुक को
clientTokenवैल्यू की पुष्टि करनी चाहिए. अगरclientTokenसही है, तो रिस्पॉन्स के मुख्य हिस्से के तौर पर1234567890के साथ200 OKरिस्पॉन्स दिखेगा:// clientToken from Configure const myClientToken = "SJENCPGJESMGUFPY"; // Example endpoint app.post("/rbm-webhook", (req, res) => { const msg = req.body; if (msg.clientToken === myClientToken) { res.status(200).send(msg.secret); return; } res.send(400); });Developer Console में, पुष्टि करें पर क्लिक करें. आरबीएम जब आपके वेबहुक की पुष्टि करता है, तब डायलॉग बंद हो जाता है.
आने वाले मैसेज की पुष्टि करें
वेबहुक को किसी भी ईमेल पते से मैसेज मिल सकते हैं, इसलिए आपको इस बात की पुष्टि करनी होगी कि Google ने मैसेज का कॉन्टेंट प्रोसेस करने से पहले ही मैसेज भेजे हैं.
यह पुष्टि करने के लिए कि Google ने आपको मैसेज भेजा है, यह तरीका अपनाएं:
- मैसेज का
X-Goog-Signatureहेडर एक्सट्रैक्ट करें. यह मैसेज के मुख्य हिस्से के पेलोड की हैश की गई, base64-एन्कोडेड कॉपी है. - अनुरोध के
message.bodyएलिमेंट में मौजूद आरबीएम पेलोड को Base-64-डिकोड करें. - अपने वेबहुक के क्लाइंट टोकन (जिसका इस्तेमाल आपने वेबहुक सेट अप करते समय किया था) का इस्तेमाल, कुंजी के तौर पर करके, base-64 डिकोड किए गए मैसेज पेलोड की बाइट का SHA512 HMAC बनाएं और नतीजे को base64 कोड में बदलें.
X-Goog-Signatureहैश की तुलना, अपने बनाए गए हैश से करें.- अगर हैश मेल खाते हैं, तो आपने पुष्टि की है कि Google ने मैसेज भेज दिया है.
अगर हैश मेल नहीं खाते हैं, तो किसी अच्छे मैसेज पर हैशिंग प्रोसेस की जांच करें.
अगर आपकी हैशिंग प्रोसेस ठीक से काम कर रही है और आपको ऐसा मैसेज मिलता है कि आपको धोखाधड़ी से भेजा गया है, तो हमसे संपर्क करें.
Node.js
if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
// Validate the received hash to ensure the message came from Google RBM
let userEventString = Buffer.from(requestBody.message.data, 'base64');
let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
let data = hmac.update(userEventString);
let genHash = data.digest('base64');
let headerHash = req.header('X-Goog-Signature');
if (headerHash === genHash) {
let userEvent = JSON.parse(userEventString);
console.log('userEventString: ' + userEventString);
handleMessage(userEvent);
} else {
console.log('hash mismatch - ignoring message');
}
}
res.sendStatus(200);
अगले चरण
आपका पार्टनर खाता सेट अप हो गया है. अब अपना पहला एजेंट बनाएं.