مسارات المحادثة

إنّ إرسال الرسائل والأحداث واستلامها من الجوانب الأساسية للتواصل بين الوكيل والمستخدم. يرسل الموظفون الرسائل والأحداث والطلبات إلى المستخدمين من خلال طلبات HTTP POST إلى واجهة برمجة التطبيقات RBM API، ولكنهم يتلقّون الرسائل والأحداث التي أنشأها المستخدمون في الخادم وكيل الذي تم ضبطه.

في ما يلي مثال على مسار محادثة يستخدم عيّنات بيانات لتوضيح كيف يمكن للرسائل والأحداث والطلبات أن تؤدي إلى تفاعلات مفيدة ومفيدة.

مرحبًا بالجميع

في هذا المثال، يرسل موظّف الدعم Hello, World! كرسالة إلى المستخدم، ويردّ المستخدم بHello to you!.

1. يرسل موظّف الدعم طلب التحقّق من الإمكانات للتأكّد من أنّ جهاز المستخدم متوافق مع ميزة "إدارة البريد الوارد".

   يرسل موظّف الدعم ما يلي:

   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"
   }