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

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

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