मैसेज निरस्त करना

आपका एजेंट उस मैसेज को वापस ले सकता है जिसे भेजा गया है, लेकिन वह अब तक डिलीवर नहीं हुआ. बेहतर है कि डिलीवर नहीं किए गए मैसेज को पुराने होने से पहले हटा दें. समय इस बात पर निर्भर करता है कि आपका एजेंट किस तरह का है. उदाहरण के लिए, ओटीपी मैसेज को दस मिनट बाद रद्द किया जा सकता है, लेकिन प्रमोशन वाले मैसेज को समयसीमा खत्म होने की तय तारीख पर रद्द किया जा सकता है. समय पर मैसेज डिलीवरी पाने के लिए, मैसेज को समय पर रद्द करना न भूलें, ताकि आप उन्हें एसएमएस जैसे किसी दूसरे रूट से भेज सकें.

किसी मैसेज को वापस लेने के दो तरीके हैं:

• सहमति रद्द करने के लिए, रद्द करने का अनुरोध भेजें. जब आरबीएम प्लैटफ़ॉर्म को रद्द करने का अनुरोध मिलता है, तो प्लैटफ़ॉर्म 200 'OK' दिखाता है. 200 OK जवाब इस बात की पुष्टि नहीं करता कि मैसेज वापस लिया गया था या नहीं. अगर सहमति रद्द हो जाती है, तो आरबीएम प्लैटफ़ॉर्म मैसेज डिलीवर करने की कोशिश करना बंद कर देगा. साथ ही, इसे उपयोगकर्ता की सूची से भी मिटा दिया जाता है.

• सही समय पर मैसेज को अपने-आप वापस लेने के लिए, मैसेज के खत्म होने की तारीख सेट करें. आरबीएम प्लैटफ़ॉर्म, मैसेज की समयसीमा खत्म होने पर आपके एजेंट को इसकी सूचना देता है. साथ ही, यह भी पुष्टि करता है कि मैसेज को वापस लिया गया या नहीं. ज़्यादा जानकारी के लिए, सर्वर से जनरेट किए गए इवेंट देखें.

बहुत कम मामलों में ऐसा हो सकता है कि रद्द होने की प्रोसेस पूरी न हो पाए. उदाहरण के लिए, हो सकता है कि जब आरबीएम प्लैटफ़ॉर्म से मैसेज डिलीवर किया जा रहा हो, तब आपका एजेंट उसे रद्द करने की कोशिश भी कर सकता है. अगर रद्द नहीं हो पाता है, तो अपने वेबहुक पर 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);
});

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

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();
}

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

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)

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

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]");

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.