আপনার এজেন্ট পাঠানো কিন্তু এখনও ডেলিভারি না হওয়া মেসেজ বাতিল করতে পারেন। ডেলিভারি না হওয়া মেসেজগুলো মেয়াদোত্তীর্ণ হওয়ার আগেই বাতিল করে দেওয়া সবচেয়ে ভালো। এর সময় নির্ভর করে আপনার এজেন্টের ব্যবহারের ধরনের ওপর। উদাহরণস্বরূপ, আপনি একটি OTP মেসেজ দশ মিনিট পর বাতিল করতে পারেন, কিন্তু একটি প্রচারমূলক মেসেজ একটি নির্দিষ্ট মেয়াদ শেষ হওয়ার তারিখে বাতিল করতে পারেন। সময়মতো মেসেজ ডেলিভারির জন্য, মেসেজগুলো সময়মতো বাতিল করা নিশ্চিত করুন, যাতে আপনি সেগুলো SMS-এর মতো বিকল্প কোনো মাধ্যমে পাঠাতে পারেন।
বার্তা প্রত্যাহার করার দুটি উপায় আছে:
বাতিলকরণ প্রক্রিয়া শুরু করতে একটি বাতিলকরণ অনুরোধ পাঠান । 200 OK প্রতিক্রিয়াটি নিশ্চিত করে যে বার্তাটি বাতিল করা হয়েছে এবং ব্যবহারকারীর কিউ থেকে মুছে ফেলা হয়েছে। 404 Not Found প্রতিক্রিয়ার অর্থ হলো বাতিলকরণের প্রচেষ্টা ব্যর্থ হয়েছে, কারণ বার্তাটি পৌঁছে দেওয়া হয়েছে।
সঠিক সময়ে বার্তাটি স্বয়ংক্রিয়ভাবে বাতিল করার জন্য একটি বার্তা মেয়াদোত্তীর্ণের সময় নির্ধারণ করুন । বার্তাটির মেয়াদ শেষ হয়ে গেলে RBM প্ল্যাটফর্ম আপনার এজেন্টকে অবহিত করে এবং এটি সফলভাবে বাতিল হয়েছে কি না তা নিশ্চিত করে। আরও তথ্যের জন্য সার্ভার-উৎপাদিত ইভেন্টসমূহ দেখুন।
বিরল ক্ষেত্রে প্রত্যাহার ব্যর্থ হতে পারে। উদাহরণস্বরূপ, আপনার এজেন্ট এমন সময়ে একটি বার্তা প্রত্যাহার করার চেষ্টা করতে পারে যখন RBM প্ল্যাটফর্মটি সেটি ডেলিভারি করার প্রক্রিয়ার মধ্যে থাকে। যদি প্রত্যাহার ব্যর্থ হয়, তাহলে আপনার ওয়েবহুকে একটি DELIVERED ইভেন্টের জন্য পরীক্ষা করুন। যদি বার্তাটি ডেলিভারি না হয়ে থাকে, তাহলে আপনি একটি নতুন প্রত্যাহার অনুরোধ পাঠাতে পারেন এবং তারপর সময়মতো ডেলিভারির জন্য বার্তাটি SMS-এর মতো একটি বিকল্প চ্যানেলে পাঠিয়ে দিতে পারেন।
উদাহরণ
নিম্নলিখিত কোডটি একটি প্রত্যাহারের অনুরোধ পাঠায়। ফরম্যাটিং এবং মান সম্পর্কিত তথ্যের জন্য, 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`"
নোড.জেএস
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Stop the message associated with messageId from being delivered rbmApiHelper.revokeMessage('+12223334444', messageId, function(err, response) { console.log(response); });
জাভা
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, "+12223334444"); } catch(Exception e) { e.printStackTrace(); }
পাইথন
# 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('+12223334444', message_id)
সি#
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, "+12223334444");