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

إنّ إرسال الرسائل والأحداث واستلامها من الجوانب الأساسية للتواصل بين الوكيل والمستخدم. ترسل الوكلاء الرسائل والأحداث والطلبات إلى المستخدمين من خلال طلبات 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"
   }