Thu hồi tin nhắn của nhân viên hỗ trợ đã được gửi nhưng chưa được gửi.
Nếu nền tảng RBM thu hồi thành công một tin nhắn, thì tin nhắn đó sẽ bị xoá khỏi hàng đợi tin nhắn của người dùng và không bao giờ được gửi đi.
Phương thức này ngay lập tức trả về 200 OK cho dù thông báo có được thu hồi thành công hay không.
Có rất ít trường hợp nhân viên hỗ trợ có thể khởi tạo việc thu hồi trong khi nền tảng RBM đang gửi thông báo. Trong một số ít trường hợp, tác nhân sẽ nhận được sự kiện người dùng ĐÃ GỬI đối với thông báo ngay sau khi bắt đầu yêu cầu thu hồi.
Yêu cầu HTTP
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Các tham số | |
|---|---|
name |
"phones/{E.164}/agentMessages/{messageId}", trong đó {E.164} là số điện thoại của người dùng ở định dạng E.164 và {messageId} là mã nhận dạng do nhân viên hỗ trợ chỉ định cho tin nhắn của nhân viên hỗ trợ cần được thu hồi. Ví dụ: với số điện thoại Hoa Kỳ +1-222-333-4444 và tin nhắn của nhân viên hỗ trợ có mã "12345xyz", thì điểm cuối sẽ là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Tham số truy vấn
| Các tham số | |
|---|---|
agentId |
Bắt buộc. Mã nhận dạng duy nhất của nhân viên hỗ trợ. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ trống.
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 Tổng quan về OAuth 2.0.