הגדרת מכשיר בדיקה

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

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

נציגים יכולים לשלוח עד 20 הזמנות לבודקים ביום, עם מגבלה כוללת של 200 הזמנות.

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

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

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

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

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

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

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

שליחת הזמנה לבודקים

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

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

המסוף

כדי לשלוח הזמנה לבודקים באמצעות Business Communications Developer Console:

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

כשמוסיפים מכשיר לרשימה, נשלחת הזמנה. המשתמש רואה את הודעת ההזמנה במכשיר שלו ויש לו אפשרות לאשר או לדחות אותה.

ברשימת המכשירים לבדיקה מפורט הסטטוס של ההזמנה לבדיקה לכל מכשיר שהזמנתם לבדוק את הנציג.

API

כדי לשלוח הזמנה לבודקים באמצעות 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 ההזמנה לבדיקה נדחתה. לפני ששולחים הזמנה מחדש, צריך להסיר את מכשיר הבדיקה. אחרת, הבקשה תיכשל.

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

איך בודקים את סטטוס ההזמנה של מכשיר בדיקה

כשמזמינים בודק, הוא יכול לאשר או לדחות את ההזמנה במכשיר שלו. אפשר לשלוח שאילתה ל-API כדי לבדוק את סטטוס ההזמנה של המכשיר.

המסוף

כדי לראות את סטטוס ההזמנה של מכשיר בדיקה באמצעות Business Communications Developer Console:

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

אחרי שמוסיפים מכשיר לבדיקה לרשימה, אפשר לבדוק את הסטטוס שלו בעמודה סטטוס.

API

כדי לקבל את סטטוס ההזמנה של מכשיר בדיקה באמצעות 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 Developer Console, נכנסים באמצעות חשבון Google של RBM ולוחצים על הסוכן.
  2. בתפריט הימני, לוחצים על מכשירים.
  3. כדי להוסיף מכשיר בדיקה, צריך להזין את מספר הטלפון שלו, כולל את קידומת החיוג של המדינה והאזור, ברשימת מכשירי הבדיקה. כדי להוסיף כמה מספרי טלפון, צריך להפריד ביניהם באמצעות פסיקים.

אחרי שמוסיפים מכשיר לבדיקה לרשימה, אפשר לבדוק את הסטטוס שלו בעמודה סטטוס.

API

כדי לבדוק את סטטוס ההזמנה של כל מכשירי הבדיקה באמצעות 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 Developer Console, נכנסים באמצעות חשבון Google של RBM ולוחצים על הסוכן.
  2. בתפריט הימני, לוחצים על מכשירים.
  3. בוחרים את המכשיר ברשימת מכשירי הבדיקה ולוחצים על תפריט .
  4. לוחצים על הסרת המכשיר.

API

כדי להסיר מכשיר בדיקה באמצעות 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`"
הקודם
עריכת פרטי הנציג
הבא
קישורי עומק