עד שהנציג יוכל לפעול, הוא יוכל לתקשר רק עם מכשירי בדיקה ייעודיים. כך תוכלו לבדוק את הנציג מבפנים כדי למנוע גישה מוקדמת למשתמשי קצה בטעות.
כדי לתקשר עם סוכן RBM, צריך להפעיל מכשיר RCS כדי לבדוק מכשיר. שימו לב במכשירי Android מסוימים לא מופעל RCS כברירת מחדל. תוכלו לבדוק את סטטוס ה-RCS של המכשיר, ובמידת הצורך להפעיל את RCS על ידי הגדרת המכשיר עם גרסאות טרום-השקה של האפליקציות Messages ו-Carrier Services.
כשהמכשיר תומך ב-RCS, אפשר לשלוח בקשת בדיקה כדי להזמין את המכשיר לבדיקת הנציג. ברגע שהמכשיר מקבל את הבקשה, הוא יכול לקבל הודעות מהנציג שלכם ולהשיב להן.
בכל יום אפשר לשלוח 20 בקשות בדיקה לכל היותר, ו-200 בקשות בדיקה לכל היותר. אם תוסיפו בודקים דרך API ל-RBM ותשלחו יותר מ-200 בקשות, הפלטפורמה של RBM תחזיר את התגובה 429 RESOURCE_EXHAUSTED.
בדיקת סטטוס ה-RCS של המכשיר
- באפליקציית Messages, עוברים להגדרות של Messages.
- מקישים על צ'אטים ב-RCS. אם האפשרות 'צ'אטים ב-RCS' לא מופיעה, מקישים על תכונות הצ'אט.
מאתרים את הערך סטטוס.
אם הסטטוס הוא מחובר, סימן ש-RCS פועל במכשיר.
השלבים הבאים
אם ה-RCS פעיל במכשיר שלכם, תוכלו לשלוח בקשה לבודקים. אם השימוש ב-RCS לא פעיל במכשיר, עליכם להפעיל את RCS במכשיר כדי שתוכלו לבדוק איתו את סוכן ה-RBM.
הפעלת RCS במכשיר
כדי להפעיל RCS במכשיר Android, מפעילים את הצ'אטים של RCS באפליקציית Messages.
השלבים הבאים
כש-RCS יהיה פעיל במכשיר, תוכלו לשלוח בקשה לבודקים.
שליחה של בקשת בדיקה
כדי להזמין מכשיר שתומך ב-RCS ולהפוך לבודק, צריך לשלוח בקשת בדיקה. אם המכשיר מאשר את הבקשה, הנציג יכול לשלוח למכשיר הודעות, אירועים ובקשות.
אם המכשיר לא תומך ב-RCS, הוא לא הגיב לבקשת הבודק או דחה את הבקשה, הנציג שלכם מקבל הודעת שגיאה ב-403 PERMISSION_DENIED כשהוא מנסה לתקשר עם המכשיר.
אפשרות 1: שליחת בקשה לבדיקה באמצעות Business Communications Developer Console
- פותחים את Business Communications Developer Console, נכנסים לחשבון Google RBM ולוחצים על הנציג שלכם.
- בתפריט הניווט הימני, לוחצים על מכשירים.
- בשדה הוספת מכשירי בדיקה, מזינים את מספר הטלפון של המכשיר ולוחצים על הוספה.
ברשימת מכשירי הבדיקה מוצג הסטטוס של בקשת הבודק בכל מכשיר שאתם מזמינים לבדיקת הנציג.
אפשרות 2: שליחת בקשת בדיקה באמצעות RBM API
הקוד הבא שולח בקשת בדיקה. לאפשרויות עיצוב וערך: phones.testers.
כתובת URL
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.
השלבים הבאים
אחרי שהמכשיר יאשר את בקשת הבודק, הוא יהיה מכשיר בדיקה ייעודי לנציג. אפשר לשלוח למכשיר הודעות, אירועים ובדיקות של יכולות כדי לבדוק את הפונקציונליות ואת תהליכי העבודה של הנציג.
הסרת מכשיר בדיקה
אם מסירים מכשיר בדיקה, הוא לא יכול לקבל יותר הודעות מהנציג שלא הופעל. הפלטפורמה של RBM לא מוחקת הודעות שנשלחו על ידי הנציג והן מועברות למכשיר הבדיקה.
- פותחים את Business Communications Developer Console, נכנסים לחשבון Google RBM ולוחצים על הנציג שלכם.
- בתפריט הניווט הימני, לוחצים על מכשירים.
- מאתרים את המכשיר בבדיקת רשימת המכשירים ולוחצים על התפריט של אותו פריט.
- לוחצים על הסרת המכשיר.