बातचीत की प्रक्रिया

मैसेज और इवेंट भेजना और पाना, एजेंट और उपयोगकर्ता के बीच बातचीत के मुख्य पहलू हैं. एजेंट, RBM API को एचटीटीपी पोस्ट अनुरोधों के ज़रिए उपयोगकर्ताओं को मैसेज, इवेंट, और अनुरोध भेजते हैं. हालांकि, उपयोगकर्ता के बनाए गए मैसेज और इवेंट, कॉन्फ़िगर किए गए वेबहुक पर मिलते हैं.

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

नमस्ते!

इस उदाहरण में, एजेंट उपयोगकर्ता को मैसेज के तौर पर Hello, World! भेजता है और उपयोगकर्ता Hello to you! के साथ जवाब देता है.

1. एजेंट, इस बात की पुष्टि करने के लिए क्षमता की जांच करने का अनुरोध भेजता है कि उपयोगकर्ता के डिवाइस पर आरबीएम की सुविधा है या नहीं.

   एजेंट यह जानकारी भेजता है:

   GET
   /v1/phones/[phone]/capabilities?requestId=147547143069602483572&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json

2. RBM प्लैटफ़ॉर्म, एजेंट को क्षमता की जांच का जवाब भेजता है. इससे पता चलता है कि उपयोगकर्ता के डिवाइस पर RBM मैसेज मिल सकते हैं.

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

   {
     "rbmEnabled": true,
     "features": [
       "REVOCATION",
       "RICHCARD_STANDALONE",
       "RICHCARD_CAROUSEL",
       "ACTION_CREATE_CALENDAR_EVENT",
       "ACTION_DIAL",
       "ACTION_OPEN_URL",
       "ACTION_SHARE_LOCATION",
       "ACTION_VIEW_LOCATION"
      ]
   }

3. एजेंट, आरबीएम एपीआई को Hello, World! मैसेज भेजता है, जो उसे उपयोगकर्ता के डिवाइस पर भेज देता है.

   एजेंट यह जानकारी भेजता है:

   POST
   /v1/phones/[phone]/agentMessages?messageId=123&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json
   {
     "contentMessage": {
       "text": "Hello, World!",
     }
   }

4. RBM प्लैटफ़ॉर्म, उपयोगकर्ता के डिवाइस पर मैसेज भेजता है और एजेंट को एक DELIVERED इवेंट भेजता है.

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

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "DELIVERED",
     "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg",
     "messageId": "123"
   }

5. उपयोगकर्ता अपने डिवाइस पर मैसेज खोलता है, जिससे एजेंट को READ इवेंट भेजा जाता है.

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

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "READ",
     "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj",
     "messageId": "123"
   }

6. उपयोगकर्ता, एजेंट को जवाब लिखकर भेजता है.

   एजेंट को ये ईमेल मिलते हैं:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "messageId": "msg000999888777a",
     "sendTime": "2018-12-31T15:01:23.045123456Z",
     "text": "Hello to you!",
   }

7. जब RBM प्लैटफ़ॉर्म को उपयोगकर्ता का मैसेज मिलता है, तो वह उपयोगकर्ता के डिवाइस पर DELIVERED इवेंट अपने-आप भेजता है.

8. उपयोगकर्ता के मैसेज के जवाब में, एजेंट READ इवेंट भेजता है. इससे उपयोगकर्ता को यह पता चलता है कि मैसेज मिल गया है और उसे स्वीकार कर लिया गया है.

   एजेंट यह जानकारी भेजता है:

   POST
     /v1/phones/[phone]/agentEvents?eventId=1234&agentId=welcome-bot
     HTTP/1.1
     Host: us-rcsbusinessmessaging.googleapis.com
     Content-Type: application/json
     {
       "eventType": "READ",
       "messageId": "msg000999888777a"
   }