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