उपयोगकर्ता के इंटरैक्शन की जानकारी पाना और उनका जवाब देना

इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन कैसे उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए. इसे Google Chat ऐप्लिकेशन भी कहा जाता है इंटरैक्शन इवेंट में शामिल हो सकते हैं.

इस पेज पर, इन कार्रवाइयों को करने का तरीका बताया गया है:

  • इंटरैक्शन पाने के लिए अपने Chat ऐप्लिकेशन को कॉन्फ़िगर करें इवेंट.
  • अपने इन्फ़्रास्ट्रक्चर पर इंटरैक्शन इवेंट प्रोसेस करें.
  • अगर ठीक लगे, तो इंटरैक्शन इवेंट का जवाब दें.

ज़रूरी शर्तें

Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हैं. बनाने के लिए इंटरैक्टिव चैट ऐप्लिकेशन. इनमें से किसी एक क्विकस्टार्ट के आधार पर उसे पूरा करें का इस्तेमाल करें जिसका इस्तेमाल करना है:

इंटरैक्शन इवेंट कैसे काम करते हैं

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

उदाहरण के लिए, चैट ऐप्लिकेशन इनमें से कोई भी काम करने के लिए इंटरैक्शन इवेंट का इस्तेमाल करते हैं फ़ॉलो किया जा रहा है:

इंटरैक्शन इवेंट का उदाहरण Chat ऐप्लिकेशन से मिलने वाला सामान्य जवाब
कोई उपयोगकर्ता किसी चैट ऐप्लिकेशन को शुरू करता है @नाम टैग करना या स्लैश कमांड का इस्तेमाल करना. कॉन्टेंट बनाने Chat ऐप्लिकेशन, मैसेज में बताई गई बातों को प्रोसेस करता है एक मैसेज बनाएं. उदाहरण के लिए, कोई Chat ऐप्लिकेशन, /about कमांड के साथ एक मैसेज, जो उन टास्क के बारे में बताता है चैट ऐप्लिकेशन कर सकता है.
कोई उपयोगकर्ता, Google Chat ऐप्लिकेशन में चैट ऐप्लिकेशन जोड़ता है एक स्पेस. Chat ऐप्लिकेशन, शामिल होने की जानकारी भेजता है मैसेज से पता चलता हो कि स्पेस में क्या-क्या किया जा सकता है और स्पेस के उपयोगकर्ता कैसे इंटरैक्ट कर सकते हैं इसे.
जब कोई उपयोगकर्ता किसी किसी स्पेस में मौजूद चैट ऐप्लिकेशन. कॉन्टेंट बनाने Chat ऐप्लिकेशन, आने वाली किसी भी सूचना को हटा देता है को स्पेस के लिए कॉन्फ़िगर किया गया है (जैसे, किसी फ़ाइल को वेबहुक) और सभी गड़बड़ियों को हटा दें डिवाइस का स्टोरेज.
एक उपयोगकर्ता, उस कार्ड या डायलॉग पर किसी बटन पर क्लिक करता है जो चैट ऐप्लिकेशन. Chat ऐप्लिकेशन, किसी भी डेटा को प्रोसेस और सेव करता है वह डेटा जिसे उपयोगकर्ता ने सबमिट किया है या कोई दूसरा कार्ड या डायलॉग दिखाता है.

हर तरह के उपयोगकर्ता इंटरैक्शन के लिए, Google Chat एक अलग तरह का इंटरैक्शन इवेंट की मदद से, चैट ऐप्लिकेशन इवेंट टाइप के हिसाब से. उदाहरण के लिए, Google Chat, इवेंट टाइप का इस्तेमाल करता है ADDED_TO_SPACE ऐसे किसी भी इंटरैक्शन के लिए जिसमें उपयोगकर्ता जोड़ा जाता है Chat ऐप्लिकेशन को किसी स्पेस में भेजना, ताकि Chat ऐप्लिकेशन किसी जवाब को हैंडल कर सकता है, जैसे कि स्पेस में वेलकम मैसेज. साथ काम करने वाले सभी इंटरैक्शन इवेंट देखने के लिए, EventType रेफ़रंस दस्तावेज़.

Chat ऐप्लिकेशन के साथ हुए इंटरैक्शन के इवेंट पाना

इस सेक्शन में बताया गया है कि अपने चैट ऐप्लिकेशन.

इंटरैक्शन इवेंट पाने के लिए, अपने Chat ऐप्लिकेशन को कॉन्फ़िगर करें

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

