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 người dùng chưa bật RCS, thì nền tảng RCS cho Doanh nghiệp sẽ trả về lỗi NOT_FOUND (HTTP 404). Nếu người dùng đã bật RCS nhưng hiện không liên lạc được, thì nền tảng sẽ trả về phản hồi 200 OK và xử lý việc gửi dựa trên loại sự kiện. Các sự kiện của tác nhân được xếp hàng đợi trong hàng đợi lưu trữ và chuyển tiếp trong tối đa 30 ngày và được gửi khi người dùng kết nối lại với mạng. Chỉ các sự kiện IS_TYPING là tạm thời và không được đưa vào hàng đợi.

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.