Thu hồi một thông báo 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ó một chút khả năng là nhân viên hỗ trợ có thể bắt đầu thu hồi trong khi nền tảng RBM đang trong quá trình gửi thông báo. Trong một số ít trường hợp, nhân viên hỗ trợ sẽ nhận được một sự kiện người dùng ĐÃ TỪ CHỐI cho thông báo ngay sau khi khởi tạo 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
| Thông số | |
|---|---|
name |
"phone/{E.164}/agentTin nhắn/{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 của thông báo của nhân viên hỗ trợ cần được thu hồi. Ví dụ: Với số điện thoại tại Hoa Kỳ +1-222-333-4444 và tin nhắn của nhân viên hỗ trợ có mã nhận dạng là "12345xyz", thì điểm cuối nhận được sẽ là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Tham số truy vấn
| Thông số | |
|---|---|
agentId |
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 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ẽ là một đối tượng JSON 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 OAuth 2.0 Overview.