Görüşme akışları

Mesaj ve etkinlik gönderme ve alma, bir temsilci ile kullanıcı arasındaki iletişimin temel yönüdür. Temsilciler, RBM API'ye HTTP POST istekleri aracılığıyla kullanıcılara mesajlar, etkinlikler ve istekler gönderir, ancak Cloud Pub/Sub'dan kullanıcı tarafından oluşturulan mesajları ve etkinlikleri JSON olarak alır.

Aşağıda, mesajların, etkinliklerin ve isteklerin faydalı ve anlamlı etkileşimler oluşturma şeklini açıklamak için örnek veriler kullanan örnek bir konuşma akışı bulunmaktadır.

Herkese merhaba!

Bu örnekte temsilci, kullanıcıya mesaj olarak Hello, World! gönderir ve kullanıcı Hello to you! ile yanıt verir.

1. Temsilci, kullanıcının cihazının RBM'ye uygun olduğunu doğrulamak için bir yetenek kontrolü isteği gönderir.

   Temsilci şunları gönderir:

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

2. RBM platformu, aracıya kullanıcının cihazının RBM mesajlarını alabileceğini belirten bir özellik kontrolü yanıtı gönderir.

   Temsilci şunları alır:

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

3. Temsilci, Hello, World! mesajını RBM API'ye gönderir. Bu mesaj, mesajı kullanıcının cihazına geçirir.

   Temsilci şunları gönderir:

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

4. RBM platformu, mesajı kullanıcının cihazına ve temsilciye bir DELIVERED etkinliği gönderir.

   Temsilci şunları alır:

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

5. Kullanıcı, cihazında mesajı açtığında temsilciye bir READ etkinliği gönderir.

   Temsilci şunları alır:

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

6. Kullanıcı, temsilciye yanıt yazıp gönderir.

   Temsilci şunları alır:

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

7. RBM platformu, kullanıcının mesajını aldığında kullanıcının cihazına otomatik olarak bir DELIVERED etkinliği gönderir.

8. Temsilci, kullanıcının mesajına yanıt olarak bir READ etkinliği göndererek mesajın alındığını ve onaylandığını bildirir.

   Temsilci şunları gönderir:

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