इस दस्तावेज़ में बताया गया है कि RCS for Business प्लैटफ़ॉर्म, मैसेज भेजने और अन्य एपीआई इंटरैक्शन को कैसे मैनेज करता है. इसमें सिंक्रोनस और असिंक्रोनस ऑपरेशनों के बीच अंतर बताया गया है.
RBM API इंटरैक्शन आम तौर पर, एचटीटीपी लेवल पर सिंक्रोनस अनुरोध-जवाब पैटर्न का पालन करते हैं. हालांकि, कई एपीआई कॉल के नतीजे, खास तौर पर मैसेज डिलीवरी, वेबहुक के ज़रिए एसिंक्रोनस तरीके से हैंडल किए जाते हैं. ज़्यादा जानकारी के लिए, यहां दिए गए सेक्शन देखें.
मैसेज भेजना: सिंक्रोनस अनुरोध, एसिंक्रोनस डिलीवरी
एपीआई के नज़रिए से, phones.agentMessages.create एपीआई अनुरोध को सिंक्रोनस तरीके से प्रोसेस किया जाता है. RCS for Business प्लैटफ़ॉर्म पर एचटीटीपी अनुरोध करने पर, सर्वर तुरंत एक स्टैंडर्ड एचटीटीपी स्टेटस कोड (जैसे कि 200 OK या कोई गड़बड़ी) भेजता है. इससे यह पता चलता है कि अनुरोध मिला है या नहीं और वह मान्य है या नहीं.
हालांकि, असली उपयोगकर्ता को मैसेज डिलीवर करने की प्रोसेस एसिंक्रोनस तरीके से होती है. इस प्रोसेस पर इन बातों का असर पड़ सकता है:
- पाने वाले का स्टेटस: ऐसा हो सकता है कि उपयोगकर्ता ऑफ़लाइन हो, उसके डिवाइस की बैटरी खत्म हो गई हो या उसने आरसीएस की सुविधा चालू न की हो.
- नेटवर्क की स्थिति: मोबाइल और इंटरनेट सेवा देने वाली कंपनी के नेटवर्क से जुड़ी समस्याओं की वजह से, मैसेज डिलीवर होने में देरी हो सकती है या मैसेज डिलीवर नहीं हो सकता.
RCS for Business प्लैटफ़ॉर्म, मैसेज डिलीवर होने की स्थिति के बारे में अपडेट देता है. जैसे, मैसेज डिलीवर होने की सूचना और मैसेज पढ़े जाने की सूचना. ये अपडेट, वेबहुक के ज़रिए एसिंक्रोनस तरीके से मिलते हैं.
इसलिए, एपीआई का शुरुआती अनुरोध सिंक्रोनस होता है. हालांकि, आपको मैसेज डिलीवर होने की स्थिति को ट्रैक करने के लिए, असिंक्रोनस वेबहुक इवेंट का इस्तेमाल करना चाहिए. phones.agentMessages.create से मिले जवाब से, डिलीवरी की स्थिति की तुरंत पुष्टि होने की उम्मीद न रखें.
RBM API के साथ किए गए अन्य इंटरैक्शन
एचटीटीपी पर आधारित ज़्यादातर अन्य RBM API भी, सिंक्रोनस अनुरोध-जवाब मॉडल के साथ काम करते हैं. ये एपीआई, तुरंत एचटीटीपी रिस्पॉन्स देते हैं. इससे अनुरोध की स्थिति (सफल या गड़बड़ी) के बारे में पता चलता है. हालांकि, अनुरोध सिंक्रोनस होता है, लेकिन अनुरोध के बाद की कार्रवाइयों में एसिंक्रोनस प्रोसेस शामिल हो सकती हैं. उदाहरण के लिए, एजेंट की जानकारी अपडेट करने के लिए किए गए एपीआई कॉल का जवाब मिलने का मतलब यह नहीं है कि अपडेट तुरंत हर जगह दिख जाएगा. इसमें कुछ समय लग सकता है.
वेबहुक एंडपॉइंट: एसिंक्रोनस इवेंट
नीचे दिए गए इवेंट, आपके वेबहुक एंडपॉइंट पर एसिंक्रोनस तरीके से डिलीवर किए जाते हैं:
- उपयोगकर्ता के मैसेज: RCS for Business प्लैटफ़ॉर्म, उपयोगकर्ता के मैसेज को आपके वेबहुक एंडपॉइंट पर भेजता है. आने वाले मैसेज की पुष्टि करना न भूलें.
- मैसेज डिलीवर होने और पढ़े जाने की सूचनाएं: मैसेज डिलीवर होने और पढ़े जाने की स्थिति की सूचनाएं, वेबुक के ज़रिए भेजी जाती हैं.
- बातचीत से जुड़े इवेंट: बातचीत से जुड़े कुछ इवेंट, जैसे कि टाइपिंग इंडिकेटर, वेबुक के ज़रिए भेजे जाते हैं.
- मैसेज की समयसीमा खत्म होने और उसे वापस लेने से जुड़े इवेंट: RCS for Business प्लैटफ़ॉर्म, इवेंट भेजता है. इससे यह पुष्टि की जाती है कि समयसीमा खत्म हो चुके मैसेज को वापस लिया गया है या नहीं.