Gesprächsabläufe

Das Senden und Empfangen von Nachrichten und Ereignissen sind die zentralen Aspekte der Kommunikation zwischen einem Agent und einem Nutzer. Agents senden Nachrichten, Ereignisse und Anfragen über HTTP POST-Anfragen an die RBM API an Nutzer, empfangen vom Nutzer erstellte Nachrichten und Ereignisse jedoch als JSON von Cloud Pub/Sub.

Im Folgenden finden Sie ein Beispiel für einen Unterhaltungsfluss, der anhand von Beispieldaten veranschaulicht, wie Nachrichten, Ereignisse und Anfragen nützliche und sinnvolle Interaktionen ermöglichen können.

Hallo Welt!

In diesem Beispiel sendet der Agent Hello, World! als Nachricht an den Nutzer und der Nutzer antwortet mit Hello to you!.

1. Der Agent sendet eine Anfrage zur Funktionsüberprüfung, um zu prüfen, ob das Gerät des Nutzers RBM-fähig ist.

   Der Agent sendet Folgendes:

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

2. Die RBM-Plattform sendet dem Agent eine Antwort auf die Funktionsprüfung, die angibt, dass das Gerät des Nutzers RBM-Nachrichten empfangen kann.

   Der Agent erhält Folgendes:

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

3. Der Agent sendet die Nachricht Hello, World! an die RBM API, die sie an das Gerät des Nutzers weitergibt.

   Der Agent sendet Folgendes:

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

4. Die RBM-Plattform sendet die Nachricht an das Gerät des Nutzers und sendet ein DELIVERED-Ereignis an den Agent.

   Der Agent erhält Folgendes:

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

5. Der Nutzer öffnet die Nachricht auf seinem Gerät, wodurch ein READ-Ereignis an den Agent gesendet wird.

   Der Agent erhält Folgendes:

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

6. Der Nutzer schreibt und sendet eine Antwort an den Agent.

   Der Agent erhält Folgendes:

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

7. Die RBM-Plattform sendet dem Gerät des Nutzers automatisch ein DELIVERED-Ereignis, wenn es die Nachricht des Nutzers empfängt.

8. Der Agent sendet als Antwort auf die Nachricht des Nutzers ein READ-Ereignis, um ihn darüber zu informieren.

   Der Agent sendet Folgendes:

   {
     "eventType": "READ",
     "messageId": "msg000999888777a"
   }