Merhaba,

İletişimin temel unsurları, mesajları ve olayları alıp göndermek arayabileceğim. Aracılar kullanıcılara ileti, etkinlik ve istek gönderir Business Messages API üzerinden kullanıcı tarafından oluşturulan mesajları ve etkinlikleri alıyor web formlarında JSON biçiminde olur.

Aşağıda, Google Analytics 4'te bir programın nasıl çalıştığını göstermek için mesaj, etkinlik ve istekler yararlı ve anlamlı etkileşimler oluşturabilir.

Bu örnekte, kullanıcı bir görüşme başlatır ve "Merhaba, Ben Dünya!", ardından temsilci "Hello, World" ile yanıt verir.

1. Kullanıcı, temsilciyle görüşmeye başlar.

2. Kullanıcı bir yanıt yazmaya başladığında yardımcı olur.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "1234567890",
     "userStatus": {
       "isTyping": "true",
       "createTime": "2020-10-02T15:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T15:01:24.045123456Z",
   }
   

3. Kullanıcı "Hello, I'm World!" gönderir bunu yapabilirsiniz.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "123123123",
     "message": {
       "messageId": "4444",
       "name": "conversations/12345/messages/67890",
       "text": "Hello! I'm World!",
       "createTime": "2020-10-02T15:05:23.045123456Z",
     },
     "context": {
       "entryPoint": "PLACESHEET",
       "userInfo": {
         "displayName": "Michael",
         "userDeviceLocale": "en",
       },
       "resolvedLocale": "en",
     }
     "sendTime": "2020-10-02T15:05:24.045123456Z",
   }
   

4. Temsilci "Hello, World" gönderir bunu yapabilirsiniz.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
   -d "{
       'messageId': '5555',
       'text': 'Hello, World',
       'representative': {
         'avatarImage': 'https://hello.world/avatar.jpg',
         'displayName': 'Hello World Agent',
         'representativeType': 'BOT'
     }
   }"
   

5. İleti teslim edildikten sonra, kullanıcının cihazı bir teslim bilgisi döndürür.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "receipts" : {
       "receipts": [
         {
           "message": "conversations/3333/messages/5555",
           "receiptType": "DELIVERED",
         }
       ],
       "createTime": "2020-10-02T16:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T16:01:24.045123456Z",
   }