Thu hồi tin nhắn của nhân viên hỗ trợ đã được gửi nhưng chưa được chuyển đi.
Nếu nền tảng RCS for Business 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 (200 OK).
Phản hồi 404 Not Found (Không tìm thấy) có nghĩa là yêu cầu thu hồi không thành công vì thư đã được gửi.
Có một í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 RCS for Business đang trong quá trình gửi tin nhắn. Trong một số ít trường hợp này, tác nhân sẽ nhận được một sự kiện người dùng DELIVERED cho 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
| Thông 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 thông báo của nhân viên hỗ trợ cần thu hồi. Ví dụ: với số điện thoại ở Hoa Kỳ là +1-222-333-4444 và một tin nhắn của nhân viên hỗ trợ có mã nhận dạng "12345xyz", điểm cuối thu đượ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. |
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, phần 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.