أجهزة الاختبار

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

للتواصل مع وكيل RBM، يجب أن يكون جهاز الاختبار مفعَّلاً لخدمة RCS. يُرجى ملاحظة أنّ بعض خدمات Android لا يتم تفعيل خدمات الاتصالات التفاعلية (RCS) عليها بشكل تلقائي. يمكنك التحقّق من حالة خدمات الاتصالات التفاعلية (RCS) لجهازك وتفعيل خدمات الاتصالات التفاعلية (RCS) إذا لزم الأمر من خلال إعداد جهازك باستخدام الإصدارات التجريبية من تطبيقَي "الرسائل" و"خدمات مشغّل شبكة الجوّال".

عندما يكون جهازك متوافقًا مع خدمات الاتصالات التفاعلية (RCS)، يمكنك إرسال طلب اختباري لدعوة الجهاز لاختبار الوكيل. بعد أن يقبل الجهاز الطلب، يمكنه تلقّي رسائل والرد عليها من الوكيل الذي لم يتم إطلاق العنان له.

ويمكن للوكيل إرسال 20 طلبًا للمختبِرين كل يوم مع إجمالي 200 طلب للمختبرين. في حال إضافة مختبرين من خلال واجهة برمجة التطبيقات لميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)"، ثم إرسال أكثر من 200 طلب، ستعرض منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" استجابة 429 RESOURCE_EXHAUSTED.

التحقّق من حالة خدمات الاتصالات التفاعلية (RCS) لجهازك

  1. في تطبيق "الرسائل"، انتقِل إلى إعدادات "الرسائل".
  2. انقر على محادثات عبر خدمات الاتصالات التفاعلية (RCS). إذا لم يظهر لك خيار "محادثات RCS"، انقر على ميزات الدردشة.

  3. ابحث عن قيمة الحالة.

    إذا كانت الحالة متصل، تكون خدمات الاتصالات التفاعلية (RCS) مفعّلة على جهازك.

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

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

تفعيل خدمات الاتصالات التفاعلية (RCS) على جهازك

لتفعيل خدمات الاتصالات التفاعلية (RCS) على جهاز Android، يجب تفعيل المحادثات عبر خدمات الاتصالات التفاعلية (RCS) في تطبيق "الرسائل".

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

بعد تفعيل خدمات الاتصالات التفاعلية (RCS) على جهازك، تكون جاهزًا لإرسال طلب اختبار التطبيق.

إرسال طلب اختبار

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

إذا لم يكن الجهاز متوافقًا مع خدمات الاتصالات التفاعلية (RCS)، أو لم يستجِب لطلب المختبِر، أو رفض الطلب، يتلقّى الوكيل خطأ 403 PERMISSION_DENIED عند محاولة الاتصال بالجهاز.

الخيار 1: إرسال طلب إلى أحد المختبرِين باستخدام وحدة تحكّم Business Communications Developer Console

  1. افتح Business Developer Communications Console وسجّل الدخول باستخدام حسابك في Google RBM وانقر على الوكيل.
  2. في شريط التنقل الأيمن، انقر على الأجهزة.
  3. بالنسبة إلى إضافة أجهزة اختبار، أدخِل رقم هاتف جهازك وانقر على إضافة.

توضّح قائمة أجهزة الاختبار حالة طلب المختبِر لكل جهاز تدعوه لاختبار وكيلك.

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

يُرسِل الرمز التالي طلب مختبر. للتعرُّف على خيارات التنسيق والقيمة، يُرجى الاطّلاع على phones.testers.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('../libs/rbm_api_helper');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});
هذا الرمز مقتطف من وكيل نموذج RBM.

لغة Java

import com.google.rbm.samples.lib.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
هذا الرمز مقتطف من وكيل نموذج RBM.

لغة Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')
هذا الرمز مقتطف من وكيل نموذج RBM.

C#‎

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");
هذا الرمز مقتطف من وكيل نموذج RBM.

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

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

إزالة جهاز اختباري

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

  1. افتح Business Developer Communications Console وسجّل الدخول باستخدام حسابك في Google RBM وانقر على الوكيل.
  2. في شريط التنقل الأيمن، انقر على الأجهزة.
  3. حدِّد موقع الجهاز في قائمة أجهزة الاختبار وانقر على القائمة لهذا العنصر.
  4. انقر على إزالة الجهاز.