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

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

• تعديل معلومات حساب الشريك
• إضافة العلامات التجارية المرتبطة بحسابك وتعديلها وإزالتها
• إدارة مستخدمي الحساب
• إنشاء حساب خدمة ومفتاح للمصادقة على طلبات البيانات من واجهة برمجة التطبيقات

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

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

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

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

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

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

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

ملاحظة: لإضافة علامة تجارية باستخدام RBM Management API، يُرجى الرجوع إلى مستندات إنشاء علامة تجارية.

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

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

ملاحظة: لتعديل علامة تجارية باستخدام RBM Management API، يُرجى الرجوع إلى مستندات إعادة تسمية علامة تجارية.

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

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

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

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

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

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

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

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

إضافة مستخدم

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

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

إزالة مستخدم

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

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

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

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

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

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

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

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

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

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

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

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

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

إعداد الويب هوك الخاص بالشريك

للتعرّف على كيفية ضبط إعدادات ويب هوك الشريك، يُرجى الاطّلاع على دليل Webhooks.

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

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

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

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

1. استخرِج عنوان X-Goog-Signature للرسالة. هذه نسخة مجزّأة بترميز base64 من حمولة نص الرسالة.
2. فك ترميز حمولة RBM بترميز Base64 في العنصر message.body من الطلب.
3. باستخدام الرمز المميز للعميل الخاص بخطاف الويب (الذي حدّدته عند إعداد خطاف الويب)، أنشئ رمز HMAC SHA512 من وحدات البايت الخاصة بحِمل الرسالة الذي تم فك ترميزه باستخدام 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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);
  

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

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