Method: phones.agentMessages.create

Gửi tin nhắn từ nhân viên hỗ trợ đến người dùng.

Người dùng phải bật RCS và nền tảng RCS for Business phải liên lạc được với người dùng thì nhân viên hỗ trợ mới có thể gửi tin nhắn thành công. Nếu không, tác nhân sẽ nhận được mã lỗi 404.

Nếu người dùng đang trực tuyến, nền tảng RCS for Business sẽ gửi tin nhắn ngay lập tức. Nếu không, nền tảng RCS for Business sẽ đưa tin nhắn vào hàng đợi và gửi tin nhắn khi người dùng kết nối mạng trở lại.

Nền tảng RCS for Business sẽ bỏ qua mọi tin nhắn của tác nhân được gửi bằng mã nhận dạng đã được một tin nhắn hoặc sự kiện trước đó sử dụng và được gửi từ cùng một tác nhân.

Bạn có thể thu hồi tin nhắn của nhân viên hỗ trợ trong khoảng thời gian từ khi gửi đến khi tin nhắn được chuyển đến người nhận.

Yêu cầu HTTP

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

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ụ: với số điện thoại Hoa Kỳ +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/agentMessages.

Tham số truy vấn

Tham số
messageId

string

Bắt buộc. Mã nhận dạng duy nhất của tin nhắn, do nhân viên hỗ trợ chỉ định. Đây phải là UUID, như được định nghĩa trong https://www.rfc-editor.org/info/rfc9562. Nền tảng RCS for Business sẽ bỏ qua mọi tin nhắn của tác nhân được gửi bằng mã nhận dạng đã được một tin nhắn hoặc sự kiện trước đó sử dụng và được gửi từ cùng một tác nhân.

agentId

string

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

Nội dung yêu cầu

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

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 AgentMessage.

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.