إعداد حساب الشريك

بعد التسجيل كشريك RBM، يصبح لديك حساب شريك. للوصول إلى إعدادات حساب الشريك، افتح وحدة تحكم مطوّري برامج اتصالات الأعمال وانقر على إعدادات حساب الشريك. ومن هنا، يمكنك القيام بما يلي:

تعديل معلومات حساب الشريك

من صفحة الإعدادات، يمكنك الاطّلاع على رقم تعريف الشريك وتعديل المعلومات التالية:

الحقل الوصف
اسم الشريك اسم حساب الشريك
الاسم المعروض سيظهر الاسم في تقارير فوترة RBM التي يتلقّاها مشغّلو شبكات الجوّال (مثل الحقل owner_name). سيستخدم مشغّلو شبكات الجوّال هذه المعلومات لتحديد هويتك كشريك موثوق به وضمان إنشاء معلومات الفوترة الصحيحة لاستخدام RBM للوصول إلى المشتركين. ويجب أن يكون الاسم الذي تقدّمه هنا متوافقًا مع الاسم المستخدَم في عقود المراسلة الخاصة بمشغّل شبكة الجوّال.
جهة الاتصال الفنية

الجهة التي ستتواصل معها Google في حال حدوث أي مشاكل فنية مع موظّفي الدعم يمكنك تحديث

  • الاسم
  • عنوان البريد الإلكتروني الخاص بالشركة
  • رقم الهاتف
الردّ التلقائي على الويب هذا هو عنوان URL لنقطة نهاية الرد التلقائي على الويب. انقر على **ضبط** لتعديلها. عند ضبط الرد التلقائي على الويب الخاص بالشريك، ينطبق ذلك على جميع موظّفي الدعم. إذا كنت تريد استخدام ردّ تلقائي على الويب مختلف لوكيل فردي، يمكنك ضبط ردّ تلقائي على الويب للوكيل سيتم تطبيقه على ذلك الوكيل فقط.

إدارة العلامات التجارية

بصفتك أحد شركاء RBM، يمكنك إنشاء وكلاء نيابةً عن العلامات التجارية.

استخدِم صفحة العلامات التجارية في إعدادات الحساب لإضافة وتعديل وإزالة العلامات التجارية المرتبطة بحساب شريكك.

إضافة علامة تجارية

لإضافة علامة تجارية، أدخِل اسمها في حقل الإدخال وانقر على إضافة.

تعديل علامة تجارية

لتعديل علامة تجارية، يُرجى اتّباع الخطوات التالية:

  1. انقر على مربّع الاختيار بجانب اسم العلامة التجارية.
  2. انقر على زر ، ثم انقر على تعديل الاسم.
  3. أدخِل التعديلات المطلوبة، ثم انقر على تم.

إزالة علامة تجارية

لا يمكن إزالة علامة تجارية إذا كانت مرتبطة بوكيل، حتى لو لم يتم إطلاق الوكيل.

لإزالة علامة تجارية، انقر على مربّع الاختيار بجانب اسم العلامة التجارية، ثمّ انقر على حذف.

إدارة المستخدِمين

في صفحة المستخدمون في إعدادات الحساب، يمكنك إدارة مستخدمي حساب الشريك. المستخدم الذي أنشأ حساب الشريك يكون له دور "المالك". يمكن أن يكون للمستخدمين الجدد دور المدير أو القارئ.

  • المدراء: يمكنهم الوصول إلى جميع ميزات Play Console لإدارة جميع الوكلاء التابعين لحساب الشريك.
  • القرّاء لديهم إذن بالقراءة فقط في Play Console للاطّلاع على جميع الوكلاء الذين ينتمون إلى حساب الشريك.

إضافة مستخدم

لإضافة مستخدم، أدخِل عنوان بريده الإلكتروني في حقل الإدخال واختَر الدور المناسب له.

عند إضافة مستخدم جديد، يتلقّى المستخدم رسالة إلكترونية لإعلامه بإمكانية الوصول إلى حساب الشريك.

إزالة مستخدم

لإزالة مستخدِم، اتّبِع الخطوات التالية:

  1. ابحث عن المستخدم الذي تريد إزالته، وانقر على الزر في صف الجدول.
  2. اختَر إزالة المستخدم.
  3. أكِّد عملية الإزالة.

يتلقى المستخدم الذي أزلته رسالة إلكترونية لإعلامه بأنه لم يعد بإمكانه الوصول إلى حساب الشريك.

