Thu hồi thư

Nhân viên hỗ trợ có thể thu hồi một tin nhắn đã được gửi nhưng chưa được chuyển đi. Tốt nhất là bạn nên thu hồi những thư chưa gửi được trước khi chúng trở nên lỗi thời. Thời gian phụ thuộc vào trường hợp sử dụng của trợ lý ảo. Ví dụ: bạn có thể thu hồi một thông báo OTP sau 10 phút nhưng thu hồi một thông báo khuyến mãi vào một ngày hết hạn cụ thể. Để gửi tin nhắn kịp thời, hãy nhớ thu hồi tin nhắn đúng lúc để bạn có thể gửi chúng bằng một phương thức thay thế như SMS.

Có 2 cách để thu hồi thư:

• Gửi yêu cầu thu hồi để kích hoạt quy trình thu hồi. Phản hồi 200 OK xác nhận rằng thông báo đã bị thu hồi và xoá khỏi hàng đợi của người dùng. 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.

• Đặt thời gian hết hạn cho tin nhắn để tự động thu hồi tin nhắn vào thời điểm thích hợp. Nền tảng RBM sẽ thông báo cho nhân viên hỗ trợ của bạn khi tin nhắn đã hết hạn và xác nhận xem tin nhắn đó có bị thu hồi thành công hay không. Hãy xem phần Sự kiện do máy chủ tạo để biết thêm thông tin.

Việc thu hồi có thể không thành công trong một số ít trường hợp. Ví dụ: đại lý của bạn có thể cố gắng thu hồi một tin nhắn trong khi nền tảng RBM đang trong quá trình gửi tin nhắn đó. Nếu việc thu hồi không thành công, hãy kiểm tra sự kiện DELIVERED tại webhook của bạn. Nếu tin nhắn chưa được gửi, bạn có thể gửi một yêu cầu thu hồi mới rồi chuyển tin nhắn đến một kênh thay thế như SMS để gửi kịp thời.

Ví dụ:

Mã sau đây sẽ gửi một yêu cầu thu hồi. Để biết thông tin về định dạng và giá trị, hãy xem phones.agentMessages.delete.

cURL

curl -X DELETE "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages/MESSAGE_ID?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Stop the message associated with messageId from being delivered
rbmApiHelper.revokeMessage('[phone]', messageId, function(err, response) {
   console.log(response);
});

Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu RBM.

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Stop the message associated with messageId from being delivered
   rbmApiHelper.revokeMessage(messageId, "[phone]");
} catch(Exception e) {
   e.printStackTrace();
}

Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service

# Stop the message associated with message_id from being delivered
rbm_service.revoke('[phone]', message_id)

Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Stop the message associated with messageId from being delivered
rbmApiHelper.RevokeMessage(messageId, "[phone]");

Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu RBM.