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

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

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

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

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

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

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

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

आरबीएम पार्टनर के तौर पर, आपके पास ब्रैंड की ओर से एजेंट बनाने का विकल्प होता है.

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

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

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

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

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

  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 डेवलपर कंसोल खोलें और अपने आरबीएम पार्टनर के Google खाते से साइन इन करें.

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

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

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

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

  6. अपने वेबहुक को, बताए गए 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);
});

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

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

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

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

यह पुष्टि करने के लिए कि आपको 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);

अगले चरण

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

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