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, ADDED_TO_SPACE, और APP_COMMAND इंटरैक्शन इवेंट में configCompleteRedirectUrl फ़ील्ड भी शामिल होता है. आपको इस यूआरएल को अपने कॉन्फ़िगरेशन यूआरएल में कोड करना होगा, ताकि प्रोसेस पूरी होने पर इसका इस्तेमाल किया जा सके. इस यूआरएल पर रीडायरेक्ट करने से, Google Chat को यह सिग्नल मिलता है कि कॉन्फ़िगरेशन का अनुरोध पूरा हो गया है.

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

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

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

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

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

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

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

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

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