इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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 देखें.