आपको जो इंटरैक्टिव सुविधाएं बनानी हैं उनमें से हर एक के लिए, आपको अपडेट करना होगा को Chat API में कॉन्फ़िगर करें, ताकि Google Chat किसी को भी भेज सके Chat ऐप्लिकेशन में होने वाले मिलते-जुलते इंटरैक्शन:

  1. Google Cloud Console में, Chat API पेज पर जाएं और कॉन्फ़िगरेशन पेज:

    Chat API के कॉन्फ़िगरेशन पेज पर जाएं

  2. इंटरैक्टिव सुविधाएं में जाकर, सेटिंग की समीक्षा करें और इनके आधार पर अपडेट करें सुविधाएं जिन्हें आप बनाना चाहते हैं:

    फ़ील्ड ब्यौरा
    फ़ंक्शन ज़रूरी है. फ़ील्ड का सेट, जो तय करता है कि Chat ऐप्लिकेशन, उपयोगकर्ताओं के साथ कैसे इंटरैक्ट कर सकता है:
    • 1:1 मैसेज पाना: उपयोगकर्ता, Google Chat में Chat ऐप्लिकेशन को सीधे ढूंढ सकते हैं और मैसेज भेज सकते हैं.
    • स्पेस और ग्रुप बातचीत में शामिल होना: उपयोगकर्ता, स्पेस और ग्रुप बातचीत में Chat ऐप्लिकेशन को जोड़ सकते हैं.
    कनेक्शन सेटिंग ज़रूरी है. Chat ऐप्लिकेशन का एंडपॉइंट, जो इनमें से एक है:
    • ऐप्लिकेशन यूआरएल: एक एचटीटीपीएस एंडपॉइंट, जो Chat ऐप्लिकेशन को लागू करने की प्रोसेस को होस्ट करता है.
    • Apps Script प्रोजेक्ट: Apps Script प्रोजेक्ट के लिए डिप्लॉयमेंट आईडी, जो Chat ऐप्लिकेशन को लागू करता है.
    • Cloud Pub/Sub विषय का नाम: एक Pub/Sub विषय जिसे चैट ऐप्लिकेशन, एंडपॉइंट के तौर पर सदस्यता लेता है.
    • Dialogflow: यह नीति, Chat ऐप्लिकेशन को Dialogflow इंटिग्रेशन के साथ रजिस्टर करती है. ज़्यादा जानकारी के लिए, Dialogflow Google Chat ऐप्लिकेशन बनाना, जो आम भाषा को समझ सके.
    स्लैश कमांड ज़रूरी नहीं. निर्देश, Google Chat में उपयोगकर्ताओं को दिखाए जा सकते हैं. इससे उपयोगकर्ता, Google Chat में आपके Chat ऐप्लिकेशन में की जाने वाली मुख्य कार्रवाइयां देख सकते हैं. साथ ही, वे कोई खास कार्रवाई चुन सकते हैं जिसमें वे इंटरैक्ट करना चाहते हैं. ज़्यादा जानकारी के लिए, चैट ऐप्लिकेशन के तौर पर स्लैश कमांड का जवाब देना लेख पढ़ें.
    लिंक की झलक ज़रूरी नहीं. यूआरएल पैटर्न, जब उपयोगकर्ता लिंक भेजते हैं, तब Chat ऐप्लिकेशन इन पैटर्न की पहचान करता है और अतिरिक्त कॉन्टेंट उपलब्ध कराता है. ज़्यादा जानकारी के लिए, झलक के लिंक देखें.
    किसको दिखाई दे ज़रूरी नहीं. ज़्यादा से ज़्यादा पांच लोग या एक या एक से ज़्यादा Google ग्रुप, जो आपके Chat ऐप्लिकेशन को देख और इंस्टॉल कर सकते हैं. अपने Chat ऐप्लिकेशन को टेस्ट करने या अपनी टीम के साथ चैट ऐप्लिकेशन शेयर करने के लिए, इस फ़ील्ड का इस्तेमाल करें. ज़्यादा जानकारी के लिए, इंटरैक्टिव सुविधाओं की जांच करना देखें.
  3. सेव करें पर क्लिक करें. Chat ऐप्लिकेशन सेव करने पर कॉन्फ़िगरेशन के लिए, आपका Chat ऐप्लिकेशन आपके Google Workspace संगठन के चुनिंदा उपयोगकर्ता

आपका Chat ऐप्लिकेशन, अब इंटरैक्शन पाने के लिए कॉन्फ़िगर हो गया है Google Chat के इवेंट.

अपनी सेवा के लिए एचटीटीपी कॉल की कोशिशों को मैनेज करना

