Quy trình trò chuyện

Gửi và nhận tin nhắn cũng như sự kiện là các khía cạnh cốt lõi trong quá trình giao tiếp giữa nhân viên hỗ trợ và người dùng. Các nhân viên hỗ trợ gửi thông báo, sự kiện và yêu cầu cho người dùng thông qua các yêu cầu POST qua HTTP đến API RBM, nhưng nhận các thông báo 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. Nhân viên hỗ trợ 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 hỗ trợ RBM.

   Nhân viên hỗ trợ sẽ 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 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 này gửi thông báo Hello, World! đến API RBM, API này sẽ chuyể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ở thông báo trên thiết bị của họ, thao tác này sẽ gửi một sự kiện READ cho 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 một sự kiện DELIVERED đến thiết bị của người dùng khi nhận được tin nhắn 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ợ 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"
   }