מכשירים לבדיקה

עד שתפעילו את הנציג, הוא יוכל לתקשר רק עם מכשירי בדיקה שהוגדרו לכך. כך תוכלו לבדוק את הנציג באופן פנימי בלי לאפשר גישה מוקדמת לאלפי משתמשי הקצה.

כדי לתקשר עם נציג RBM, מכשיר הבדיקה צריך לתמוך ב-RCS. חשוב לדעת שבמכשירי Android מסוימים, RCS לא מופעל כברירת מחדל. כדי לבדוק את סטטוס ה-RCS במכשיר, ואם צריך, להפעיל את ה-RCS, צריך להגדיר במכשיר גרסאות טרום-השקה של אפליקציות Messages ו-Carrier Services.

במכשיר שלכם פועל RCS, אתם יכולים לשלוח בקשת בודק כדי להזמין את המכשיר לבדוק את הנציג. אחרי שהמכשיר יאשר את הבקשה, הוא יוכל לקבל הודעות מהנציג שלא הושק וגם להשיב להן.

נציג יכול לשלוח 20 בקשות לבודקים בכל יום, עם סך כולל של 200 בקשות לבודקים. אם מוסיפים בודקים דרך RBM API ושולחים יותר מ-200 בקשות, פלטפורמת RBM מחזירה תשובה מסוג 429 RESOURCE_EXHAUSTED.

איך בודקים את סטטוס השימוש ב-RCS במכשיר

  1. באפליקציית Messages, עוברים אל הגדרות Messages.
  2. מקישים על שימוש ב-RCS לצ'אטים. לא מצאתם את ההגדרה 'שימוש ב-RCS לצ'אטים'? תוכלו להקיש על הפיצ'רים של הצ'אט.

  3. מאתרים את הערך Status.

    אם הסטטוס Connected (מחובר), המשמעות היא ש-RCS פעיל במכשיר.

השלבים הבאים

אם פרוטוקול RCS פעיל במכשיר, אתם מוכנים לשלוח בקשת בדיקה. אם ה-RCS לא פעיל במכשיר, צריך להפעיל את ה-RCS במכשיר כדי להתחיל לבדוק את סוכן ה-RBM באמצעותו.

הפעלת RCS במכשיר

כדי להפעיל את השימוש ב-RCS במכשיר Android, צריך להפעיל את השימוש ב-RCS לצ'אטים באפליקציית Messages.

השלבים הבאים

אחרי ש-RCS פעיל במכשיר, אפשר לשלוח בקשת בדיקה.

שליחת בקשה להצטרפות לתוכנית הבדיקה

כדי להזמין מכשיר עם תמיכה ב-RCS להצטרף לתוכנית הבדיקות, שולחים בקשה להצטרפות לתוכנית. אם המכשיר יאשר את הבקשה, הנציג יוכל לשלוח הודעות, אירועים ובקשות למכשיר.

אם המכשיר לא מופעל באמצעות RCS, לא הגיב לבקשת הבודק או דחה את הבקשה, הסוכן יקבל את השגיאה 403 PERMISSION_DENIED כשינסו לתקשר עם המכשיר.

אפשרות 1: שליחת בקשת בודק באמצעות Business Communications Developer Console

  1. פותחים את Business Communications Developer Console, נכנסים באמצעות חשבון 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('+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.

השלבים הבאים

אחרי שהמכשיר יאשר את הבקשה של הבודק, הוא יהפוך למכשיר בדיקה ייעודי לנציג שלכם. אתם יכולים לשלוח למכשיר הודעות, אירועים ובדיקות יכולות כדי לבדוק את הפונקציונליות ואת תהליכי העבודה של הנציג.

הסרה של מכשיר בדיקה

כשמסירים מכשיר בדיקה, המכשיר לא יכול יותר לקבל הודעות מהנציג שלא הופעל. פלטפורמת RBM לא מוחקת הודעות שנשלחו על ידי הנציג שלכם בזמן שהן בדרך למכשיר הבדיקה או שמאוחסנות בו.

  1. פותחים את מסוף הפיתוח של Business Communications, נכנסים באמצעות חשבון Google שלכם ב-RBM ולוחצים על הנציג.
  2. בחלונית הניווט הימנית, לוחצים על מכשירים.
  3. מאתרים את המכשיר ברשימת מכשירי הבדיקה ולוחצים על התפריט של פריט הרשימה הזה.
  4. לוחצים על הסרת המכשיר.
הקודם
עריכת פרטי הנציג
הבא
קישורי עומק