Method: phones.agentMessages.create

इस फ़ंक्शन का इस्तेमाल करके, एजेंट किसी व्यक्ति को मैसेज भेज सकता है.

एजेंट को मैसेज भेजने के लिए, यह ज़रूरी है कि उपयोगकर्ता के डिवाइस पर आरसीएस की सुविधा चालू हो और वह RCS for Business प्लैटफ़ॉर्म पर उपलब्ध हो. ऐसा न होने पर, एजेंट को 404 गड़बड़ी कोड मिलता है.

अगर उपयोगकर्ता ऑनलाइन है, तो RCS for Business प्लैटफ़ॉर्म तुरंत मैसेज डिलीवर कर देता है. अगर ऐसा नहीं होता है, तो RCS for Business प्लैटफ़ॉर्म मैसेज को लाइन में लगा देता है और जब उपयोगकर्ता अगली बार ऑनलाइन होता है, तब उसे मैसेज डिलीवर कर देता है.

RCS for Business प्लैटफ़ॉर्म, एजेंट के ऐसे मैसेज को अनदेखा कर देता है जिसे भेजने के लिए, उस आईडी का इस्तेमाल किया गया हो जिसका इस्तेमाल उसी एजेंट से भेजे गए किसी पिछले मैसेज या इवेंट के लिए किया गया था.

एजेंट के मैसेज को भेजने और डिलीवर होने के बीच में कभी भी वापस लिया जा सकता है.

एचटीटीपी अनुरोध

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

"phones/{E.164}", जहां {E.164} उपयोगकर्ता का फ़ोन नंबर E.164 फ़ॉर्मैट में है. उदाहरण के लिए, अगर अमेरिका का फ़ोन नंबर +1-222-333-4444 है, तो वैल्यू phones/+12223334444 होगी. साथ ही, नतीजा देने वाला एंडपॉइंट https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages होगा.

क्वेरी पैरामीटर

पैरामीटर
messageId

string

ज़रूरी है. एजेंट की ओर से असाइन किया गया मैसेज का यूनीक आईडी. यह एक यूयूआईडी होना चाहिए, जैसा कि https://tools.ietf.org/html/rfc4122 में बताया गया है. RCS for Business प्लैटफ़ॉर्म, एजेंट के ऐसे मैसेज को अनदेखा कर देता है जिसे भेजने के लिए, उस आईडी का इस्तेमाल किया गया हो जिसका इस्तेमाल उसी एजेंट से भेजे गए किसी पिछले मैसेज या इवेंट के लिए किया गया था.
agentId

string

ज़रूरी है. एजेंट का यूनीक आइडेंटिफ़ायर.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में AgentMessage का उदाहरण है.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में AgentMessage का नया इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.