बॉट से लाइव एजेंट के लिए हैंडऑफ़

जब लोग एजेंट से बातचीत करते हैं, तो उनकी उम्मीदें इस हिसाब से तय होती हैं कि एजेंट कैसे काम करता है खुद को दिखाता है और उन्हें मिलने वाले मैसेज को कौन कंपोज़ करता है. हर बार एजेंट के पास एक मैसेज भेजता है. इससे यह पता चल पाता है कि कोई ऑटोमेटेड (BOT) एजेंट है या लाइव एजेंट (HUMAN) प्रतिनिधित्व संदेश तैयार किया था. उपयोगकर्ताओं को बातचीत में यह जानकारी दिखती है और इससे उपयोगकर्ताओं को यह समझने में मदद मिलती है कि किसी खास समय पर वे किस तरह के इंटरैक्शन की उम्मीद कर सकते हैं पॉइंट.

अगर कोई एजेंट BOT और HUMAN, दोनों प्रतिनिधियों की मदद करता है, तो यह ज़रूरी है कि दोनों के बीच स्विच करते समय संदर्भ उपलब्ध कराएं. BOT से HUMAN प्रतिनिधि, REPRESENTATIVE_JOINED भेजें इवेंट पहले HUMAN प्रतिनिधि से मैसेज भेज रहा है. साथ ही, सभी लेबल को ठीक से लेबल कर सकता है ये मैसेज लाइव एजेंट से मिले हैं. ये मैसेज 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 प्रतिनिधियों को तब तक भेजता है, जब तक कि कोई दूसरा लाइव एजेंट बातचीत में शामिल हुआ.