عمليات التحقق من الإمكانية

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

إذا لم يتمكن جهاز المستخدم من استلام رسائل RCS مطلقًا، يمكنك: التواصل مع المستخدم من خلال الخدمات الأخرى، مثل الرسائل القصيرة SMS.

إرسال فحص للإمكانات

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

cURL

curl -X GET "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/capabilities?requestId=REQUEST_ID&agentId=AGENT_ID" \
-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 a capability check to the device
rbmApiHelper.checkCapability('+12223334444', function(response) {
   // Print capabilities of the device
   console.log(response);
});
 هذا الرمز هو مقتطف من نموذج وكيل RBM.

Java

import com.google.rbm.RbmApiHelper;
…

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

// Check the capabilities of the device
boolean capability = rbmApiHelper.getCapability("+12223334444");
 هذا الرمز هو مقتطف من نموذج وكيل RBM.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
response = rbm_service.make_cap_request('+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
Capabilities capabilities = rbmApiHelper.GetCapability("+12223334444");
 هذا الرمز هو مقتطف من نموذج وكيل RBM.

استجابة القدرة

بعد إجراء فحص للإمكانيات، تعرض منصة RBM قائمة بتنسيق JSON الميزات المتاحة في الجهاز المحدَّد.

{
  "features": [
    "REVOCATION",
    "RICHCARD_STANDALONE",
    "RICHCARD_CAROUSEL",
    "ACTION_CREATE_CALENDAR_EVENT",
    "ACTION_DIAL",
    "ACTION_OPEN_URL",
    "ACTION_SHARE_LOCATION",
    "ACTION_VIEW_LOCATION",
  ]
}

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

في حال إرسال فحص إمكانية إلى مستخدم خدمات الاتصالات التفاعلية (RCS) على إحدى الشبكات، حيث يكون لم يتم إطلاق وكيلك بعد، ستعرض منصة RBM الخطأ 403.

عمليات التحقّق المجمّعة للإمكانات

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

يمكنك تحديد ما يصل إلى 10000 رقم هاتف لكل فحص إمكانية مجمَّعة. للتحقق أو إجراء عمليات تحقق متعددة. استخدام ميزة التحقّق من الإمكانات المجمّعة نص برمجي لاستخدام ملفات CSV كتنسيق إدخال.

إنّ عمليات التحقق من الإمكانيات المجمّعة تصل إلى 600 طلب بحث في الدقيقة كحد أقصى (QPM).

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

تقدير إجمالي المستخدمين الذين يمكن الوصول إليهم

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

عندما يُجري الوكيل فحصًا لإمكانات أكثر من 500 رقم هاتف دُفعة واحدة يستخدم RBM عيّنات عشوائية لما يقارب% 75 من هذه الأرقام للتحقّق من جميع مشغّلي شبكات الجوّال. (تم الإبلاغ في totalRandomSampleUserCount). تُرجع RBM أيضًا عدد الأرقام التي يمكن الوصول إليها من خلال العيّنة العشوائية التي يمكن الوصول إليها، بغض النظر عن إطلاق مشغّل شبكة الجوّال الحالة (reachableRandomSampleUserCount). بقسمة reachableRandomSampleUserCount بواسطة totalRandomSampleUserCount، يمكنك تحديد النسبة المئوية للأرقام التي يمكن لوكيلك الوصول إليها في حال إطلاق التطبيق لجميع مشغلي شبكة الجوال.

فعلى سبيل المثال، إذا حددت 5000 رقم هاتف في فحص إمكانية الإمكانيات المجمّعة، وأخذت RBM عيّنات عشوائية بنسبة% 75 تقريبًا من الأرقام المحدّدة، قد يكون totalRandomSampleUserCount 3750. إذا reachableRandomSampleUserCount هو 3000، ثم تمكّن من الوصول إلى 80% من عيّنات الأرقام.

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

إرسال اختبار مُجمَّع للإمكانات

يرسل الرمز التالي فحصًا للإمكانات بشكل مجمّع وينتظر الرد. بالنسبة خيارات التنسيق والقيمة، يمكنك الاطلاع على users.batchGet

يجب أن تكون أرقام الهواتف بتنسيق E.164. على سبيل المثال، " +12223334444".

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/users:batchGet?agentId=AGENT_ID \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "users": [
    "PHONE_NUMBER",
  ]
}'

Node.js

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

// Specify phone numbers
let phoneNumbers = ['+12223334444', '+12223334444'];

// Perform a bulk capability check
rbmApiHelper.getUsers(phone_numbers, function(response) {
   // Print the bulk capability check response
   console.log(response);
});
 يستخدم هذا الرمز البرمجي نموذج RBM .

