बातचीत को बेहतर बनाने के लिए इवेंट भेजें और पाएं

Business Messages की बातचीत में, इवेंट की मदद से बातचीत को बेहतर बनाया जाता है उपयोगकर्ताओं और एजेंट, दोनों के अनुभव को बेहतर बनाया जा सकता है. इसके लिए उपयोगकर्ता, इवेंट उनकी बातचीत में सूचनाओं के रूप में दिखते हैं और ट्रिगर होते हैं उपयोगकर्ताओं की ओर से की जाने वाली कार्रवाइयों के आधार पर. एजेंट को वेबहुक और एपीआई कॉल की मदद से इवेंट भेजें.

एजेंट को उपयोगकर्ता के शुरू किए गए इवेंट की जानकारी होनी चाहिए और वे जवाब देने में सक्षम होने चाहिए उसी के हिसाब से. उदाहरण के लिए, अगर कोई उपयोगकर्ता लाइव एजेंट के लिए अनुरोध करता है, लेकिन एजेंट ऐसा नहीं कर सकता अनुरोध का अच्छा या बुरा जवाब देने पर, खराब उपयोगकर्ता हासिल होता है अनुभव.

इवेंट किस तरह के हैं

हर इवेंट किसी खास टाइप का है:

  • लाइव एजेंट के लिए अनुरोध किए गए इवेंट से पता चलता है कि उपयोगकर्ता बोलना चाहता है लाइव एजेंट से कनेक्ट किया जा सकता है.

    अगर एजेंट बातचीत को किसी व्यक्ति के प्रतिनिधि को ट्रांसफ़र कर सकता है, तो कोई रिप्रज़ेंटेटिव शामिल हुआ और उसके बाद के मैसेज हमारे प्रतिनिधि हैं.

    अगर एजेंट, बातचीत को किसी व्यक्ति के प्रतिनिधि से ट्रांसफ़र नहीं कर पाता है, तो उपयोगकर्ता को मैसेज भेजकर बताएं कि लाइव एजेंट कब आएगा उपलब्ध हैं.

  • रिप्रज़ेंटेटिव में शामिल हुआ/बाएं इवेंट से उपयोगकर्ताओं को यह पता चलता है कि लाइव एजेंट कब शामिल हुए हैं या कोई बातचीत छोड़ें. ये इवेंट, बातचीत में सूचनाएं दिखाते हैं साथ ही, इससे उपयोगकर्ता को रिस्पॉन्स मिलने में लगने वाले समय और सवाल पूछे जा सकते हैं.

    प्रतिनिधि शामिल हुआ/बाएं

  • टाइपिंग से जुड़े इवेंट से पता चलता है कि उपयोगकर्ता या एजेंट, मैसेज टाइप कर रहा है.

    उपयोगकर्ताओं के लिए, बूलियन isTyping उनकी टाइपिंग की स्थिति दिखाता है. हर स्टेटस परिवर्तन नया इवेंट ट्रिगर करता है.

    एजेंट, TYPING_STARTED और TYPING_STOPPED इवेंट दिखाने के लिए भेज सकते हैं बातचीत में कुछ टाइपिंग इंडिकेटर. एजेंट के टाइपिंग इवेंट से उपयोगकर्ताओं को पता चलता है कि कोई प्रतिनिधि जवाब दे रहा है या बैकएंड ऑटोमेशन के ज़रिए, उनके सवाल या अनुरोध को प्रोसेस किया जा रहा है.

    टाइपिंग इंडिकेटर

कोई इवेंट भेजें

इवेंट भेजने के लिए, नीचे दिया गया कमांड चलाएं. नीचे दिए गए आइटम बदलें:

  • आपको जो बातचीत चाहिए उसके आइडेंटिफ़ायर के साथ CONVERSATION_ID सर्वे भेजने के लिए
  • इवेंट के यूनीक आइडेंटिफ़ायर वाला EVENT_ID
  • आपके सेवा खाते के पाथ से PATH_TO_SERVICE_ACCOUNT_KEY मशीन पर मौजूद डिजिटल बटन
  • EVENT_TYPE से मान के साथ EventType
  • REPRESENTATIVE_NAME और उपयोगकर्ता को दिखने वाले लाइव एजेंट का नाम या अपने-आप इवेंट बनाने का तरीका
  • REPRESENTATIVE_TYPE से मान के साथ RepresentativeType
curl -X POST "https://businessmessages.googleapis.com/v1/conversations/CONVERSATION_ID/events?eventId=EVENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-messages" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businessmessages`" \
-d "{
  'eventType': 'EVENT_TYPE',
  'representative': {
    'avatarImage': 'REPRESENTATIVE_AVATAR_URL',
    'displayName': 'REPRESENTATIVE_NAME',
    'representativeType': 'REPRESENTATIVE_TYPE',
  },
}"

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें conversations.events.

उदाहरण: किसी प्रतिनिधि को इवेंट में शामिल करना

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at

#     https://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# This code sends a REPRESENTATIVE_JOINED event to the user.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/message/events#send

# Replace the __CONVERSATION_ID__ with a conversation id that you can send messages to
# Make sure a service account key file exists at ./service_account_key.json

curl -X POST "https://businessmessages.googleapis.com/v1/conversations/__CONVERSATION_ID__/events?eventId=6a0af2c6-787d-4097-870d-93fe20351747" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-messages" \
-H "$(oauth2l header --json ./service_account_key.json businessmessages)" \
-d "{
  'eventType': 'REPRESENTATIVE_JOINED',
  'representative': {
    'avatarImage': 'https://developers.google.com/identity/images/g-logo.png',
    'displayName': 'Chatbot',
    'representativeType': 'HUMAN'
  }
}"
send-event-representative-joined.sh

इवेंट पाएं

जब कोई उपयोगकर्ता अपने डिवाइस पर कोई इवेंट ट्रिगर करता है, तो आपके एजेंट को इवेंट इस समय मिलेगा वेबहुक जोड़ सकते हैं. इवेंट को उसी तरह से पाना और प्रोसेस करना जिस तरह पाएं होता है मैसेज.

उपयोगकर्ता की ओर से शुरू किए गए इवेंट का फ़ॉर्मैट इस तरह होता है.

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "requestId": "REQUEST_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "sendTime": "SEND_TIME",
  "userStatus": {
    "isTyping": "BOOLEAN",
    "requestedLiveAgent": "BOOLEAN",
    "createTime": "CREATION_TIME",
  }
}

फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, यह देखें UserMessage.