لا يمكنك إزالة مستخدم تم منحه دور "المالك". لتغيير المالك أو إزالته، عليك التواصل مع فريق الدعم.

تغيير دور المستخدم

لتعديل دور المستخدم، اتّبِع الخطوات التالية:

  1. ابحث عن المستخدم الذي تريد تعديل بياناته، ثم انقر على الزر في صف الجدول.
  2. اختَر تعديل الدور.
  3. اختر دورًا جديدًا من القائمة المنسدلة.
  4. انقر على حفظ.

إعداد حساب الخدمة لمصادقة طلبات بيانات من واجهة برمجة التطبيقات

عند إجراء طلبات من RBM API، يتم مصادقة الطلبات باستخدام مفتاح حساب خدمة. يتيح لك هذا المفتاح إنشاء وإدارة العلامات التجارية والوكلاء، وإرسال رسائل والطلبات كوكيل.

اتّبِع الخطوات التالية لإنشاء مفتاح حساب الخدمة:

  1. في إعدادات الحساب، انتقِل إلى صفحة حساب الخدمة.
  2. انقر على إنشاء مفتاح، ثم انقر على إنشاء. ينزِّل متصفّحك مفتاح حساب الخدمة.

يجب تخزين مفتاح حساب الخدمة في مكان آمن وخاص. لا تشارك مفتاحك علنًا. وستحتاج إلى هذا المفتاح لاحقًا للوصول إلى واجهات برمجة التطبيقات المستندة إلى ميزة "مراسلة نصية في الوقت الفعلي".

ضبط الرد التلقائي على الويب الخاص بالشريك

الردّ التلقائي على الويب هو معاودة اتصال عبر HTTPS ينشئها الشريك وتحدّد كيفية استجابة وكيلك للرسائل والأحداث. بعد ضبط الرد التلقائي على الويب، يمكنك بدء استلام الرسائل والأحداث.

لضبط الرد التلقائي على الويب الخاص بالشريك، اتّبِع الخطوات التالية:

  1. افتح وحدة تحكم مطوّر البرامج في Business Communications وسجِّل الدخول باستخدام حساب Google الذي يضم شريك RBM.

  2. افتح إعدادات الحساب.

  3. بالنسبة إلى عنوان URL للردّ التلقائي على الويب الخاص بخدمة RCS Business Messaging، انقر على ضبط.

  4. بالنسبة إلى عنوان URL لنقطة نهاية الردّ التلقائي على الويب، أدخِل عنوان URL للردّ التلقائي على الويب الذي يبدأ بـ "https://".

  5. دوِّن قيمة clientToken. ستحتاج إليه للتأكّد من أنّ الرسائل التي تتلقّاها واردة من Google.

  6. اضبط الرد التلقائي على الويب لقبول طلب POST باستخدام مَعلمة clientToken المحدّدة وإرسال ردّ 200 OK مع قيمة النص العادي للمَعلمة secret باعتباره نص الاستجابة.

    على سبيل المثال، إذا تلقّى الرد التلقائي على الويب طلب 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. في Play Console، انقر على إثبات الملكية. عندما تتحقّق ميزة RBM من الردّ التلقائي على الويب، يتم إغلاق مربّع الحوار.

التحقُّق من الرسائل الواردة

بما أنّ الردود التلقائية على الويب يمكن أن تتلقّى رسائل من أي مُرسِلين، عليك التأكّد من أن Google أرسلت رسائل واردة قبل معالجة محتوى الرسائل.

للتحقّق من أنّ Google أرسلت رسالة تلقّيتها، اتّبِع الخطوات التالية:

  1. استخرِج عنوان X-Goog-Signature للرسالة. هذه نسخة مجزّأة بترميز base64 من حمولة نص الرسالة.
  2. فك ترميز حمولة RBM في العنصر message.body ضمن الطلب استنادًا إلى ترميز Base-64.
  3. باستخدام الرمز المميز للعميل الخاص بالردّ التلقائي على الويب (الذي حدّدته عند إعداد الردّ التلقائي على الويب) كمفتاح، أنشئ SHA512 HMAC بوحدات البايت الخاصة بحمولة الرسائل المفكوك ترميزها base-64 وترميز النتيجة باستخدام 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);

الخطوات التالية

بعد الانتهاء من إعداد حساب الشريك، حان الوقت لإنشاء أول وكيل.