বট থেকে লাইভ এজেন্ট হ্যান্ডঅফ

যখন ব্যবহারকারীরা এজেন্টদের সাথে যোগাযোগ করেন, তখন তাদের প্রত্যাশা নির্ধারণ করা হয় কিভাবে এজেন্ট নিজেকে উপস্থাপন করে এবং কে তারা প্রাপ্ত বার্তাগুলি রচনা করে। প্রতিবার যখন একজন এজেন্ট একটি বার্তা পাঠায়, এটি একটি স্বয়ংক্রিয় ( BOT ) বা লাইভ এজেন্ট ( HUMAN ) প্রতিনিধি বার্তাটি রচনা করেছে কিনা তা সনাক্ত করতে পারে। ব্যবহারকারীরা কথোপকথনের মধ্যে এই তথ্যটি দেখতে পান এবং এটি ব্যবহারকারীদের বুঝতে সাহায্য করে যে তারা কোন নির্দিষ্ট সময়ে কোন ধরনের মিথস্ক্রিয়া আশা করতে পারে।

যদি কোনো এজেন্ট BOT এবং HUMAN উভয় প্রতিনিধিকে সমর্থন করে, তাহলে উভয়ের মধ্যে পরিবর্তন করার সময় প্রসঙ্গ প্রদান করা গুরুত্বপূর্ণ। একটি BOT থেকে একজন HUMAN প্রতিনিধিতে পরিবর্তন করার সময়, HUMAN প্রতিনিধি থেকে বার্তা পাঠানোর আগে একটি REPRESENTATIVE_JOINED ইভেন্ট পাঠান এবং লাইভ এজেন্টদের থেকে নিম্নলিখিত সমস্ত বার্তাগুলিকে HUMAN প্রতিনিধিদের মতো সঠিকভাবে লেবেল করুন৷ যখন লাইভ এজেন্ট কথোপকথন ছেড়ে চলে যায়, তখন একটি REPRESENTATIVE_LEFT ইভেন্ট পাঠান। এই ফ্রেমিং ইভেন্টগুলি ব্যবহারকারীদের জানায় যে তারা আরও জটিল প্রশ্ন জিজ্ঞাসা করতে পারে এবং আরও ফ্রিফর্ম প্রতিক্রিয়া আশা করতে পারে।

এই কথোপকথনের প্রবাহে, ব্যবহারকারীর প্রথম মিথস্ক্রিয়া একটি স্বয়ংক্রিয় প্রতিক্রিয়াকারীর সাথে হয় যা একটি BOT প্রতিনিধি হিসাবে বার্তা পাঠায়, কিন্তু একটি লাইভ এজেন্ট কথোপকথনে যোগদান করে এবং একটি HUMAN প্রতিনিধি হিসাবে বার্তা পাঠায়। লাইভ এজেন্টের বার্তাগুলি REPRESENTATIVE_JOINED এবং REPRESENTATIVE_LEFT ইভেন্ট দ্বারা ফ্রেম করা হয়৷

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

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "live-agent-handoff",
      "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": "live-agent-handoff",
      "requestId": "123123123",
      "message": {
        "messageId": "4444",
        "name": "conversations/12345/messages/67890",
        "text": "Hi, I have a problem",
        "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. এজেন্ট পাঠায় "আমাদের সাথে যোগাযোগ করার জন্য ধন্যবাদ। আপনার সাথে চ্যাট করার জন্য একজন লাইভ এজেন্ট পাওয়া গেলে আমি এটি পাস করব।" একজন BOT প্রতিনিধির বার্তা হিসাবে।

    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': 'Thanks for contacting us. I'll pass this along when a live agent is available to chat with you.',
      'representative': {
        'avatarImage': 'https://live.agent/bot-avatar.jpg',
        'displayName': 'Hello World Agent',
        'representativeType': 'BOT'
      }
    }"
    
  5. একটি লাইভ এজেন্ট উপলব্ধ হয়.

  6. লাইভ এজেন্ট থেকে প্রথম বার্তা পাঠানোর আগে এজেন্ট একটি REPRESENTATIVE_JOINED ইভেন্ট পাঠায়।

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/12345/events?eventId=6666" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json /path/to/service/account/key.json businessmessages`" \
    -d "{
      'eventType': 'REPRESENTATIVE_JOINED',
      'representative': {
        'avatarImage': 'https://live.agent/human-avatar.jpg',
        'displayName': 'Jane Doe',
        'representativeType': 'HUMAN',
      },
    }"
    
  7. এজেন্ট পাঠায় "আমি দেখছি তোমার সমস্যা আছে। আমি কিভাবে সাহায্য করতে পারি?" একজন HUMAN প্রতিনিধির বার্তা হিসাবে।

    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': '7777',
      'text': 'I see you have a problem. How can I help?',
      'representative': {
        'avatarImage': 'https://live.agent/human-avatar.jpg',
        'displayName': 'Jane Doe',
        'representativeType': 'HUMAN'
      }
    }"
    
  8. ব্যবহারকারীর অনুরোধ পূর্ণ না হওয়া পর্যন্ত লাইভ এজেন্ট এবং ব্যবহারকারী বার্তা বিনিময় করে। লাইভ এজেন্ট দ্বারা রচিত সমস্ত বার্তা একটি HUMAN প্রতিনিধি থেকে পাঠানো হয়।

  9. লাইভ এজেন্ট কথোপকথন ছেড়ে গেলে এজেন্ট একটি REPRESENTATIVE_LEFT ইভেন্ট পাঠায়।

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/12345/events?eventId=6666" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json /path/to/service/account/key.json businessmessages`" \
    -d "{
      'eventType': 'REPRESENTATIVE_LEFT',
      'representative': {
        'avatarImage': 'https://live.agent/human-avatar.jpg',
        'displayName': 'Jane Doe',
        'representativeType': 'HUMAN',
      },
    }"
    
  10. অন্য লাইভ এজেন্ট কথোপকথনে যোগ না দিলে এজেন্ট পরবর্তী সমস্ত বার্তা BOT প্রতিনিধিদের সাথে পাঠায়।