لغو پیام ها

نماینده شما می تواند پیامی را که ارسال شده اما هنوز تحویل داده نشده است، لغو کند. بهتر است پیام‌های تحویل‌نگرفته را قبل از کهنه شدن لغو کنید. زمان بندی بستگی به مورد استفاده نماینده شما دارد. برای مثال، ممکن است یک پیام OTP را پس از ده دقیقه لغو کنید، اما یک پیام تبلیغاتی را در تاریخ انقضای خاصی لغو کنید. برای تحویل به موقع پیام، مطمئن شوید که پیام ها را به موقع لغو کنید تا آنها را از طریق یک مسیر جایگزین مانند SMS ارسال کنید.

دو راه برای لغو یک پیام وجود دارد:

• یک درخواست ابطال برای شروع ابطال ارسال کنید . هنگامی که پلتفرم RBM یک درخواست ابطال دریافت می کند، پلتفرم 200 OK را برمی گرداند. پاسخ 200 OK تایید نمی کند که آیا پیام باطل شده است یا خیر. اگر لغو موفقیت آمیز بود، پلت فرم RBM تلاش برای ارائه پیام را متوقف می کند و از صف کاربر حذف می شود.

• انقضای پیام را تنظیم کنید تا به طور خودکار پیام در زمان مناسب لغو شود. پلت فرم RBM هنگامی که پیام منقضی شده است به نماینده شما اطلاع می دهد و تأیید می کند که آیا با موفقیت لغو شده است یا خیر. برای اطلاعات بیشتر به رویدادهای ایجاد شده توسط سرور مراجعه کنید.

لغو ممکن است در موارد نادر با شکست مواجه شود. به عنوان مثال، نماینده شما ممکن است سعی کند پیامی را در حالی که پلتفرم RBM در حال تحویل آن است لغو کند. اگر لغو نشد، رویداد DELIVERED را در webhook خود بررسی کنید. اگر پیام تحویل داده نشده است، می توانید یک درخواست لغو جدید ارسال کنید و سپس پیام را به یک کانال جایگزین مانند پیامک هدایت کنید تا از تحویل به موقع اطمینان حاصل کنید.

مثال

کد زیر یک درخواست ابطال ارسال می کند. برای اطلاعات قالب‌بندی و ارزش، به phones.agentMessages.delete مراجعه کنید.

حلقه

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 است.

جاوا

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 است.

پایتون

# 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 است.

سی شارپ

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 است.