רוצה ליצור את הנציג הראשון שלך?

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

תהליך העברת ההודעה בשיחה עם תמיכה ב-RBM

דרישות מוקדמות

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

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

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

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

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

  2. מקישים על תכונות הצ'אט ומאתרים את הערך סטטוס.

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

השלבים הבאים

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

הגדרת הנציג

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

זיהוי האזור של הנציג

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

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

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

  • אם אתם נמצאים באמריקה הלטינית, בוחרים באזור צפון אמריקה.
  • אם אתם נמצאים באפריקה, בוחרים באזור אירופה.
  • אם אתם נמצאים באוסטרליה, בוחרים באזור אסיה והאוקיינוס השקט.

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

איך בודקים מהי קטגוריית החיוב של הנציג

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

  • שיחה: לנציגים שמנהלים שיחות עם משתמשים שמתנהלות בכמה סבבים.
  • הודעה בסיסית או הודעה יחידה: לסוכנויות ששולחות הודעות בלי לצפות לתשובות תכופות.

אפשר לשנות את קטגוריית החיוב של הנציג רק לפני ההפעלה שלו. אם צריך לשנות את קטגוריית החיוב אחרי ההשקה, שולחים אימייל לכתובת rbm-support@google.com.

מידע נוסף על מודל החיוב של RBM זמין בשאלות הנפוצות בנושא חיוב ב-RBM.

זיהוי התרחיש לדוגמה של הנציג

לכל סוכן RBM נדרש תרחיש לדוגמה (Use Case) שהוגדר מראש. כך תוכלו לסווג את הנציג ולהחיל את כללי העסק המתאימים כדי לספק חוויית משתמש טובה. ב-RBM יש תמיכה בארבעה תרחישים לדוגמה:

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

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

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

יצירת הנציג

כדי ליצור את הנציג במסוף הפיתוח של Business Communications, פועלים לפי ההוראות הבאות.

כדי ליצור סוכן:

  1. נכנסים למסוף הפיתוח של Business Communications ונכנסים באמצעות חשבון Google שלכם כשותף RBM.
  2. בדף הבית, לוחצים על + יצירת סוכן.
  3. בחלון New RCS Business Messaging agent, מציינים את הפרטים הבאים:
  4. לוחצים על Create agent.

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

שליחת הזמנה למכשיר הבדיקה

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

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

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

שליחת הודעה

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

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

מריצים את הפקודה הבאה בטרמינל במחשב הפיתוח:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_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`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'
  • מחליפים את REGION ב-asia, ב-europe או ב-us, בהתאם לאזור של הנציג.
  • מחליפים את PHONE_NUMBER במספר הטלפון של מכשיר הבדיקה. צריך לכלול את קוד המדינה, את קוד האזור ואת התו + בתחילת המספר, אבל לא להוסיף תווים מפרידים. לדוגמה, +14155555555.
  • מחליפים את AGENT ID במזהה הנציג, שמופיע בדף פרטי הנציג ב-Business Communications Developer Console.
  • מחליפים את PATH_TO_SERVICE_ACCOUNT_KEY בנתיב של המפתח שיצרתם קודם.

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

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

השלבים הבאים

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

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

הקודם
איך מגדירים חשבון שותף/ה