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 verilerin kullanıldığı bir sohbet akışı örneği verilmiştir.

Merhaba Dünya!

Bu örnekte, aracı kullanıcıya mesaj olarak Hello, World! mesajını, kullanıcı ise 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 ş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. 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çtığında temsilciye bir READ etkinliği gönderilir.

   Temsilci şu bilgileri alır:

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

6. Kullanıcı, temsilciye bir yanıt yazar ve yanıt gönderir.

   Temsilci şunları 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"
   }