एजेंट से किसी उपयोगकर्ता को मैसेज भेजता है.
एजेंट मैसेज भेज सके, इसके लिए ज़रूरी है कि उपयोगकर्ता के पास आरसीएस की सुविधा चालू हो और वह आरबीएम प्लैटफ़ॉर्म से ऐक्सेस कर सके. मैसेज भेजने के बाद, बिना किसी गड़बड़ी के कॉल आ जाता है. ऐसा न होने पर, एजेंट को गड़बड़ी का कोड मिलता है.
अगर उपयोगकर्ता ऑनलाइन है, तो आरबीएम प्लैटफ़ॉर्म तुरंत मैसेज डिलीवर करता है. अगर ऐसा नहीं होता है, तो आरबीएम प्लैटफ़ॉर्म उस मैसेज को सूची में जोड़ देता है और उसे तब डिलीवर करता है, जब उपयोगकर्ता अगली बार ऑनलाइन होता है.
आरबीएम प्लैटफ़ॉर्म, किसी आईडी के साथ भेजे गए एजेंट के ऐसे किसी भी मैसेज को अनदेखा करता है जिसका इस्तेमाल उसी एजेंट के भेजे गए किसी पुराने मैसेज या इवेंट में किया गया था.
एजेंट के मैसेज, भेजे जाने के समय और डिलीवर होने के समय के बीच रद्द किए जा सकते हैं.
एचटीटीपी अनुरोध
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
parent |
"phone/{E.164}", जहां {E.164}, E.164 फ़ॉर्मैट में उपयोगकर्ता का फ़ोन नंबर है. उदाहरण के लिए, अमेरिका के फ़ोन नंबर +1-222-333-4444 के साथ, वैल्यू फ़ोन/+12223334444 होगी और उससे मिलने वाला एंडपॉइंट होगा https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
messageId |
मैसेज का यूनीक आईडी, जिसे एजेंट असाइन करता है. यह एक यूयूआईडी होना चाहिए, जैसा कि https://tools.ietf.org/html/rfc4122 में बताया गया है. आरबीएम प्लैटफ़ॉर्म, किसी आईडी के साथ भेजे गए एजेंट के ऐसे किसी भी मैसेज को अनदेखा करता है जिसका इस्तेमाल उसी एजेंट के भेजे गए किसी पुराने मैसेज या इवेंट में किया गया था. |
agentId |
ज़रूरी है. एजेंट का यूनीक आइडेंटिफ़ायर. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में AgentMessage
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में AgentMessage
का नया इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/rcsbusinessmessaging
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.