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

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

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

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

يمكن للوكيل إرسال 20 طلبًا للمختبِرين كل يوم بحد أقصى 200 طلب مختبِر. في حال إضافة مختبِرين من خلال واجهة برمجة التطبيقات RBM API وإرسال أكثر من 200 طلب، ستُرسِل منصة RBM استجابة 429 RESOURCE_EXHAUSTED.

ملاحظة: بعد إطلاق وكيلك، يمكنه التواصل مع أي جهاز مزوّد بخدمة RCS، وليس فقط الأجهزة الاختبارية.

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

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

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

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

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

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

تفعيل خدمات RCS على جهازك

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

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

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

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

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

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

الخيار 1: إرسال طلب اختبار باستخدام "وحدة تحكّم المطوّرين في منتجات التواصل مع الأنشطة التجارية"

1. افتح وحدة تحكّم مطوّري الرسائل التجارية ، سجِّل الدخول باستخدام حسابك على Google في "إدارة الأداء من خلال ميزة "الحملات على شبكة البحث" (RBM)، ثم انقر على وكيلك.
2. في شريط التنقّل الأيمن، انقر على الأجهزة.
3. بالنسبة إلى إضافة أجهزة اختبارية، أدخِل رقم هاتف جهازك وانقر على إضافة.

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

الخيار 2: إرسال طلب مختبِر باستخدام RBM API

يُرسِل الرمز التالي طلب اختبار. لمعرفة خيارات التنسيق والقيمة، راجِع 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('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('[phone]', function(response) {
   console.log(response);
});

هذه التعليمات البرمجية هي مقتطف من نموذج وكيل RBM.

Java

import com.google.rbm.RbmApiHelper;
…

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

   // Register the device as a tester
   rbmApiHelper.registerTester("[phone]");
} 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('[phone]')

هذه التعليمات البرمجية هي مقتطف من نموذج وكيل 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("[phone]");

هذه التعليمات البرمجية هي مقتطف من نموذج وكيل RBM.

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

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

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

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

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