תהליכי השיחה

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

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

שלום עולם!

בדוגמה הזו, הנציג שולח את הערך Hello, World! כהודעה למשתמש, והמשתמש משיב ב-Hello to you!.

1. הסוכן שולח בקשה לבדיקת היכולות כדי לוודא שהמכשיר של המשתמש תומך ב-RBM.

   הנציג שולח:

   GET
   /v1/phones/[phone]/capabilities?requestId=147547143069602483572&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json

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

   הנציג מקבל:

   {
     "rbmEnabled": true,
     "features": [
       "REVOCATION",
       "RICHCARD_STANDALONE",
       "RICHCARD_CAROUSEL",
       "ACTION_CREATE_CALENDAR_EVENT",
       "ACTION_DIAL",
       "ACTION_OPEN_URL",
       "ACTION_SHARE_LOCATION",
       "ACTION_VIEW_LOCATION"
      ]
   }

3. הנציג שולח את ההודעה Hello, World! ל-RBM API, שמעביר אותה למכשיר של המשתמש.

   הנציג שולח:

   POST
   /v1/phones/[phone]/agentMessages?messageId=123&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json
   {
     "contentMessage": {
       "text": "Hello, World!",
     }
   }

4. פלטפורמת RBM שולחת את ההודעה למכשיר של המשתמש ושולחת אירוע DELIVERED לנציג.

   הנציג מקבל:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "DELIVERED",
     "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg",
     "messageId": "123"
   }

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

   הנציג מקבל:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "READ",
     "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj",
     "messageId": "123"
   }

6. המשתמש כותב תשובה ומעביר אותה לנציג.

   הנציג מקבל:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "messageId": "msg000999888777a",
     "sendTime": "2018-12-31T15:01:23.045123456Z",
     "text": "Hello to you!",
   }

7. פלטפורמת RBM שולחת באופן אוטומטי אירוע DELIVERED למכשיר של המשתמש כשהיא מקבלת את ההודעה שלו.

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

   הנציג שולח:

   POST
     /v1/phones/[phone]/agentEvents?eventId=1234&agentId=welcome-bot
     HTTP/1.1
     Host: us-rcsbusinessmessaging.googleapis.com
     Content-Type: application/json
     {
       "eventType": "READ",
       "messageId": "msg000999888777a"
   }