इस पेज पर बताया गया है कि उपयोगकर्ताओं के सवालों का जवाब देने के लिए, Chat ऐप्लिकेशन डायलॉग बॉक्स कैसे खोल सकता है.
डायलॉग बॉक्स, विंडो वाले और कार्ड पर आधारित इंटरफ़ेस होते हैं. ये चैट स्पेस या मैसेज से खुलते हैं. डायलॉग और उसका कॉन्टेंट सिर्फ़ उस उपयोगकर्ता को दिखता है जिसने उसे खोला है.
चैट ऐप्लिकेशन, डायलॉग बॉक्स का इस्तेमाल करके Chat के उपयोगकर्ताओं से जानकारी का अनुरोध कर सकते हैं और उसे इकट्ठा कर सकते हैं. इसमें कई चरणों वाले फ़ॉर्म भी शामिल हैं. फ़ॉर्म इनपुट बनाने के बारे में ज़्यादा जानकारी के लिए, उपयोगकर्ताओं से जानकारी इकट्ठा करना और उसे प्रोसेस करना देखें.
ज़रूरी शर्तें
Node.js
Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हों. एचटीटीपी सेवा का इस्तेमाल करके, इंटरैक्टिव Chat ऐप्लिकेशन बनाने के लिए, यह क्विकस्टार्ट पूरा करें.
Python
Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हों. एचटीटीपी सेवा का इस्तेमाल करके, इंटरैक्टिव Chat ऐप्लिकेशन बनाने के लिए, यह क्विकस्टार्ट पूरा करें.
Java
Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हों. एचटीटीपी सेवा का इस्तेमाल करके, इंटरैक्टिव Chat ऐप्लिकेशन बनाने के लिए, यह क्विकस्टार्ट पूरा करें.
Apps Script
Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हों. Apps Script में इंटरैक्टिव Chat ऐप्लिकेशन बनाने के लिए, यह शुरुआती लेख पढ़ें.
डायलॉग बॉक्स खोलना
इस सेक्शन में, सवालों के जवाब देने और डायलॉग सेट अप करने का तरीका बताया गया है. इसके लिए, आपको ये काम करने होंगे:
- उपयोगकर्ता के इंटरैक्शन से डायलॉग बॉक्स का अनुरोध ट्रिगर करना.
- डायलॉग बॉक्स खोलकर और उस पर वापस जाकर, अनुरोध को मैनेज करें.
- उपयोगकर्ताओं के जानकारी सबमिट करने के बाद, डायलॉग बॉक्स को बंद करके या कोई दूसरा डायलॉग दिखाकर, सबमिट की गई जानकारी को प्रोसेस करें.
डायलॉग बॉक्स का अनुरोध ट्रिगर करना
Chat ऐप्लिकेशन, उपयोगकर्ता के इंटरैक्शन के जवाब में ही डायलॉग खोल सकता है. जैसे, स्लैश कमांड या कार्ड में मौजूद मैसेज पर बटन दबाने पर.
उपयोगकर्ताओं को डायलॉग बॉक्स के ज़रिए जवाब देने के लिए, चैट ऐप्लिकेशन को ऐसा इंटरैक्शन बनाना होगा जिससे डायलॉग बॉक्स का अनुरोध ट्रिगर हो. जैसे:
- स्लैश कमांड का जवाब देना. स्लैश कमांड से अनुरोध ट्रिगर करने के लिए, कमांड कॉन्फ़िगर करते समय आपको डायलॉग बॉक्स खोलता है चेकबॉक्स को चुनना होगा.
- मैसेज में मौजूद बटन पर क्लिक करने पर, मैसेज के सबसे नीचे या कार्ड में जवाब दें. मैसेज में मौजूद बटन से अनुरोध ट्रिगर करने के लिए, बटन के
onClick
ऐक्शन को कॉन्फ़िगर करें. इसके लिए, बटन केinteraction
कोOPEN_DIALOG
पर सेट करें. - Chat ऐप्लिकेशन के होम पेज पर बटन पर क्लिक करने पर जवाब देना. होम पेजों से डायलॉग खोलने के बारे में जानने के लिए, Google Chat ऐप्लिकेशन के लिए होम पेज बनाना लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कार्ड मैसेज में बटन से डायलॉग बॉक्स का अनुरोध ट्रिगर करने का तरीका बताया गया है. डायलॉग बॉक्स खोलने के लिए, button.interaction
फ़ील्ड को OPEN_DIALOG
पर सेट किया गया है:
Node.js
Python
Java
Apps Script
इस उदाहरण में, कार्ड का JSON दिखाकर कार्ड का मैसेज भेजा जाता है. इसके अलावा, Apps Script की कार्ड सेवा का भी इस्तेमाल किया जा सकता है.
शुरुआती डायलॉग बॉक्स खोलना
जब कोई उपयोगकर्ता डायलॉग अनुरोध ट्रिगर करता है, तो आपके Chat ऐप्लिकेशन को एक इंटरैक्शन इवेंट मिलता है. इसे Chat API में event
टाइप के तौर पर दिखाया जाता है. अगर इंटरैक्शन से डायलॉग का अनुरोध ट्रिगर होता है, तो इवेंट के dialogEventType
फ़ील्ड को REQUEST_DIALOG
पर सेट किया जाता है.
डायलॉग बॉक्स खोलने के लिए, आपका Chat ऐप्लिकेशन, type
को DIALOG
पर सेट करके और Message
ऑब्जेक्ट के साथ actionResponse
ऑब्जेक्ट को दिखाकर, अनुरोध का जवाब दे सकता है. डायलॉग के कॉन्टेंट की जानकारी देने के लिए, ये ऑब्जेक्ट शामिल करें:
actionResponse
ऑब्जेक्ट, जिसकाtype
DIALOG
पर सेट है.dialogAction
ऑब्जेक्ट.body
फ़ील्ड में, कार्ड में दिखाए जाने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट होते हैं. इनमें एक या उससे ज़्यादा विजेटsections
शामिल होते हैं. उपयोगकर्ताओं से जानकारी इकट्ठा करने के लिए, फ़ॉर्म इनपुट विजेट और बटन विजेट तय किए जा सकते हैं. फ़ॉर्म इनपुट डिज़ाइन करने के बारे में ज़्यादा जानने के लिए, उपयोगकर्ताओं से जानकारी इकट्ठा करना और उसे प्रोसेस करना लेख पढ़ें.
नीचे दिए गए कोड सैंपल में बताया गया है कि Chat ऐप्लिकेशन, डायलॉग बॉक्स खोलने वाला जवाब कैसे दिखाता है:
Node.js
Python
Java
Apps Script
इस उदाहरण में, कार्ड का JSON दिखाकर कार्ड का मैसेज भेजा जाता है. इसके अलावा, Apps Script की कार्ड सेवा का भी इस्तेमाल किया जा सकता है.
डायलॉग सबमिशन को मैनेज करना
जब उपयोगकर्ता, डायलॉग सबमिट करने वाले बटन पर क्लिक करते हैं, तो आपके Chat ऐप्लिकेशन को CARD_CLICKED
इंटरैक्शन इवेंट मिलता है. इसमें dialogEventType
की वैल्यू SUBMIT_DIALOG
होती है.
आपके Chat ऐप्लिकेशन को इंटरैक्शन इवेंट को मैनेज करना होगा. इसके लिए, इनमें से कोई एक काम करना होगा:
- किसी दूसरे कार्ड या फ़ॉर्म को पॉप्युलेट करने के लिए, कोई दूसरा डायलॉग दिखाएं.
- उपयोगकर्ता के सबमिट किए गए डेटा की पुष्टि करने के बाद, डायलॉग बॉक्स बंद करें. इसके बाद, पुष्टि करने वाला मैसेज भेजें. हालांकि, ऐसा करना ज़रूरी नहीं है.
ज़रूरी नहीं: कोई दूसरा डायलॉग दिखाना
उपयोगकर्ताओं के शुरुआती डायलॉग सबमिट करने के बाद, Chat ऐप्लिकेशन एक या उससे ज़्यादा डायलॉग दिखा सकते हैं. इससे, उपयोगकर्ताओं को जानकारी सबमिट करने, कई चरणों वाले फ़ॉर्म को पूरा करने या फ़ॉर्म का कॉन्टेंट डाइनैमिक तरीके से भरने से पहले, उसकी समीक्षा करने में मदद मिलती है.
उपयोगकर्ताओं के डाले गए डेटा को प्रोसेस करने के लिए, Chat ऐप्लिकेशन event.common.formInputs
ऑब्जेक्ट का इस्तेमाल करता है. इनपुट विजेट से वैल्यू पाने के बारे में ज़्यादा जानने के लिए, उपयोगकर्ताओं से जानकारी इकट्ठा करना और उसे प्रोसेस करना लेख पढ़ें.
शुरुआती डायलॉग बॉक्स में उपयोगकर्ताओं के डाले गए डेटा को ट्रैक करने के लिए, आपको अगला डायलॉग बॉक्स खोलने वाले बटन में पैरामीटर जोड़ने होंगे. ज़्यादा जानकारी के लिए, किसी दूसरे कार्ड पर डेटा ट्रांसफ़र करना लेख पढ़ें.
इस उदाहरण में, चैट ऐप्लिकेशन एक शुरुआती डायलॉग खोलता है. इसके बाद, सबमिट करने से पहले पुष्टि करने के लिए दूसरा डायलॉग खुलता है:
Node.js
Python
Java
Apps Script
इस उदाहरण में, कार्ड का JSON दिखाकर कार्ड का मैसेज भेजा जाता है. इसके अलावा, Apps Script की कार्ड सेवा का भी इस्तेमाल किया जा सकता है.
डायलॉग बंद करें
जब उपयोगकर्ता किसी डायलॉग बॉक्स में मौजूद बटन पर क्लिक करते हैं, तो आपका Chat ऐप्लिकेशन उससे जुड़ी कार्रवाई करता है. साथ ही, इवेंट ऑब्जेक्ट को यह जानकारी देता है:
eventType
CARD_CLICKED
है.dialogEventType
SUBMIT_DIALOG
है.
Chat ऐप्लिकेशन को एक ऐसा ActionResponse
ऑब्जेक्ट दिखाना चाहिए जिसका type
, DIALOG
और dialogAction
पर सेट हो.
ज़रूरी नहीं: सूचना दिखाना
डायलॉग बॉक्स बंद करने पर, टेक्स्ट सूचना भी दिखाई जा सकती है.
Chat ऐप्लिकेशन, actionStatus
सेट करके ActionResponse
को दिखाकर, कार्रवाई पूरी होने या गड़बड़ी की सूचना दे सकता है.
यहां दिए गए उदाहरण में, यह जांच की जाती है कि पैरामीटर मान्य हैं या नहीं. साथ ही, नतीजे के आधार पर टेक्स्ट सूचना के साथ डायलॉग बॉक्स बंद किया जाता है:
Node.js
Python
Java
Apps Script
इस उदाहरण में, कार्ड का JSON दिखाकर कार्ड का मैसेज भेजा जाता है. इसके अलावा, Apps Script की कार्ड सेवा का भी इस्तेमाल किया जा सकता है.
डायलॉग बॉक्स के बीच पैरामीटर पास करने के बारे में ज़्यादा जानने के लिए, डेटा को किसी दूसरे कार्ड पर ट्रांसफ़र करना लेख पढ़ें.
ज़रूरी नहीं: पुष्टि करने वाला मैसेज भेजना
डायलॉग बॉक्स बंद करने के बाद, नया मैसेज भेजा जा सकता है या मौजूदा मैसेज को अपडेट किया जा सकता है.
नया मैसेज भेजने के लिए, type
को NEW_MESSAGE
पर सेट करके, ActionResponse
ऑब्जेक्ट दिखाएं. इस उदाहरण में, टेक्स्ट सूचना और पुष्टि करने वाले टेक्स्ट मैसेज के साथ डायलॉग बॉक्स बंद किया गया है:
Node.js
Python
Java
Apps Script
इस उदाहरण में, कार्ड का JSON दिखाकर कार्ड का मैसेज भेजा जाता है. इसके अलावा, Apps Script की कार्ड सेवा का भी इस्तेमाल किया जा सकता है.
किसी मैसेज को अपडेट करने के लिए, actionResponse
ऑब्जेक्ट दिखाएं. इसमें अपडेट किया गया मैसेज शामिल होना चाहिए. साथ ही, type
को इनमें से किसी एक पर सेट करें:
UPDATE_MESSAGE
: उस मैसेज को अपडेट करता है जिसकी वजह से डायलॉग बॉक्स का अनुरोध ट्रिगर हुआ.UPDATE_USER_MESSAGE_CARDS
: लिंक की झलक से कार्ड की जानकारी अपडेट करता है.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या कार्ड से कोई गड़बड़ी का मैसेज मिलता है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) पर, गड़बड़ी का कोई मैसेज नहीं दिखता. हालांकि, Chat ऐप्लिकेशन या कार्ड से अनचाहा नतीजा मिल सकता है. उदाहरण के लिए, हो सकता है कि कार्ड का मैसेज न दिखे.
ऐसा हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, Chat ऐप्लिकेशन के लिए गड़बड़ी को लॉग करने की सुविधा चालू होने पर, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होते हैं. इनकी मदद से, गड़बड़ियों को ठीक किया जा सकता है. गड़बड़ियों को देखने, डिबग करने, और ठीक करने में मदद पाने के लिए, Google Chat में गड़बड़ियों को हल करना और उन्हें ठीक करना लेख पढ़ें.
मिलते-जुलते विषय
- संपर्क मैनेजर का सैंपल देखें. यह एक Chat ऐप्लिकेशन है, जो संपर्क जानकारी इकट्ठा करने के लिए डायलॉग का इस्तेमाल करता है.
- Google Chat ऐप्लिकेशन के होम पेज से डायलॉग खोलना.
- स्लैश कमांड सेट अप करना और उनका जवाब देना
- उपयोगकर्ताओं की डाली गई जानकारी को प्रोसेस करना