Chat ऐप्लिकेशन को अन्य सेवाओं और टूल से जोड़ना

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

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

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

किसी उपयोगकर्ता से Chat ऐप्लिकेशन के कॉन्फ़िगरेशन का अनुरोध करना

अगर किसी अनुरोध को पूरा करने के लिए, ऐसा अतिरिक्त कॉन्फ़िगरेशन ज़रूरी है जिसे सीधे Chat ऐप्लिकेशन में पूरा नहीं किया जा सकता, तो सामान्य जवाब के हिस्से के तौर पर उपयोगकर्ता को कॉन्फ़िगरेशन यूआरएल दें या उसे निजी तौर पर, इस फ़ॉर्म में दिखाएं:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

इससे Google Chat को उपयोगकर्ता को निजी प्रॉम्प्ट दिखाने के लिए कहा जाता है. इसमें CONFIGURATION_URL एक लिंक होता है, जिस पर उपयोगकर्ता को पुष्टि करने, अनुमति देने या कॉन्फ़िगरेशन के लिए जाना होता है. REQUEST_CONFIG जवाब, सामान्य जवाब वाले मैसेज से अलग होता है. किसी भी टेक्स्ट, कार्ड या अन्य एट्रिब्यूट को अनदेखा कर दिया जाता है.

कॉन्फ़िगरेशन का अनुरोध पूरा करना

आपके Chat ऐप्लिकेशन को मिलने वाले हर MESSAGE इंटरैक्शन इवेंट में, फ़ील्ड configCompleteRedirectUrl भी शामिल होता है. आपको इस यूआरएल को अपने कॉन्फ़िगरेशन यूआरएल में कोड में बदलना होगा, ताकि प्रोसेस पूरी होने पर इसका इस्तेमाल किया जा सके. इस यूआरएल पर रीडायरेक्ट करने से, Google Chat को यह सिग्नल मिलता है कि कॉन्फ़िगरेशन का अनुरोध पूरा हो गया है.

Chat ऐप्लिकेशन शुरू होने पर, फ़्लो उस मैसेज पर निर्भर करता है जो आपको मिला है. @app help जैसे मैसेज के जवाब में, चैट ऐप्लिकेशन को मैसेज के साथ जवाब देना चाहिए. इसके लिए, उसे अलग से कॉन्फ़िगरेशन की ज़रूरत नहीं होती.

जब किसी उपयोगकर्ता को ओरिजनल मैसेज में दिए गए configCompleteRedirectUrl पर रीडायरेक्ट किया जाता है, तो Google Chat ये कार्रवाइयां करता है:

  1. उस प्रॉम्प्ट को मिटाएं जो शुरुआत करने वाले उपयोगकर्ता को दिखाया गया था.
  2. ओरिजनल मैसेज को सार्वजनिक करें, ताकि वह स्पेस के अन्य सदस्यों को दिख सके.
  3. उसी Chat ऐप्लिकेशन पर, ओरिजनल मैसेज को फिर से भेजें.

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

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

Chat के बाहर Chat इस्तेमाल करने वाले व्यक्ति की पुष्टि करना

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

उपयोगकर्ता आईडी पाने के लिए, साइन इन के दौरान जारी किए गए आइडेंटिटी टोकन का इस्तेमाल करें. sub दावे में उपयोगकर्ता का यूनीक आईडी होता है. साथ ही, इसे Google Chat के उपयोगकर्ता आईडी से जोड़ा जा सकता है.

हालांकि, दोनों आईडी एक जैसे नहीं हैं, लेकिन उन्हें एक जैसा बनाया जा सकता है. sub दावे की वैल्यू को Google Chat users/{user} में बदलने के लिए, वैल्यू के आगे users/ जोड़ें. उदाहरण के लिए, 123 की दावा वैल्यू, आपके Chat ऐप्लिकेशन में मैसेज में मौजूद उपयोगकर्ता नाम users/123 के बराबर होती है.