Quy trình trò chuyện

Gửi và nhận tin nhắn và sự kiện là các khía cạnh cốt lõi trong hoạt động giao tiếp giữa nhân viên hỗ trợ và người dùng. Nhân viên hỗ trợ gửi tin nhắn, sự kiện và yêu cầu cho người dùng qua yêu cầu HTTP POST tới API RBM nhưng nhận được tin nhắn và sự kiện do người dùng tạo dưới dạng JSON từ Cloud Pub/Sub.

Dưới đây là quy trình mẫu về cuộc trò chuyện sử dụng dữ liệu mẫu để minh hoạ cách thư, 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!

Một cuộc trò chuyện cơ bản giữa nhân viên hỗ trợ và người dùng.

Trong ví dụ này, tác nhân sẽ gửi Hello, World! dưới dạng tin nhắn cho người dùng, và người dùng sẽ phản hồi bằng Hello to you!.

Sơ đồ nối tiếp tin nhắn của nhân viên hỗ trợ và phản hồi của người dùng.

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

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

    GET
/v1/phones/+12223334444/capabilities?requestId=147547143069602483572
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ợ 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ợ nhận:

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

  3. Nhân viên hỗ trợ gửi thông báo Hello, World! đến API RBM. API này sẽ chuyển thông tin đó đến thiết bị của người dùng.

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

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

  4. Nền tảng RBM gửi thông báo đến thiết bị của người dùng và gửi sự kiện DELIVERED đến nhân viên hỗ trợ.

    Nhân viên hỗ trợ nhận:

    {
  "senderPhoneNumber": "+12223334444",
  "eventType": "DELIVERED",
  "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg",
  "messageId": "123"
}

  5. Người dùng mở tin nhắn trên thiết bị của họ, việ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ợ nhận:

    {
  "senderPhoneNumber": "+12223334444",
  "eventType": "READ",
  "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj",
  "messageId": "123"
}

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

    Nhân viên hỗ trợ nhận:

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

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

  8. Nhân viên hỗ trợ 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:

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