Merhaba Dünya

Mesaj göndermek ve almak, bir aracı ile kullanıcı arasındaki iletişimin temel unsurlarıdır. Temsilciler, Business Messages API aracılığıyla kullanıcılara mesaj, etkinlik ve istek gönderir, ancak webhook'larında kullanıcı tarafından oluşturulan mesajları ve etkinlikleri JSON olarak alır.

Mesaj, etkinlik ve isteklerin nasıl faydalı ve anlamlı etkileşimler oluşturabileceğini göstermek için örnek verileri kullanan bir örnek görüşme akışını aşağıda bulabilirsiniz.

Bu örnekte, kullanıcı bir sohbet başlatır ve "Merhaba, Dünya!"

1. Kullanıcı, temsilciyle görüşmeyi başlatır.

2. Kullanıcı yanıtı yazmaya başladığında temsilciye bir yazma etkinliği gönderir.

   {
     "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ı, "Merhaba Dünya!" diye mesaj gönderir.

   {
     "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. Müşteri temsilcisi mesaj olarak &Merhaba, Dünya'yı gönderir.

   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 tesliminin ardından kullanıcının cihazı bir teslim makbuzu gönderir.

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