संदेश प्राप्त करना

आरबीएम एजेंट को webहुक पर मौजूद हैं. जब कोई उपयोगकर्ता आपके एजेंट को मैसेज भेजता है, तो Google की आरबीएम सेवा मैसेज, आपके कॉन्फ़िगर किए गए वेबहुक पर भेजा जाएगा. इसके बाद, आपका एजेंट उस मैसेज को डिकोड कर सकता है, उसे प्रोसेस करें और उपयोगकर्ता को जवाब जारी करें.

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

आने वाले मैसेज मैनेज करें

यह बहुत हद तक इस बात पर निर्भर करता है कि आपका एजेंट, लोगों के मैसेज को कैसे मैनेज करता है और उनका जवाब कैसे देता है तय करें. हालांकि, आम तौर पर उपयोगकर्ता को जवाब देने का तरीका में लगातार बदलाव होते रहते हैं.

पहला चरण: यह पता लगाना कि उपयोगकर्ता ने किस तरह का मैसेज भेजा है

उपयोगकर्ता चार तरह के मैसेज भेज सकते हैं:

• मैसेज, फ़्रीफ़ॉर्म जवाब होते हैं.
• सुझाव मैसेज में सुझाई गई कार्रवाई या सुझाया गया जवाब, जिस पर उपयोगकर्ता ने टैप किया हो.

• जगह की जानकारी वाले मैसेज में अक्षांश और देशांतर की वैल्यू शामिल होती हैं.

  चेतावनी: जगह की जानकारी की वैल्यू, उपयोगकर्ता की बताई गई कोई भी जगह हो सकती हैं. उपयोगकर्ता की मौजूदा जगह की जानकारी.

• फ़ाइल मैसेज में, फ़ाइल और उससे जुड़े डेटा का यूआरआई शामिल होता है.

दूसरा चरण: मैसेज के कॉन्टेंट को प्रोसेस करना

उपयोगकर्ता के मैसेज के कॉन्टेंट से, आपके एजेंट के तर्क और अगली प्रतिक्रिया के हिसाब से सही जानकारी मिलनी चाहिए बातचीत में.

उपयोगकर्ता के इंटेंट की पहचान करने का सबसे आसान तरीका है सुझाया गया जवाब या सुझाई गई कार्रवाई. भले ही टेक्स्ट किसी भी शब्द से जुड़ा हो सुझाव है, पोस्टबैक डेटा मशीन से पढ़ने लायक होता है.

अगर कोई उपयोगकर्ता मैसेज भेजता है, तो आपका एजेंट या NLU का इस्तेमाल करें (जैसे, Dialogflow) और उपयोगकर्ता के मैसेज को प्रोसेस करें आगे बढ़ने का रास्ता पहचान सकते हैं.

जगह और फ़ाइल के मैसेज में टेक्स्ट या पोस्टबैक डेटा शामिल नहीं होता, इसलिए आपके एजेंट को बातचीत के संदर्भ और हाल ही के मैसेज को ध्यान में रखना चाहिए देखें.

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

तीसरा चरण: बातचीत के लिए कारोबारी नियम पूरा करना

जब आपका एजेंट उपयोगकर्ता के मैसेज के सही जवाब की पहचान कर लेता है, आपके इन्फ़्रास्ट्रक्चर से ज़रूरी जानकारी इकट्ठा करती है और आपकी मदद करती है के कारोबारी नियम को पूरा करने के लिए, इंटरैक्शन.

चौथा चरण: उपयोगकर्ता को जवाब देना

एजेंट, बातचीत के लिए कारोबारी नियम को पूरा करता है. इसके बाद, यह अनुरोध भेजा जाता है दूसरा मैसेज लिखकर उपयोगकर्ता के साथ बातचीत जारी रखें.

उदाहरण

इस कोड से पता चलता है कि आपके एजेंट को मैसेज कैसे मिलते हैं. फ़ॉर्मैटिंग के लिए और की जानकारी, देखें UserMessage.

एजेंट को मैसेज मिलता है

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "text": "Hello, world!"
}

एजेंट को किसी सुझाव से मैसेज मिलता है

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "suggestionResponse": {
    "postbackData": "suggestion_1",
    "text": "Suggestion #1"
  }
}

एजेंट को एक जगह की जानकारी मिलती है

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "location": {
    "latitude": 37.422000,
    "longitude": -122.084056
  }
}

एजेंट को फ़ाइल मिलती है

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "userFile": {
    "thumbnail": {
      "mimeType": "image/jpeg",
      "fileSizeBytes": 1280,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c8",
      "fileName": "4_animated.jpeg"
    },
    "payload": {
      "mimeType": "image/gif",
      "fileSizeBytes": 127806,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9",
      "fileName": "4_animated.gif"
    }
  }
}

आने वाले इवेंट मैनेज करना

जब आपके एजेंट लोगों को ये मैसेज भेजते हैं, तो उन्हें सूचनाएं मिलती हैं भेजा और पढ़ा.

इस कोड से पता चलता है कि आपके एजेंट को मैसेज कैसे मिलते हैं. फ़ॉर्मैटिंग के लिए और की जानकारी, देखें UserEvent.

उपयोगकर्ता को मैसेज डिलीवर कर दिया गया

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "DELIVERED"
}

उपयोगकर्ता ने मैसेज पढ़ा

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "READ"
}

उपयोगकर्ता टाइप कर रहा है

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "IS_TYPING",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "agentId": "AGENT_ID"
}