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

يُعد إرسال وتلقي الرسائل والأحداث من أهم جوانب التواصل بين الوكيل والمستخدم. يرسل الوكلاء الرسائل والأحداث والطلبات إلى المستخدمين عبر طلبات HTTP POST إلى واجهة برمجة تطبيقات RBM، لكنهم يستلمون الرسائل والأحداث التي أنشأها المستخدمون بتنسيق JSON من Cloud Pub/Sub.

في ما يلي مثال على سلسلة محادثات تستخدم نموذج بيانات لتوضيح كيف يمكن للرسائل والأحداث والطلبات إنشاء تفاعلات مفيدة وهادفة.

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

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

1. يرسل الوكيل طلب فحص إمكانية التحقق للتأكد من أن جهاز المستخدم متوافق مع ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)".

   يرسل الوكيل:

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

2. يرسل النظام الأساسي لميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" إلى الوكيل ردًا على إمكانية التحقّق يشير إلى أنه يمكن لجهاز المستخدم تلقّي رسائل بشأن ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)".

   يتلقى الوكيل ما يلي:

   {
     "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 التي تمرِّرها إلى جهاز المستخدم.

   يرسل الوكيل:

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

4. يرسل النظام الأساسي لميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" الرسالة إلى جهاز المستخدم ويرسل حدث DELIVERED إلى الوكيل.

   يتلقى الوكيل ما يلي:

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

5. يفتح المستخدم الرسالة على جهازه، ما يؤدي إلى إرسال حدث READ إلى الوكيل.

   يتلقى الوكيل ما يلي:

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

6. يكتب المستخدم ويرسل ردًا إلى الوكيل.

   يتلقى الوكيل ما يلي:

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

7. يرسل النظام الأساسي لميزة "مراسلة نصية في الوقت الفعلي" (RBM) إلى جهاز المستخدم تلقائيًا حدث DELIVERED عند استلامه رسالة المستخدم.

8. يرسل الوكيل حدث READ ردًا على رسالة المستخدم لإبلاغه بأنه تم استلامه وإقراره.

   يرسل الوكيل:

   {
     "eventType": "READ",
     "messageId": "msg000999888777a"
   }