إعداد جهاز اختباري

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

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

يمكن للوكلاء إرسال 20 دعوة كحدّ أقصى للمختبِرين في اليوم الواحد، مع حدّ إجمالي يبلغ 200 دعوة.

التحقّق من حالة RCS على جهازك

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

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

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

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

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

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

إرسال دعوة إلى مختبِر

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

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

وحدة التحكّم

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

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

عند إضافة جهاز إلى القائمة، يتم إرسال دعوة. تظهر للمستخدم رسالة الدعوة على جهازه، ويمكنه قبولها أو رفضها.

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

واجهة برمجة التطبيقات

لإرسال دعوة إلى مختبِر باستخدام RBM Management API، اتّبِع الخطوات التالية:

  • استخدِم الرمز التالي. للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى testers.

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', 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("+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.

إذا أرسلت أكثر من 200 دعوة، ستعرض منصة RBM رمز الخطأ 429 RESOURCE_EXHAUSTED في الرد.

إعادة إرسال دعوة إلى مختبِر

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

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

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

الحصول على حالة دعوة جهاز اختباري

عندما تدعو أحد المختبِرين، يمكنه قبول الدعوة أو رفضها على جهازه. يمكنك طلب حالة الدعوة للجهاز من واجهة برمجة التطبيقات.

وحدة التحكّم

للاطّلاع على حالة دعوة جهاز اختبار باستخدام Business Communications Developer Console، اتّبِع الخطوات التالية:

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

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

واجهة برمجة التطبيقات

للحصول على حالة الدعوة لجهاز اختبار باستخدام RBM Management API، اتّبِع الخطوات التالية:

  • استخدِم الرمز التالي. للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

الحصول على حالة جميع الأجهزة الاختبارية

يمكنك الاستعلام عن حالة الدعوة لجميع الأجهزة التي دعوتها لتكون من بين المختبِرين.

وحدة التحكّم

للاطّلاع على حالة الدعوة لجميع الأجهزة الاختبارية باستخدام Business Communications Developer Console، اتّبِع الخطوات التالية:

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

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

واجهة برمجة التطبيقات

للتحقّق من حالة الدعوة لجميع الأجهزة الاختبارية باستخدام RBM Management API، اتّبِع الخطوات التالية:

  • استخدِم الرمز التالي. للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

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

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

وحدة التحكّم

لإزالة جهاز اختبار باستخدام Business Communications Developer Console، اتّبِع الخطوات التالية:

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

واجهة برمجة التطبيقات

لإزالة جهاز اختباري باستخدام RBM Management API، اتّبِع الخطوات التالية:

  • استخدِم الرمز التالي. للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى testers.

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
السابق
تعديل معلومات الوكيل
التالي
روابط لصفحات معيّنة