Method: phones.agentEvents.create

Gửi một sự kiện từ tác nhân đến người dùng.

Bạn có thể dùng sự kiện của nhân viên hỗ trợ để cho biết nhân viên hỗ trợ đã đọc tin nhắn của người dùng hoặc nhân viên hỗ trợ đang nhập (thêm yếu tố con người vào trải nghiệm RCS cho doanh nghiệp). Nếu RCS for Business không thể liên hệ với người dùng, thì nền tảng RCS for Business sẽ trả về 404 NOT_FOUND.

Không giống như tin nhắn của nhân viên hỗ trợ, bạn không thể thu hồi sự kiện của nhân viên hỗ trợ sau khi gửi.

Yêu cầu HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

"phones/{E.164}", trong đó {E.164} là số điện thoại của người dùng ở định dạng E.164. Ví dụ: đối với người dùng có số điện thoại ở Hoa Kỳ là +1-222-333-4444, giá trị sẽ là phones/+12223334444 và điểm cuối thu được sẽ là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

Tham số truy vấn

Thông số
eventId

string

Mã nhận dạng của sự kiện, do tác nhân chỉ định. Đây phải là một UUID, như được xác định trong https://tools.ietf.org/html/rfc4122. Nền tảng RCS cho doanh nghiệp sẽ bỏ qua mọi tin nhắn của nhân viên hỗ trợ được gửi bằng một mã nhận dạng mà một tin nhắn hoặc sự kiện trước đó đã sử dụng khi được gửi từ cùng một nhân viên hỗ trợ.
agentId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của nhân viên.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của AgentEvent.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của AgentEvent.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.