Görüşme akışları

Mesaj ve etkinlik gönderip alma, temsilci ile kullanıcı arasındaki iletişimin temel yönleridir. Temsilciler, RBM API'ye HTTP POST istekleri göndererek kullanıcılara mesaj, etkinlik ve istek gönderir ancak kullanıcı tarafından oluşturulan mesajları ve etkinlikleri yapılandırılmış webhook'da alır.

Aşağıda, mesajların, etkinliklerin ve isteklerin nasıl yararlı ve anlamlı etkileşimler oluşturabileceğini göstermek için örnek veriler kullanılan bir sohbet akışı örneği verilmiştir.

Merhaba Dünya!

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 özellikli olduğunu doğrulamak için bir özellik kontrolü isteği gönderir.

   Temsilci şunları gönderir:

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

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

   Temsilci şu bilgileri 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. RBM API, mesajı kullanıcının cihazına iletir.

   Temsilci şunları gönderir:

   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 platformu, mesajı kullanıcının cihazına gönderir ve temsilciye bir DELIVERED etkinliği gönderir.

   Temsilci şu bilgileri alır:

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

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

   Temsilci şu bilgileri alır:

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

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

   Temsilci şu bilgileri alır:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "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 READ etkinliği göndererek mesajın alındığını ve onaylandığını bildirir.

   Temsilci şunları gönderir:

   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"
   }