Method: phones.agentEvents.create

यह एजेंट से उपयोगकर्ता को इवेंट भेजता है.

एजेंट इवेंट का इस्तेमाल यह बताने के लिए किया जा सकता है कि एजेंट ने उपयोगकर्ता का मैसेज पढ़ लिया है या एजेंट टाइप कर रहा है. इससे, RCS for Business के अनुभव में मानवीयता का एहसास होता है. अगर उपयोगकर्ता के डिवाइस पर आरसीएस की सुविधा चालू नहीं है, तो कारोबार के लिए आरसीएस प्लैटफ़ॉर्म, NOT_FOUND (एचटीटीपी 404) गड़बड़ी दिखाता है. अगर उपयोगकर्ता ने आरसीएस सेवा चालू की है, लेकिन फ़िलहाल उससे संपर्क नहीं किया जा सकता, तो प्लैटफ़ॉर्म 200 OK रिस्पॉन्स दिखाता है. साथ ही, इवेंट टाइप के आधार पर मैसेज डिलीवर करता है. एजेंट इवेंट को स्टोर-एंड-फ़ॉरवर्ड क्यू में 30 दिनों तक रखा जाता है. जब उपयोगकर्ता वापस ऑनलाइन आता है, तब इन इवेंट को डिलीवर किया जाता है. सिर्फ़ IS_TYPING इवेंट कुछ समय के लिए उपलब्ध होते हैं और इन्हें लाइन में नहीं लगाया जाता.

एजेंट के मैसेज के उलट, एजेंट के इवेंट भेजने के बाद उन्हें वापस नहीं लिया जा सकता.

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

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

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

पाथ पैरामीटर

पैरामीटर

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

parent

string

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

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

पैरामीटर

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

eventId

string

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

agentId

string

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

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

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

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

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

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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