ওহে বিশ্ব

বার্তা এবং ইভেন্টগুলি পাঠানো এবং গ্রহণ করা একটি এজেন্ট এবং ব্যবহারকারীর মধ্যে যোগাযোগের মূল দিক। এজেন্টরা ব্যবসায়িক বার্তা API এর মাধ্যমে ব্যবহারকারীদের বার্তা, ইভেন্ট এবং অনুরোধ পাঠায় কিন্তু JSON হিসাবে তাদের ওয়েবহুকে ব্যবহারকারীর তৈরি বার্তা এবং ইভেন্টগুলি গ্রহণ করে।

নীচে একটি উদাহরণ কথোপকথন প্রবাহ যা বার্তা, ইভেন্ট এবং অনুরোধগুলি কীভাবে দরকারী এবং অর্থপূর্ণ মিথস্ক্রিয়া তৈরি করতে পারে তা বোঝাতে নমুনা ডেটা ব্যবহার করে।

এই উদাহরণে, ব্যবহারকারী একটি কথোপকথন শুরু করে এবং "হ্যালো, আমি বিশ্ব!" বার্তা পাঠায়, তারপর এজেন্ট "হ্যালো, ওয়ার্ল্ড" দিয়ে প্রতিক্রিয়া জানায়।

1. ব্যবহারকারী এজেন্টের সাথে কথোপকথন শুরু করে।

2. একবার ব্যবহারকারী একটি প্রতিক্রিয়া টাইপ করা শুরু করলে, তারা এজেন্টকে একটি টাইপিং ইভেন্ট পাঠায়।

   {
     "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. ব্যবহারকারী পাঠায় "হ্যালো, আমি বিশ্ব!" একটি বার্তা হিসাবে

   {
     "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. এজেন্ট একটি বার্তা হিসাবে "হ্যালো, ওয়ার্ল্ড" পাঠায়।

   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. বার্তা বিতরণের পরে, ব্যবহারকারীর ডিভাইস একটি বিতরণ রসিদ ফেরত দেয়।

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