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

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

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

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

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

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

उदाहरण

नीचे दिया गया कोड, रद्द करने का अनुरोध भेजता है. फ़ॉर्मैटिंग और वैल्यू की जानकारी के लिए, 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('[phone]', messageId, function(err, response) {
   console.log(response);
});

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

Java

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

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