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

بعد التسجيل كشريك في RCS for Business، يصبح لديك حساب شريك. للوصول إلى إعدادات حساب الشريك، افتح الـ RCS for Business Developer Console وانقر على إعدادات حساب الشريك. من هنا، يمكنك إجراء ما يلي:

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

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

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

الشخص الذي ستتواصل معه Google في حال حدوث أي مشاكل فنية متعلّقة بـ وكلائك يمكنك تعديل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إضافة مستخدم

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

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

إزالة مستخدم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. استخرِج عنوان X-Goog-Signature في الرسالة. هذه نسخة مجزّأة ومشفرة بترميز base64 من حمولة نص الرسالة.
  2. فكِّر ترميز حمولة RBM بترميز base64 في العنصر message.body من الطلب.
  3. باستخدام رمز العميل الخاص بالويب هوك (الذي حدّدته عند إعداد الويب هوك) كمفتاح، أنشِئ رمز HMAC باستخدام SHA512 لبايتات حمولة الرسالة التي تم فك ترميزها بترميز base64، ثمّ شفِّر النتيجة بترميز base64.
  4. قارِن التجزئة X-Goog-Signature بالتجزئة التي أنشأتها.

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

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

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

السابق
التسجيل كشريك
التالي
إنشاء وكيلك الأول