इस पेज पर, Google Chat के साथ काम करने वाले Google Workspace ऐड-ऑन के लिए, यूज़र इंटरफ़ेस (यूआई) बनाने का तरीका बताया गया है.
Google Chat में, ऐड-ऑन उपयोगकर्ताओं को Google Chat ऐप्लिकेशन के तौर पर दिखते हैं. ज़्यादा जानने के लिए, Google Chat का ऐक्सेस देने की सुविधा के बारे में खास जानकारी देखें.
Chat ऐप्लिकेशन के इंटरफ़ेस बनाने के लिए, इन ऐड-ऑन कॉम्पोनेंट का इस्तेमाल किया जाता है:
- ट्रिगर: Google Chat के उपयोगकर्ता, Chat ऐप्लिकेशन को ट्रिगर करने के लिए ये तरीके अपना सकते हैं: उसे स्पेस में जोड़ना या उसे मैसेज भेजना.
- इवेंट ऑब्जेक्ट: वह डेटा जो चैट ऐप्लिकेशन को ट्रिगर या यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन से मिलता है.
- कार्रवाइयां: चैट ऐप्लिकेशन, इंटरैक्शन के जवाब में ये कार्रवाइयां कर सकते हैं. जैसे, मैसेज भेजना या कार्ड पर आधारित यूज़र इंटरफ़ेस दिखाना.
चैट ऐप्लिकेशन, इन इंटरफ़ेस में कार्ड बना और दिखा सकते हैं:
- ऐसे मैसेज जिनमें टेक्स्ट, स्टैटिक या इंटरैक्टिव कार्ड, और बटन शामिल हो सकते हैं.
- डायलॉग, ऐसे कार्ड होते हैं जो नई विंडो में खुलते हैं. आम तौर पर, इनमें उपयोगकर्ताओं से जानकारी सबमिट करने के लिए कहा जाता है.
- लिंक की झलक, जो ऐसे कार्ड होते हैं जिनमें किसी बाहरी सेवा की जानकारी की झलक दिखती है.
ट्रिगर
इस सेक्शन में उन ट्रिगर के बारे में बताया गया है जिनका इस्तेमाल Google Workspace के ऐड-ऑन, Chat में करते हैं.
ट्रिगर, ऐसे खास तरीके होते हैं जिनकी मदद से उपयोगकर्ता, Chat के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके Chat ऐप्लिकेशन को चालू करते हैं. जैसे, @mentions या ऐप्लिकेशन के निर्देशों का इस्तेमाल करना.
नीचे दी गई टेबल में, Chat के ट्रिगर, जानकारी, और आम तौर पर Chat ऐप्लिकेशन के जवाब देने का तरीका बताया गया है:
| ट्रिगर | ब्यौरा | आम तौर पर मिलने वाला जवाब |
|---|---|---|
| स्पेस में जोड़ा गया |
कोई उपयोगकर्ता, Chat ऐप्लिकेशन को किसी स्पेस में जोड़ता है या कोई Google Workspace एडमिन, अपने संगठन के उपयोगकर्ताओं के लिए डायरेक्ट मैसेज स्पेस में Chat ऐप्लिकेशन इंस्टॉल करता है. एडमिन के इंस्टॉल किए गए Chat ऐप्लिकेशन के बारे में जानने के लिए, Google Workspace एडमिन के सहायता दस्तावेज़ में, अपने डोमेन में Marketplace ऐप्लिकेशन इंस्टॉल करना लेख पढ़ें. |
Chat ऐप्लिकेशन, शामिल होने के लिए एक मैसेज भेजता है. इसमें बताया जाता है कि यह ऐप्लिकेशन क्या करता है और स्पेस में मौजूद उपयोगकर्ता इससे कैसे इंटरैक्ट कर सकते हैं. |
| मैसेज |
उपयोगकर्ता, Chat ऐप्लिकेशन में मैसेज के ज़रिए इनमें से किसी एक तरीके से इंटरैक्ट करता है:
|
Chat ऐप्लिकेशन, मैसेज के कॉन्टेंट के आधार पर जवाब देता है. उदाहरण के लिए, Chat ऐप्लिकेशन, स्लैश कमांड /about का जवाब एक मैसेज के साथ देता है. इस मैसेज में, उन टास्क के बारे में बताया जाता है जिन्हें Chat ऐप्लिकेशन पूरा कर सकता है.
|
| स्पेस से हटाया गया |
कोई उपयोगकर्ता, Chat ऐप्लिकेशन को स्पेस से हटाता है या Google Workspace एडमिन, अपने संगठन के किसी उपयोगकर्ता के लिए Chat ऐप्लिकेशन को अनइंस्टॉल करता है. उपयोगकर्ता, उन Chat ऐप्लिकेशन को नहीं हटा सकते जिन्हें उनके एडमिन ने इंस्टॉल किया है. अगर किसी उपयोगकर्ता ने पहले से ही Chat ऐप्लिकेशन इंस्टॉल किया हुआ है, तो Google Workspace एडमिन चाहे भी अनइंस्टॉल करने की कोशिश करे, Chat ऐप्लिकेशन इंस्टॉल रहेगा. |
Chat ऐप्लिकेशन, स्पेस के लिए कॉन्फ़िगर की गई सभी सूचनाएं हटा देता है. जैसे, वेबहुक मिटाना. साथ ही, वह डिवाइस का स्टोरेज भी खाली कर देता है. चैट ऐप्लिकेशन, इस ट्रिगर के लिए मैसेज का जवाब नहीं दे सकते, क्योंकि वे अब स्पेस के सदस्य नहीं हैं. |
| ऐप्लिकेशन कमांड |
कोई उपयोगकर्ता, Chat ऐप्लिकेशन के कमांड का इस्तेमाल करता है. |
Chat ऐप्लिकेशन, निर्देश का जवाब देता है. उदाहरण के लिए, मैसेज का जवाब देना या डायलॉग बॉक्स खोलना. |
Google Workspace के अन्य ऐड-ऑन के उलट, आपको Google Chat API का इस्तेमाल करके, इन ट्रिगर के लिए कोई कॉलबैक फ़ंक्शन कॉन्फ़िगर करना होगा. निर्देशों के लिए, Google Chat ऐप्लिकेशन कॉन्फ़िगर करना लेख पढ़ें.
किसी ट्रिगर का जवाब देने के लिए, ये गाइड देखें:
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat के मैसेज में लिंक की झलक देखना
इवेंट ऑब्जेक्ट
चैट ऐप्लिकेशन को इवेंट ऑब्जेक्ट तब मिलते हैं, जब चैट ट्रिगर ट्रिगर होता है या जब चैट के उपयोगकर्ता, चैट ऐप्लिकेशन के यूज़र इंटरफ़ेस (जैसे, किसी बटन पर क्लिक करना) से इंटरैक्ट करते हैं. इवेंट ऑब्जेक्ट में, इंटरैक्शन का डेटा होता है. Chat ऐप्लिकेशन इसका इस्तेमाल, यूज़र इंटरफ़ेस (यूआई) का जवाब देने या उसे अपडेट करने के लिए कर सकता है.
इवेंट ऑब्जेक्ट को मैनेज करने के बारे में जानने के लिए, ये गाइड देखें:
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat के मैसेज में लिंक की झलक देखना
Chat और Google Workspace के अन्य ऐप्लिकेशन में, ऐड-ऑन इवेंट ऑब्जेक्ट के बारे में जानने के लिए, इवेंट ऑब्जेक्ट लेख पढ़ें.
चैट से जुड़ी कार्रवाइयां
इस सेक्शन में बताया गया है कि उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए, चैट ऐप्लिकेशन ऐड-ऑन ऐक्शन का इस्तेमाल कैसे कर सकते हैं.
ऐड-ऑन ऐक्शन के साथ जवाब देने के लिए, Chat ऐप्लिकेशन को 30 सेकंड के अंदर जवाब देना होगा. साथ ही, जवाब उसी स्पेस में पोस्ट किया जाना चाहिए जहां इंटरैक्शन हुआ था. अगर ऐसा नहीं है, तो Chat ऐप्लिकेशन को पुष्टि करने की सुविधा सेट अप करनी होगी. साथ ही, जवाब देने के लिए Google Chat API को कॉल करना होगा.
चैट ऐप्लिकेशन, इंटरैक्शन को कई तरीकों से मैनेज और उनका जवाब दे सकते हैं. ज़्यादातर मामलों में, Chat ऐप्लिकेशन मैसेज के साथ जवाब देते हैं. चैट ऐप्लिकेशन, डेटा सोर्स से कुछ जानकारी भी खोज सकते हैं. इसके अलावा, वे इवेंट ऑब्जेक्ट की जानकारी या किसी भी अन्य जानकारी को रिकॉर्ड कर सकते हैं. प्रोसेस करने का यह तरीका, Google Chat ऐप्लिकेशन की खास बात है.
उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए, Chat ऐप्लिकेशन को उससे जुड़े इवेंट ऑब्जेक्ट को मैनेज करना होगा और इनमें से कोई एक JSON ऑब्जेक्ट दिखाना होगा:
DataActions: Google Workspace का डेटा बनाता है या अपडेट करता है. चैट मैसेज भेजने या अपडेट करने के लिए, ऑब्जेक्ट में मार्कअप होना चाहिए. इससेMessageडेटा में हुए बदलावों के बारे में पता चलता है. इन बदलावों कोchatDataActionMarkupके तौर पर दिखाया जाता है.RenderActions: डायलॉग बॉक्स बनाएं या अपडेट करें या एक से ज़्यादा विकल्प वाले मेन्यू के लिए इनपुट के सुझाव दें.AuthorizationError: अनुमति कार्ड की मदद से, उपयोगकर्ताओं को Google से बाहर की किसी सेवा में साइन इन करने या पुष्टि करने के लिए कहा जाता है. Chat में, सिर्फ़ अनुमति देने वाला बुनियादी कार्ड इस्तेमाल किया जा सकता है.
| Chat ऐप्लिकेशन का जवाब | सामान लौटाने के लिए ज़रूरी कार्रवाई |
|---|---|
| मैसेज भेजना या अपडेट करना. | DataActions |
| डायलॉग बॉक्स खोलें, अपडेट करें या बंद करें. | RenderActions |
| कार्ड या डायलॉग से जानकारी इकट्ठा करने के लिए, उपयोगकर्ताओं के टाइप किए गए शब्दों के आधार पर, चुनने के लिए आइटम सुझाएं. | RenderActions |
| Chat के उपयोगकर्ताओं के स्पेस में भेजे गए मैसेज में, लिंक की झलक देखें. | DataActions |
Google Chat API का इस्तेमाल करके जवाब देना
ऐड-ऑन ऐक्शन दिखाने के बजाय, हो सकता है कि Chat ऐप्लिकेशन को किसी इंटरैक्शन के जवाब में Google Chat API का इस्तेमाल करना पड़े. उदाहरण के लिए, Chat ऐप्लिकेशन को इनमें से कोई भी काम करने के लिए, Google Chat API को कॉल करना होगा:
- 30 सेकंड के बाद इंटरैक्शन का जवाब देना.
- उस स्पेस से बाहर टास्क करना जहां इंटरैक्शन हुआ था.
- Chat में ऐसे टास्क पूरे करना जो ऐड-ऑन ऐक्शन के तौर पर उपलब्ध नहीं हैं. उदाहरण के लिए, उन स्पेस की सूची बनाना जिनका उपयोगकर्ता या Chat ऐप्लिकेशन सदस्य है या स्पेस में उपयोगकर्ताओं को जोड़ना.
- Chat के उपयोगकर्ता की ओर से टास्क पूरे करना. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.
Chat API की पुष्टि करने और उसे कॉल करने के बारे में जानने के लिए, Chat API की खास जानकारी देखें.
मिलते-जुलते विषय
- Google Workspace ऐड-ऑन के लिए ट्रिगर
- Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना
- इवेंट ऑब्जेक्ट
- ऐड-ऑन की कार्रवाइयां
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat के मैसेज में लिंक की झलक देखना
- Chat API के बारे में खास जानकारी