अगर आपकी सेवा के लिए एचटीटीपीएस अनुरोध पूरा नहीं होता है (जैसे कि टाइम आउट, कुछ समय के लिए नेटवर्क) या नॉन-2xx एचटीटीपीएस स्टेटस कोड वाला कोई कोड नहीं मिलता है, तो Google Chat कुछ मामलों में फिर से डिलीवरी करने की कोशिश कर सकता है बार-बार अपडेट करना होता है (हालांकि, इसकी कोई गारंटी नहीं है). इस वजह से, Chat ऐप्लिकेशन को एक ही मैसेज, कुछ परिस्थितियों में. अगर अनुरोध पूरा हो जाता है, लेकिन अमान्य वैल्यू मैसेज पेलोड के लिए, Google Chat अनुरोध को फिर से भेजने की कोशिश नहीं करता.

इंटरैक्शन इवेंट को प्रोसेस करना या उनका जवाब देना

इस सेक्शन में बताया गया है कि Google Chat ऐप्लिकेशन किस तरह प्रोसेस कर सकते हैं और किस तरह इसका जवाब दे सकते हैं इंटरैक्शन इवेंट.

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

सिंक्रोनस रूप से जवाब देने के लिए, Chat ऐप्लिकेशन को जवाब देना होगा 30 सेकंड के अंदर हो और जवाब उस जगह पर पोस्ट किया जाना चाहिए इंटरैक्शन हुआ. नहीं तो, Chat ऐप्लिकेशन ये काम कर सकता है: एसिंक्रोनस रूप से प्रतिक्रिया दें.

हर इंटरैक्शन इवेंट के लिए, चैट ऐप्लिकेशन को अनुरोध का मुख्य हिस्सा मिलता है, यह इवेंट को दिखाने वाला JSON पेलोड है. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए जानकारी दें, ताकि जवाब को प्रोसेस किया जा सके. इवेंट पेलोड के उदाहरण देखने के लिए, यहां जाएं Chat ऐप्लिकेशन के इंटरैक्शन वाले इवेंट के टाइप.

नीचे दिया गया डायग्राम दिखाता है कि Google Chat ऐप्लिकेशन आम तौर पर, अलग-अलग तरह के मैसेज को प्रोसेस करता है या उनका जवाब देता है इंटरैक्शन इवेंट:

इस बारे में जानकारी कि Google Chat ऐप्लिकेशन, इंटरैक्शन वाले इवेंट को कैसे प्रोसेस करते हैं.

रीयल टाइम में जवाब दिखाएँ

इंटरैक्शन इवेंट की मदद से, चैट ऐप्लिकेशन रीयल टाइम में जवाब दे सकते हैं या सिंक्रोनस का इस्तेमाल करें. सिंक्रोनस जवाबों की ज़रूरत नहीं है पुष्टि करने की सुविधा.

स्पेस में शामिल होने का जवाब देना

इस उदाहरण में, आपका Chat ऐप्लिकेशन, टेक्स्ट बनाकर उसे भेजता है मैसेज दिखता है. सबसे सही तरीकों के बारे में जानने के लिए, उपयोगकर्ताओं को शामिल करते हुए, उपयोगकर्ताओं को अपने Chat ऐप्लिकेशन के बारे में बताएं.

जब कोई उपयोगकर्ता आपका Chat ऐप्लिकेशन जोड़ता है, तो आपको मैसेज भेजने के लिए को स्पेस में, आपके Chat ऐप्लिकेशन को ADDED_TO_SPACE का जवाब देता है इंटरैक्शन इवेंट. जवाब देने के लिए मैसेज वाले ADDED_TO_SPACE इंटरैक्शन इवेंट के लिए, इस कोड का इस्तेमाल करें:

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

कोड सैंपल, नीचे दिया गया टेक्स्ट मैसेज दिखाता है:

शामिल होने के मैसेज का उदाहरण.

इंटरैक्शन पर प्रतिक्रिया देने के अन्य उदाहरण

इंटरैक्शन इवेंट के सिंक्रोनस जवाब बनाने के लिए, यह तरीका देखें गाइड:

एसिंक्रोनस रूप से जवाब दें

कभी-कभी चैट ऐप्लिकेशन को 30 मिनट के बाद इंटरैक्शन इवेंट का जवाब देना पड़ता है सेकंड या उस स्पेस के बाहर टास्क पूरा करना जहां इंटरैक्शन इवेंट था जनरेट किया गया. उदाहरण के लिए, किसी Chat ऐप्लिकेशन के लिए लंबे समय से चल रहे टास्क को पूरा करने के बाद, उपयोगकर्ता को जवाब दें. इस मामले में, Google Chat API को कॉल करके चैट ऐप्लिकेशन एसिंक्रोनस तरीके से जवाब दे सकते हैं.

Chat API का इस्तेमाल करके मैसेज तैयार करने के लिए, यह देखें कोई मैसेज बनाएं. इस्तेमाल करने से जुड़ी गाइड के लिए Chat API का दूसरा तरीका जानने के लिए, Chat API की खास जानकारी.