अपना पार्टनर खाता सेट अप करें

RCS for Business पार्टनर के तौर पर रजिस्टर करने के बाद, आपको एक पार्टनर खाता मिलता है. अपने पार्टनर खाते की सेटिंग ऐक्सेस करने के लिए, Business Communications Developer Console खोलें और पार्टनर खाते की सेटिंग पर क्लिक करें. यहां से, ये काम किए जा सकते हैं:

पार्टनर खाते की जानकारी अपडेट करना

सेटिंग पेज पर जाकर, पार्टनर आईडी देखा जा सकता है. साथ ही, यहां दी गई जानकारी को अपडेट किया जा सकता है:

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

आपके एजेंट से जुड़ी कोई तकनीकी समस्या आने पर, Google इस व्यक्ति से संपर्क करेगा. इनकी जानकारी अपडेट की जा सकती है

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

ब्रैंड मैनेज करना

RCS for Business के पार्टनर के तौर पर, ब्रैंड की ओर से एजेंट बनाए जा सकते हैं.

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

कोई ब्रैंड जोड़ें

किसी ब्रैंड को जोड़ने के लिए, इनपुट फ़ील्ड में उसका नाम डालें और जोड़ें पर क्लिक करें.

किसी ब्रैंड में बदलाव करना

किसी ब्रैंड में बदलाव करने के लिए:

  1. ब्रैंड के नाम के बगल में मौजूद चेकबॉक्स पर क्लिक करें.
  2. बटन पर क्लिक करें. इसके बाद, नाम बदलें पर क्लिक करें.
  3. बदलाव करने के बाद, हो गया पर क्लिक करें.

किसी ब्रैंड को हटाना

अगर कोई ब्रैंड किसी एजेंट से जुड़ा है, तो उसे हटाया नहीं जा सकता. भले ही, एजेंट लॉन्च न हुआ हो.

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

उपयोगकर्ताओं को मैनेज करना

खाता सेटिंग में मौजूद उपयोगकर्ता पेज पर जाकर, अपने पार्टनर खाते के उपयोगकर्ताओं को मैनेज किया जा सकता है. जिस उपयोगकर्ता ने पार्टनर खाता बनाया है उसके पास मालिक की भूमिका होती है. नए उपयोगकर्ताओं को मैनेजर या रीडर की भूमिका दी जा सकती है.

  • मैनेजर, Developer Console की सभी सुविधाओं को ऐक्सेस कर सकते हैं. इससे वे पार्टनर खाते से जुड़े सभी एजेंट को मैनेज कर सकते हैं.
  • रीडर के पास, Developer Console का रीड-ओनली ऐक्सेस होता है. इससे वे पार्टनर खाते से जुड़े किसी भी और सभी एजेंट को देख सकते हैं.

उपयोगकर्ता को जोड़ना

किसी उपयोगकर्ता को जोड़ने के लिए, इनपुट फ़ील्ड में उसका ईमेल पता डालें. इसके बाद, उसकी भूमिका चुनें.

किसी नए उपयोगकर्ता को जोड़ने पर, उसे एक ईमेल मिलता है. इसमें बताया जाता है कि उसके पास पार्टनर खाते का ऐक्सेस है.

किसी उपयोगकर्ता को हटाना

उपयोगकर्ता को हटाने का तरीका:

  1. उस उपयोगकर्ता को ढूंढें जिसे आपको हटाना है. इसके बाद, उसकी टेबल लाइन में मौजूद बटन पर क्लिक करें.
  2. उपयोगकर्ता को हटाएं को चुनें.
  3. हटाने की पुष्टि करें.

जिस उपयोगकर्ता को आपने हटाया है उसे एक ईमेल मिलता है. इसमें बताया जाता है कि अब उसके पास पार्टनर खाते का ऐक्सेस नहीं है.

मालिक की भूमिका वाले उपयोगकर्ता को नहीं हटाया जा सकता. मालिक को बदलने या हटाने के लिए, आपको सहायता टीम से संपर्क करना होगा.

उपयोगकर्ता की भूमिका बदलना

किसी उपयोगकर्ता की भूमिका अपडेट करने के लिए:

  1. उस उपयोगकर्ता को ढूंढें जिसकी भूमिका आपको अपडेट करनी है. इसके बाद, उसकी टेबल रो में मौजूद बटन पर क्लिक करें.
  2. भूमिका में बदलाव करें को चुनें.
  3. ड्रॉप-डाउन से कोई नई भूमिका चुनें.
  4. सेव करें पर क्लिक करें.

