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

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

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

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

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

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

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

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

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

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

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

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

अगर आपने इंटरैक्टिव Chat ऐप्लिकेशन बनाया है, तो आपको Google Chat API कॉन्फ़िगर करना होगा, ताकि Google Chat आपको इंटरैक्शन इवेंट भेज सके:

  1. Google Cloud Console में, Google Chat API पेज खोलें:

    Google Chat API पेज पर जाएं

  2. कॉन्फ़िगरेशन टैब पर क्लिक करें.
  3. इंटरैक्टिव सुविधाएं सेक्शन में, इंटरैक्टिव सुविधाएं चालू करें टॉगल पर क्लिक करके, सुविधा को चालू करें.
  4. फ़ंक्शनलिटी में, इनमें से एक या दोनों चेकबॉक्स चुनें:
    1. 1:1 मैसेज पाना: इससे उपयोगकर्ता, डायरेक्ट मैसेज (DM) स्पेस में आपके Chat ऐप्लिकेशन से इंटरैक्ट कर पाएंगे. जब भी कोई उपयोगकर्ता DM स्पेस में मैसेज भेजता है, तब आपके Chat ऐप्लिकेशन को इंटरैक्शन से जुड़े इवेंट मिलते हैं.
    2. स्पेस और ग्रुप बातचीत में शामिल हों: इससे उपयोगकर्ता आपके Chat ऐप्लिकेशन को उन स्पेस में जोड़ और हटा सकते हैं जिनमें एक से ज़्यादा लोग हैं. आपके Chat ऐप्लिकेशन को स्पेस में जोड़ने या हटाने पर इंटरैक्शन इवेंट मिलते हैं. साथ ही, जब भी उपयोगकर्ता स्पेस में @नाम में टैग करते हैं या स्लैश कमांड का इस्तेमाल करते हैं.
  5. कनेक्शन की सेटिंग में जाकर, यह तय करें कि Google Chat, Chat ऐप्लिकेशन के साथ हुए इंटरैक्शन के इवेंट कहां भेजे.
  6. ज़रूरी नहीं: स्लैश कमांड में, एक या एक से ज़्यादा स्लैश कमांड जोड़ें और कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, स्लैश कमांड सेट अप करना लेख पढ़ें.
  7. ज़रूरी नहीं: लिंक की झलक में, एक या एक से ज़्यादा ऐसे यूआरएल पैटर्न जोड़ें और कॉन्फ़िगर करें जिनकी झलक आपके Chat ऐप्लिकेशन में होती है. ज़्यादा जानकारी के लिए, झलक के लिंक देखें.
  8. सेव करें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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