Method: phones.agentEvents.create

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

एजेंट इवेंट का इस्तेमाल यह बताने के लिए किया जा सकता है कि एजेंट ने उपयोगकर्ता का मैसेज पढ़ लिया है या एजेंट टाइप करने की प्रोसेस में है (इससे आरबीएम अनुभव में एक मैन्युअल एलिमेंट जुड़ जाता है). अगर आरबीएम, उपयोगकर्ता तक नहीं पहुंच पा रहा है, तो आरबीएम प्लैटफ़ॉर्म 404 NOT_FOUND दिखाता है.

एजेंट के मैसेज से अलग, एजेंट को भेजे जाने के बाद इवेंट रद्द नहीं किए जा सकते.

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

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

पैरामीटर
eventId

string

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

string

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

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

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

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

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

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

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

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

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