एपीआई कॉल की पुष्टि करने के लिए, सेवा खाता सेट अप करना

RBM API को कॉल करते समय, सेवा खाते की कुंजी से कॉल की पुष्टि की जाती है. इस कुंजी की मदद से, ब्रैंड और एजेंट बनाए जा सकते हैं और उन्हें मैनेज किया जा सकता है. साथ ही, एजेंट के तौर पर मैसेज और अनुरोध भेजे जा सकते हैं. किसी सेवा खाते में ज़्यादा से ज़्यादा 10 कुंजियां हो सकती हैं.

एपीआई कॉल की पुष्टि सुरक्षित तरीके से करने के लिए, आपको oauth2l कमांड लाइन टूल की भी ज़रूरत होगी.

सेवा खाता कुंजी जनरेट करने के लिए, यह तरीका अपनाएं:

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

अपने सेवा खाते की कुंजी को किसी सुरक्षित और निजी जगह पर सेव करें. अपनी कुंजी को सार्वजनिक तौर पर शेयर न करें. आपको RBM API (एपीआई) को ऐक्सेस करने के लिए, बाद में इस कुंजी की ज़रूरत पड़ेगी.

पार्टनर के वेबहुक को कॉन्फ़िगर करना

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

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

अपने पार्टनर वेबहुक को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  1. Business Communications डेवलपर कंसोल खोलें और RCS for Business के अपने पार्टनर के Google खाते से साइन इन करें.

  2. खाता सेटिंग खोलें.

  3. आरसीएस बिज़नेस मैसेजिंग वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.

  4. वेबहुक एंडपॉइंट यूआरएल के लिए, "https://" से शुरू होने वाला वेबहुक यूआरएल डालें.

  5. अपनी clientToken वैल्यू नोट करें. इसकी ज़रूरत इसलिए होती है, ताकि यह पुष्टि की जा सके कि आपको मिले मैसेज Google से ही मिले हैं.

  6. अपने वेबहुक को कॉन्फ़िगर करें, ताकि वह बताए गए clientToken पैरामीटर के साथ POST अनुरोध स्वीकार कर सके. साथ ही, secret पैरामीटर की सादे टेक्स्ट वाली वैल्यू के साथ 200 OK जवाब भेज सके.

    उदाहरण के लिए, अगर आपके वेबुक को यह बॉडी कॉन्टेंट वाला POST अनुरोध मिलता है

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    इसके बाद, आपके वेबहुक को clientToken वैल्यू की पुष्टि करनी चाहिए. अगर clientToken सही है, तो 200 OK रिस्पॉन्स में 1234567890 को रिस्पॉन्स बॉडी के तौर पर दिखाना चाहिए:

    // 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);
});

  7. Developer Console में, पुष्टि करें पर क्लिक करें. RCS for Business आपके वेबुक की पुष्टि करता है, तो डायलॉग बंद हो जाता है.

डिलीवरी में होने वाली गड़बड़ियों को रोकने के लिए, वेबहुक को एसिंक्रोनस तरीके से प्रोसेस करने के बारे में जानने के लिए, मैसेज हैंडलिंग लेख पढ़ें.

आने वाले मैसेज की पुष्टि करना

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

इस बात की पुष्टि करने के लिए कि आपको मिला मैसेज Google ने भेजा है, यह तरीका अपनाएं:

  1. मैसेज के X-Goog-Signature हेडर को एक्सट्रैक्ट करें. यह मैसेज के मुख्य हिस्से के पेलोड की हैश की गई, base64 कोड में बदली गई कॉपी है.
  2. अनुरोध के message.body एलिमेंट में मौजूद RBM पेलोड को Base-64-डिकोड करें.
  3. अपने वेबहुक के क्लाइंट टोकन (जिसे आपने वेबहुक सेट अप करते समय तय किया था) को कुंजी के तौर पर इस्तेमाल करके, base-64 डिकोड किए गए मैसेज पेलोड के बाइट का SHA512 एचएमएसी बनाएं. इसके बाद, नतीजे को base64 में बदलें.
  4. 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);

अगले चरण

अब आपका पार्टनर खाता सेट अप हो गया है. अब आपको अपना पहला एजेंट बनाना है.

पीछे जाएं
पार्टनर के तौर पर रजिस्टर करना
आगे बढ़ें
अपना पहला एजेंट बनाएं