Quy trình trò chuyện

Việc gửi và nhận tin nhắn cũng như sự kiện là những khía cạnh cốt lõi của hoạt động giao tiếp giữa một nhân viên hỗ trợ và người dùng. Các tác nhân gửi tin nhắn, sự kiện và yêu cầu đến người dùng thông qua các yêu cầu POST HTTP đến API RBM, nhưng nhận tin nhắn và sự kiện do người dùng tạo tại webhook đã định cấu hình.

Sau đây là ví dụ về luồng trò chuyện sử dụng dữ liệu mẫu để minh hoạ cách tin nhắn, sự kiện và yêu cầu có thể tạo ra các lượt tương tác hữu ích và có ý nghĩa.

Chào bạn!

Trong ví dụ này, tác nhân gửi Hello, World! dưới dạng một thông báo đến người dùng và người dùng phản hồi bằng Hello to you!.

1. Tác nhân gửi yêu cầu kiểm tra chức năng để xác minh rằng thiết bị của người dùng có hỗ trợ RBM hay không.

   Nhân viên hỗ trợ gửi:

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

2. Nền tảng RBM sẽ gửi cho nhân viên hỗ trợ một phản hồi kiểm tra chức năng cho biết rằng thiết bị của người dùng có thể nhận tin nhắn RBM.

   Nhân viên hỗ trợ sẽ nhận được:

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

3. Tác nhân sẽ gửi thông báo Hello, World! đến API RBM, API này sẽ truyền thông báo đó đến thiết bị của người dùng.

   Nhân viên hỗ trợ sẽ gửi:

   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. Nền tảng RBM gửi tin nhắn đến thiết bị của người dùng và gửi một sự kiện DELIVERED đến nhân viên hỗ trợ.

   Nhân viên hỗ trợ sẽ nhận được:

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

5. Người dùng mở tin nhắn trên thiết bị của họ, thao tác này sẽ gửi một sự kiện READ đến nhân viên hỗ trợ.

   Nhân viên hỗ trợ sẽ nhận được:

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

6. Người dùng viết và gửi thư trả lời cho nhân viên hỗ trợ.

   Nhân viên hỗ trợ sẽ nhận được:

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

7. Nền tảng RBM sẽ tự động gửi sự kiện DELIVERED đến thiết bị của người dùng khi nhận được thông báo của người dùng.

8. Trợ lý sẽ gửi một sự kiện READ để phản hồi tin nhắn của người dùng, cho họ biết rằng tin nhắn đã được nhận và xác nhận.

   Nhân viên hỗ trợ sẽ gửi:

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