إلغاء الرسائل

يمكن لوكيلك إبطال رسالة تم إرسالها ولكن لم يتم تسليمها بعد. من الأفضل إلغاء الرسائل التي لم يتم تسليمها قبل أن تصبح قديمة. يعتمد التوقيت على حالة استخدام الوكيل على سبيل المثال، يمكنك إبطال رسالة كلمة المرور لمرة واحدة (OTP) بعد عشر دقائق، ولكن يمكنك إبطال رسالة ترويجية في تاريخ انتهاء صلاحية محدد. بالنسبة إلى تسليم الرسائل في الوقت المناسب، تأكد من إبطال الرسائل في الوقت المناسب لإرسالها من خلال مسار بديل مثل الرسائل القصيرة SMS.

هناك طريقتان لإلغاء رسالة:

• أرسِل طلب إبطال لبدء عملية الإبطال. عندما يتلقى نظام RBM طلب إبطال، يعرض النظام الأساسي 200 OK (موافق). لا يؤكد استجابة 200 OK ما إذا كان قد تم إبطال الرسالة أم لا. إذا تم الإبطال بنجاح، سيتوقف النظام الأساسي "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" عن محاولة تسليم الرسالة، ويتم حذفها من قائمة انتظار المستخدم.

• حدد تاريخ انتهاء صلاحية الرسالة لإبطال الرسالة تلقائيًا في الوقت المناسب. وترسل منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" لوكيلك عند انتهاء صلاحية الرسالة، وتؤكد ما إذا تم إبطالها بنجاح أم لا. راجِع الأحداث التي ينشئها الخادم للحصول على مزيد من المعلومات.

قد يتعذّر الإبطال في حالات نادرة. على سبيل المثال، قد يحاول الوكيل إبطال رسالة أثناء عملية تسليمها من خلال النظام الأساسي "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)". إذا تعذّر الإبطال، تحقَّق من توفّر حدث DELIVERED عند الرد التلقائي على الويب. إذا لم يتم تسليم الرسالة، يمكنك إرسال طلب إبطال جديد ثم توجيه الرسالة إلى قناة بديلة مثل خدمة الرسائل القصيرة لضمان تسليم الرسالة في الوقت المناسب.

مثال

يرسل الرمز التالي طلب إبطال. للحصول على معلومات التنسيق والقيمة، يُرجى الاطّلاع على القسم phones.agentMessages.delete.

cURL

curl -X DELETE "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages/MESSAGE_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('../libs/rbm_api_helper');

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

هذا الرمز هو مقتطف من نموذج لوكيل ميزة RBM.

Java

import com.google.rbm.samples.lib.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();
}

هذا الرمز هو مقتطف من نموذج لوكيل ميزة 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)

هذا الرمز هو مقتطف من نموذج لوكيل ميزة 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]");

هذا الرمز هو مقتطف من نموذج لوكيل ميزة RBM.