मैसेज भेजना और पाना, एजेंट और उपयोगकर्ता के बीच बातचीत के मुख्य पहलू हैं. एजेंट, उपयोगकर्ताओं को मैसेज, इवेंट, और अनुरोध एचटीटीपी POST के अनुरोध के ज़रिए आरबीएम एपीआई से भेजते हैं. हालांकि, उपयोगकर्ता के बनाए गए मैसेज और इवेंट को Cloud Pub/Sub से JSON के तौर पर मिलता है.
नीचे बातचीत का एक उदाहरण दिया गया है, जो डेटा का नमूना इस्तेमाल करता है. इस मैसेज से पता चलता है कि मैसेज, इवेंट, और अनुरोध किस तरह से काम के और फ़ायदेमंद इंटरैक्शन कर सकते हैं.
नमस्ते!
इस उदाहरण में, एजेंट उपयोगकर्ता को मैसेज के तौर पर Hello, World!
भेजता है और उपयोगकर्ता Hello to you!
से जवाब देता है.
एजेंट, डिवाइस की जांच करने से जुड़ा अनुरोध भेजता है. इससे यह पुष्टि की जाती है कि उपयोगकर्ता का डिवाइस, आरबीएम के साथ काम करता है या नहीं.
एजेंट ये चीज़ें भेजता है:
GET /v1/phones/+12223334444/capabilities?requestId=147547143069602483572 HTTP/1.1 Host: us-rcsbusinessmessaging.googleapis.com Content-Type: application/json
आरबीएम प्लैटफ़ॉर्म, एजेंट को क्षमता जांच का जवाब भेजता है. इससे पता चलता है कि उपयोगकर्ता के डिवाइस पर आरबीएम मैसेज मिल सकते हैं.
एजेंट को ये चीज़ें मिलती हैं:
{ "rbmEnabled": true, "features": [ "REVOCATION", "RICHCARD_STANDALONE", "RICHCARD_CAROUSEL", "ACTION_CREATE_CALENDAR_EVENT", "ACTION_DIAL", "ACTION_OPEN_URL", "ACTION_SHARE_LOCATION", "ACTION_VIEW_LOCATION" ] }
एजेंट, आरबीएम एपीआई को
Hello, World!
मैसेज भेजता है. इस मैसेज को उपयोगकर्ता के डिवाइस पर भेजा जाता है.एजेंट ये चीज़ें भेजता है:
POST /v1/phones/+12223334444/agentMessages?messageId=123 HTTP/1.1 Host: us-rcsbusinessmessaging.googleapis.com Content-Type: application/json { "contentMessage": { "text": "Hello, World!", } }
आरबीएम प्लैटफ़ॉर्म, उपयोगकर्ता के डिवाइस पर मैसेज भेजता है और एजेंट को
DELIVERED
इवेंट भेजता है.एजेंट को ये चीज़ें मिलती हैं:
{ "senderPhoneNumber": "+12223334444", "eventType": "DELIVERED", "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg", "messageId": "123" }
उपयोगकर्ता अपने डिवाइस पर यह मैसेज खोलता है, जो एजेंट को
READ
इवेंट भेजता है.एजेंट को ये चीज़ें मिलती हैं:
{ "senderPhoneNumber": "+12223334444", "eventType": "READ", "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj", "messageId": "123" }
उपयोगकर्ता, एजेंट का ईमेल लिखता है और जवाब देता है.
एजेंट को ये चीज़ें मिलती हैं:
{ "senderPhoneNumber": "+12223334444", "messageId": "msg000999888777a", "sendTime": "2018-12-31T15:01:23.045123456Z", "text": "Hello to you!", }
जब उपयोगकर्ता का मैसेज मिलता है, तब आरबीएम प्लैटफ़ॉर्म अपने-आप उस उपयोगकर्ता के डिवाइस पर
DELIVERED
इवेंट भेजता है.एजेंट, उपयोगकर्ता को भेजे गए मैसेज के जवाब में
READ
इवेंट भेजता है, ताकि पता चल सके कि यह मैसेज मिल गया है और इसे स्वीकार कर लिया गया है.एजेंट ये चीज़ें भेजता है:
{ "eventType": "READ", "messageId": "msg000999888777a" }