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

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

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

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

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

• שם המותג שהנציג ייצג
• • שם
  • האזור שבו הנציג יפעל
  • קטגוריית חיוב
  • תרחיש לדוגמה
• מכשיר Android עם מספר טלפון פעיל
• מכונה לפיתוח שאפשר להריץ בה קוד לדוגמה

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

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

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

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

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

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

השלבים הבאים

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

הגדרת הנציג

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

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

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

• צפון אמריקה
• אירופה
• אסיה והפאסיפיק

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

הערה: אי אפשר לשנות את האזור של הסוכן אחרי שיוצרים אותו.

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

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

• שיחה – חיוב על שיחה שמכילה כמה הודעות A2P ו-P2A בתקופה נתונה.
• הודעה יחידה – חיוב על הודעה יחידה שמכילה תוכן עשיר של RBM (למשל, הודעה שמכילה כרטיס עשיר או קרוסלה).
• הודעה בסיסית – חיוב על הודעת טקסט רגילה באורך של עד 160 תווים.

כשיוצרים את הנציג, בוחרים את קטגוריית החיוב שתואמת בצורה הטובה ביותר להתנהגות של לוגיק הנציג:

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

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

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

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

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

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

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

במאמר בחירת תרחיש לדוגמה מוסבר בפירוט מתי כדאי להשתמש בכל תרחיש לדוגמה.

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

יצירת הנציג

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

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

1. פותחים את Business Communications Developer Console ונכנסים באמצעות חשבון Google שלכם כשותף RBM.
2. לוחצים על Create agent.
3. בשדה סוג הנציג, בוחרים באפשרות RCS Business Messaging.
4. בשדה Brand, בוחרים את המותג שאותו הנציג ייצג, או לוחצים על Add new brand ומזינים את השם שלו.
5. מזינים את שם הנציג ובוחרים את האזור, קטגוריית החיוב ותרחיש לדוגמה של הנציג. לאחר מכן לוחצים על Create agent.
6. כשהנציג זמין, לוחצים על השם שלו.

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

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

עכשיו, אחרי שיצרתם נציג ומכשיר הבדיקה שלכם תומך ב-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 במספר הטלפון של מכשיר הבדיקה. יש לכלול את קוד המדינה, את קוד האזור ואת התו + בתחילת המספר, אבל לא להוסיף תווים מפרידים. לדוגמה, [phone].
• מחליפים את AGENT ID במזהה הנציג, שמופיע בדף פרטי הנציג ב-Business Communications Developer Console.
• מחליפים את PATH_TO_SERVICE_ACCOUNT_KEY בנתיב של המפתח שיצרתם קודם.

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

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

השלבים הבאים

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

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