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à có thể liên hệ được qua nền tảng RCS cho doanh nghiệp thì nhân viên hỗ trợ mới gửi được tin nhắn. 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 cho doanh nghiệp sẽ gửi tin nhắn ngay lập tức. Nếu không, nền tảng RCS cho doanh nghiệp sẽ đưa tin nhắn vào hàng đợi và gửi tin nhắn đó khi người dùng trực tuyến vào lần tiếp theo.

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

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 gửi.

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ỳ 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/agentMessages.

Tham số truy vấn

Thông 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à 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 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.