আপনার এজেন্ট একটি বার্তা প্রত্যাহার করতে পারে যা পাঠানো হয়েছে কিন্তু এখনও বিতরণ করা হয়নি। ডেলিভারি না করা বার্তাগুলি বাসি হয়ে যাওয়ার আগে প্রত্যাহার করা ভাল৷ সময় নির্ভর করে আপনার এজেন্টের ব্যবহারের ক্ষেত্রে। উদাহরণস্বরূপ, আপনি দশ মিনিটের পরে একটি OTP বার্তা প্রত্যাহার করতে পারেন তবে একটি নির্দিষ্ট মেয়াদ শেষ হওয়ার তারিখে একটি প্রচারমূলক বার্তা প্রত্যাহার করতে পারেন৷ সময়মত মেসেজ ডেলিভারির জন্য, SMS এর মত বিকল্প রুটে পাঠানোর জন্য বার্তাগুলিকে সময়মতো প্রত্যাহার করতে ভুলবেন না।
একটি বার্তা প্রত্যাহার করার দুটি উপায় আছে:
প্রত্যাহার ট্রিগার করার জন্য একটি প্রত্যাহার অনুরোধ পাঠান ৷ 200 OK প্রতিক্রিয়া নিশ্চিত করে যে বার্তাটি প্রত্যাহার করা হয়েছে এবং ব্যবহারকারীর সারি থেকে মুছে ফেলা হয়েছে। একটি 404 পাওয়া যায়নি প্রতিক্রিয়া মানে প্রত্যাহার প্রচেষ্টা ব্যর্থ হয়েছে কারণ বার্তাটি বিতরণ করা হয়েছিল৷
উপযুক্ত সময়ে বার্তাটি স্বয়ংক্রিয়ভাবে প্রত্যাহার করতে একটি বার্তার মেয়াদ শেষ করুন । বার্তাটির মেয়াদ শেষ হয়ে গেলে 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`"
Node.js
// 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");