Method: phones.agentMessages.create

एजेंट की ओर से किसी उपयोगकर्ता को मैसेज भेजता है.

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

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

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

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

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

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 में बताया गया है. RBM प्लैटफ़ॉर्म, ऐसे किसी भी एजेंट मैसेज को अनदेखा कर देता है जिसे किसी ऐसे आईडी के साथ भेजा गया हो जिसका इस्तेमाल, उसी एजेंट से भेजे गए किसी पिछले मैसेज या इवेंट में किया गया हो.
agentId

string

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

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

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

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

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

अनुमति के दायरे

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

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

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