التعديلات: يمكنك الاطّلاع على ملاحظات الإصدار للتعرّف على الميزات الجديدة وتحديثات المنتجات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

الحقل	الوصف
اسم الشريك	اسم حسابك على المنصة الشريكة
الاسم المعروض	سيظهر الاسم في تقارير الفوترة التي تتلقّاها شركات النقل (في الحقل `owner_name`). سيستخدم مشغّلو شبكات الجوّال هذه المعلومات لتحديد هويتك كشريك موثوق به وإنشاء معلومات الفواتير الصحيحة المتعلقة باستخدامك ميزة "خدمات الاتصالات التفاعلية" للوصول إلى المشتركين. يجب أن يتطابق الاسم الذي تقدّمه هنا مع الاسم المستخدَم في عقود المراسلة مع مشغّل شبكة الجوّال.
جهة الاتصال الفنية	الشخص الذي ستتواصل معه Google في حال حدوث أي مشاكل فنية متعلّقة بوكلائك. يمكنك تعديل الاسم عنوان البريد الإلكتروني الخاص بالشركة رقم الهاتف
الردّ التلقائي على الويب	هذا هو عنوان URL لنقطة نهاية الردّ التلقائي على الويب. انقر على ضبط لتعديله. عند ضبط إعدادات Webhook الخاص بالشريك، ينطبق ذلك على جميع وكلائك. إذا أردت استخدام خطاف ويب مختلف لوكيل فردي، يمكنك ضبط خطاف ويب خاص بالوكيل لا ينطبق إلا على هذا الوكيل.

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

بصفتك شريكًا في "RCS للأنشطة التجارية"، يمكنك إنشاء وكلاء نيابةً عن العلامات التجارية.

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

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

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

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

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

انقر على مربّع الاختيار بجانب اسم العلامة التجارية.
انقر على الزر ، ثم انقر على تعديل الاسم.
أجرِ التعديلات التي تريدها، ثم انقر على تم.

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

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

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

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

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

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

إضافة مستخدم

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

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

إزالة مستخدم

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

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

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

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

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

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

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

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

عند إجراء طلبات إلى RBM API، يجب إثبات صحة الطلبات باستخدام مفتاح حساب خدمة. يتيح لك هذا المفتاح إنشاء العلامات التجارية والوكلاء وإدارتهم، وإرسال الرسائل والطلبات بصفتك وكيلاً. يمكن أن يتضمّن حساب الخدمة ما يصل إلى 10 مفاتيح.

للمصادقة على طلبات البيانات من واجهة برمجة التطبيقات بشكل آمن، تحتاج أيضًا إلى أداة سطر الأوامر oauth2l.

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

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

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

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

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

إذا أردت استخدام رد تلقائي مختلف على الويب لأي من وكلائك، يمكنك إعداد رد تلقائي على الويب على مستوى الوكيل سيحلّ محل الرد التلقائي على الويب الخاص بالشريك. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط خطاف ويب للوكيل.

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

افتح Business Communications Developer Console وسجِّل الدخول باستخدام حسابك على Google الذي يخص شريكك في "خدمة الرسائل الغنية عن الأعمال".
افتح إعدادات الحساب.
بالنسبة إلى عنوان URL الخاص بالردّ التلقائي على الويب لميزة "المراسلة التجارية من خلال خدمات الاتصالات التفاعلية"، انقر على ضبط.
بالنسبة إلى عنوان URL لنقطة نهاية الردّ التلقائي على الويب، أدخِل عنوان URL للردّ التلقائي على الويب يبدأ بـ "https://‎".
دوِّن قيمة clientToken. تحتاج إلى هذا الرقم للتأكّد من أنّ الرسائل التي تتلقّاها واردة من Google.
اضبط إعدادات الرد التلقائي على الويب لقبول طلب 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);
});
```
في Developer Console، انقر على تأكيد. عندما تتحقّق خدمة "محادثات RCS للأنشطة التجارية" من عنوان URL الخاص بخدمة الويب، سيتم إغلاق مربّع الحوار.

للحصول على إرشادات حول معالجة خطافات الويب بشكل غير متزامن لمنع حدوث أخطاء في التسليم، راجِع مقالة التعامل مع الرسائل.

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

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

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

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

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

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

التسجيل كشريك

إنشاء وكيلك الأول