Java

import com.google.rbm.RbmApiHelper;
…

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

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.getUsers(Arrays.asList("+12223334444", "+12223334444"));
 يستخدم هذا الرمز البرمجي نموذج RBM .

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Perform a bulk capability check
response = rbm_service.make_batch_cap_request(['+12223334444', '+12223334444'])
 يستخدم هذا الرمز نموذج وكيل RBM.

#C

using RCSBusinessMessaging;
…

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

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.GetUsers(new List({"+12223334444", "+12223334444"}));
 يستخدم هذا الرمز البرمجي نموذج RBM .

الردّ المجمّع للتحقّق من الإمكانيات

بعد إجراء فحص للإمكانات المُجمَّعة، تعرض ميزة RBM رد بتنسيق JSON.

{
  "reachableUsers": [
    "PHONE_NUMBER"
  ],
  "totalRandomSampleUserCount": "COUNT_OF_SAMPLE",
  "reachableRandomSampleUserCount": "REACHABLE_FROM_SAMPLE"
}
الحقل الوصف
reachableUsers قائمة بالمستخدمين الذين يمكن الوصول إليهم على صفحة الوكيل أطلقوا شبكات الجوّال.
totalRandomSampleUserCount عدد عينة عشوائية من الأرقام. وعادةً ما يكون حوالي 75% من الأرقام المحددة.
reachableRandomSampleUserCount عدد الأرقام من التوزيع العشوائي عينة يمكن الوصول إليها من خلال RBM على جميع مشغّلي شبكات الجوّال، بغض النظر مشغّلي شبكة الجوّال الذين يتمّ إطلاق الوكيل عليهم.

الأداة: النص البرمجي للتحقق من الإمكانات المجمّعة

تشير رسالة الأشكال البيانية النص البرمجي للتحقق من قدرة حزم البيانات (سجّل الدخول إلى تنزيل) إجراء عمليات فحص للإمكانات المجمّعة باستخدام ملفات CSV كتنسيقات للإدخال والإخراج. يحلّل النص البرمجي ملف CSV لأرقام MSISDN ويستخدم RBM SDK للتحقّق من إمكانات كل جهاز مدرَج.

جهاز افتراضي يتألف من وحدتَي معالجة مركزية (CPU) وذاكرة وصول عشوائي (RAM) بسعة 4 غيغابايت، ويعمل على تشغيل البرنامج النصي مع 500 سلسلة محادثات يمكن أن تصل إلى حوالي ألف طلب في الثانية، ولكن يعتمد إجمالي عدد الطلبات في الثانية على الجهاز المستخدم، بلد الأجهزة والإعدادات الإقليمية لوكيلك وواجهة برمجة التطبيقات نقطة النهاية المستخدمة.

المتطلبات الأساسية

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

  • المسار إلى ملف CSV يحتوي على أرقام MSISDN لإجراء عمليات التحقّق من الإمكانيات في
  • المسار إلى مفتاح حساب خدمة الوكيل على جهاز التطوير

بالإضافة إلى ذلك، يجب تثبيت البرامج التالية في حزمة تطوير البرامج الجهاز:

إعداد

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

إجراء فحص مجمّع

  1. في الوحدة الطرفية، انتقِل إلى الدليل الجذري للنص البرمجي.

  2. شغِّل الأوامر التالية:

    export MAVEN_OPTS="-Xms1024m -Xmx3000m"
mvn compile && mvn exec:java -Dexec.args="AGENT_ID INPUT_FILE OUTPUT_FILE NUM_OF_THREADS START_INDEX END_INDEX"

    استبدل المتغيرات بالقيم التي حددتها.

    استبدال يشمل مثال
    AGENT_ID رقم تعريف وكيل ميزة "مراسلة الأنشطة التجارية" في خدمات الاتصالات التفاعلية (RCS) welcome-bot
    INPUT_FILE المسار إلى ملف CSV الذي تم إدخاله. input.csv
    OUTPUT_FILE المسار إلى ملف إخراج CSV. output.csv
    NUM_OF_THREADS عدد سلاسل المحادثات التي يتم تخصيصها لعمليات التحقق من الإمكانات. 500
    START_INDEX اختياريّ. القيمة في ملف CSV البدء في إجراء عمليات تحقق مقابلها. 5
    END_INDEX اختياريّ. القيمة في ملف CSV وإنهاء عمليات التحقق بعد ذلك. 500

  3. عند اكتمال النص البرمجي، افتح ملف الإخراج CSV لعرض النتائج.

السابق
الأحداث