Google Chat में मैसेज भेजना

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

Google Chat में, ऐड-ऑन उपयोगकर्ताओं को Google Chat ऐप्लिकेशन के तौर पर दिखते हैं. ज़्यादा जानने के लिए, Google Chat का ऐक्सेस देने की सुविधा के बारे में खास जानकारी देखें.

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

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

Node.js

Google Workspace का एक ऐड-ऑन, जो Google Chat की सुविधाओं को बेहतर बनाता है. इसे बनाने के लिए, एचटीटीपी से जुड़ी शुरुआती जानकारी वाला लेख पढ़ें.

Apps Script

Google Workspace का एक ऐड-ऑन, जो Google Chat की सुविधाओं को बेहतर बनाता है. कोई ऐप्लिकेशन बनाने के लिए, Apps Script का शुरुआती कोर्स पूरा करें.

मैसेज डिज़ाइन करना

चैट ऐप्लिकेशन में मैसेज में इनमें से कोई भी चीज़ शामिल हो सकती है:

  • ऐसा टेक्स्ट जिसमें हाइपरलिंक, @टैग, और इमोजी शामिल हों.
  • एक या उससे ज़्यादा कार्ड, जो किसी मैसेज में दिख सकते हैं या डायलॉग के तौर पर नई विंडो में खुल सकते हैं.
  • एक या उससे ज़्यादा ऐक्सेसरी विजेट, जो मैसेज में किसी टेक्स्ट या कार्ड के बाद दिखने वाले बटन होते हैं.

मैसेज डिज़ाइन करने के बारे में जानने के लिए, Google Chat API से जुड़ा यह दस्तावेज़ देखें:

जवाब के तौर पर मैसेज भेजें

चैट ऐप्लिकेशन, इनमें से किसी भी ट्रिगर या इंटरैक्शन पर मैसेज के साथ जवाब दे सकते हैं:

  • मैसेज ट्रिगर, जैसे कि जब उपयोगकर्ता किसी चैट ऐप्लिकेशन को @टैग करते हैं या उसे डायरेक्ट मैसेज भेजते हैं.
  • स्पेस में जोड़ा गया ट्रिगर, जैसे कि जब उपयोगकर्ता Google Workspace Marketplace से Chat ऐप्लिकेशन इंस्टॉल करते हैं या उसे किसी स्पेस में जोड़ते हैं.
  • मैसेज या डायलॉग में मौजूद कार्ड पर होने वाले क्लिक. उदाहरण के लिए, जब उपयोगकर्ता जानकारी डालते हैं और 'सबमिट करें' पर क्लिक करते हैं.

इसके अलावा, Chat ऐप्लिकेशन Google Chat API को कॉल करके, मैसेज भेज सकते हैं.

मैसेज से जवाब देने के लिए, CreateMessageAction ऑब्जेक्ट के साथ ऐक्शन DataActions दिखाएं:

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

MESSAGE को Chat API के Message संसाधन से बदलें. कार्रवाइयों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Chat में कार्रवाइयां लेख पढ़ें.

नीचे दिए गए उदाहरण में, Chat ऐप्लिकेशन को किसी स्पेस में जोड़ने पर, वह एक टेक्स्ट मैसेज बनाता है और उसे भेजता है. जब कोई उपयोगकर्ता आपके Chat ऐप्लिकेशन को किसी स्पेस में जोड़ता है, तो उसे टेक्स्ट मैसेज भेजने के लिए, आपका Chat ऐप्लिकेशन स्पेस में जोड़ा गया ट्रिगर के जवाब में कार्रवाई DataActions दिखाता है:

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace Add-on.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 *                     introduces the app and helps people get started with it.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  const chatEvent = req.body.chat;
  // Send an onboarding message when added to a Chat space
  if (chatEvent.addedToSpacePayload) {
    res.json({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
      text: 'Hi, Cymbal at your service. I help you manage your calendar' +
            'from Google Chat. Take a look at your schedule today by typing' +
            '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
            'what else I can do, type `/help`.'
    }}}}});
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 *                  introduces the app and helps people get started with it.
 */
function onAddedToSpace(event) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'Hi, Cymbal at your service. I help you manage your calendar' +
          'from Google Chat. Take a look at your schedule today by typing' +
          '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
          'what else I can do, type `/help`.'
  }}}}};
}

कोड सैंपल से यह टेक्स्ट मैसेज मिलता है:

ऑनबोर्डिंग मैसेज का उदाहरण.

मैसेज के ज़रिए जवाब देने के अन्य उदाहरणों के लिए, ये गाइड देखें:

मैसेज अपडेट करना

चैट ऐप्लिकेशन, भेजे गए मैसेज भी अपडेट कर सकते हैं. उदाहरण के लिए, उपयोगकर्ता के डायलॉग सबमिट करने या मैसेज में मौजूद किसी बटन पर क्लिक करने के बाद, मैसेज को अपडेट करने के लिए.

Chat ऐप्लिकेशन के मैसेज को अपडेट करने के लिए, ऐक्शन DataActions को UpdateMessageAction के साथ दिखाएं, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

MESSAGE को Chat API के Message संसाधन से बदलें.

कार्रवाइयों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Chat में कार्रवाइयां लेख पढ़ें.

चैट ऐप्लिकेशन, उपयोगकर्ता के भेजे गए मैसेज को अपडेट भी कर सकते हैं, ताकि भेजे गए लिंक की झलक दिख सके. ज़्यादा जानकारी के लिए, Google Chat मैसेज में लिंक की झलक देखना लेख पढ़ें.

Google Chat API का इस्तेमाल करके, इंटरैक्शन का जवाब देना या पहले से तैयार मैसेज भेजना

ऐड-ऑन ऐक्शन दिखाने के बजाय, हो सकता है कि Chat ऐप्लिकेशन को किसी इंटरैक्शन के जवाब में Google Chat API का इस्तेमाल करना पड़े. उदाहरण के लिए, Chat ऐप्लिकेशन को इनमें से कोई भी काम करने के लिए, Google Chat API को कॉल करना होगा:

  • शेड्यूल के हिसाब से मैसेज भेजना या बाहरी संसाधनों में हुए बदलावों के बारे में मैसेज भेजना. उदाहरण के लिए, किसी नई समस्या या केस के बारे में सूचनाएं.
  • इंटरैक्शन के 30 सेकंड बाद जवाब देना. उदाहरण के लिए, लंबे समय तक चलने वाले टास्क को पूरा करने के बाद, मैसेज से जवाब देना.
  • उस स्पेस से बाहर मैसेज भेजें जहां इंटरैक्शन हुआ था.
  • Chat का इस्तेमाल करने वाले व्यक्ति की ओर से मैसेज भेजना.

Chat API का इस्तेमाल करके मैसेज भेजने के लिए, आपको पुष्टि करने की सुविधा सेट अप करनी होगी और Message संसाधन पर create() तरीका कॉल करना होगा. इसके लिए, Google Chat API का इस्तेमाल करके मैसेज भेजना लेख पढ़ें.