Method: phones.agentEvents.create

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
parent

string

"phone/{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 की खास जानकारी देखें.