Method: phones.agentEvents.create

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

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

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

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

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 होगा.

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

पैरामीटर
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 देखें.