उपयोगकर्ता के इंटरैक्शन की जानकारी पाना और उनका जवाब देना

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

Chat ऐप्लिकेशन के लिए इंटरैक्टिव इंटरफ़ेस बनाने के लिए, इन कॉम्पोनेंट का इस्तेमाल किया जाता है:

• ट्रिगर: Google Chat के उपयोगकर्ता, चैट ऐप्लिकेशन को ट्रिगर कर सकते हैं. जैसे, उसे किसी स्पेस में जोड़ना या उसे कोई मैसेज भेजना.
• इवेंट ऑब्जेक्ट: वह डेटा जो Chat ऐप्लिकेशन को ट्रिगर या यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन से मिलता है.
• कार्रवाइयां: Chat ऐप्लिकेशन, इंटरैक्शन का जवाब देने के लिए कई तरीके इस्तेमाल कर सकते हैं. जैसे, मैसेज भेजना या कार्ड पर आधारित यूज़र इंटरफ़ेस दिखाना.

चैट ऐप्लिकेशन, इन तरीकों से इंटरफ़ेस बना सकते हैं और दिखा सकते हैं:

• मैसेज, जिनमें टेक्स्ट, स्टैटिक या इंटरैक्टिव कार्ड, और ऐक्सेसरी बटन शामिल हो सकते हैं.
• होम पेज (ऐप्लिकेशन होम), जो Chat ऐप्लिकेशन के साथ 1:1 सीधी बातचीत के होम टैब में दिखते हैं.
• डायलॉग, जो नई विंडो में खुलने वाले कार्ड होते हैं. आम तौर पर, ये उपयोगकर्ताओं को जानकारी सबमिट करने के लिए कहते हैं.
• लिंक की झलक, जो किसी बाहरी सेवा के बारे में जानकारी की झलक दिखाने वाले कार्ड होते हैं.

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

• Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट बनाएं.
• ऐसी स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
• Google Chat API को चालू और कॉन्फ़िगर करें.

उपयोगकर्ता के इंटरैक्शन कैसे काम करते हैं

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

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

ट्रिगर

ट्रिगर, वे खास तरीके होते हैं जिनका इस्तेमाल करके, उपयोगकर्ता Chat के यूज़र इंटरफ़ेस (यूआई) से किसी चैट ऐप्लिकेशन को चालू करते हैं. जैसे, @उल्लेख या ऐप्लिकेशन के कमांड का इस्तेमाल करना.

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

इन ट्रिगर के लिए एंडपॉइंट या कॉलबैक फ़ंक्शन कॉन्फ़िगर करने के लिए, Google Cloud Console में Chat API के कॉन्फ़िगरेशन पेज पर जाएं. सिलसिलेवार निर्देश पाने के लिए, Google Chat API को कॉन्फ़िगर करना लेख पढ़ें.

स्टार्टर प्रॉम्प्ट कॉन्फ़िगर करना

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

स्टार्टर प्रॉम्प्ट जोड़ने और उन्हें कॉन्फ़िगर करने के लिए:

1. Google Cloud console में, Chat API के कॉन्फ़िगरेशन पेज पर जाएं:

   Chat API के कॉन्फ़िगरेशन पेज पर जाना

2. इंटरैक्टिव सुविधाएं में जाकर, स्टार्टर प्रॉम्प्ट ढूंढें और प्रॉम्प्ट जोड़ें पर क्लिक करें.

3. रैंक (1-3) फ़ील्ड में, 1 से 3 तक की कोई संख्या डालें, ताकि यह तय किया जा सके कि प्रॉडक्ट किस क्रम में दिखें.

4. टाइप चुनें में जाकर, चुनें कि प्रॉम्प्ट कैसे काम करे:

   • टेक्स्ट प्रॉम्प्ट: जब उपयोगकर्ता प्रॉम्प्ट चिप पर क्लिक करता है, तो लिखने के लिए बार में पहले से तय टेक्स्ट भर जाता है.
   • कमांड प्रॉम्प्ट: क्लिक करने पर, रजिस्टर किया गया स्लैश कमांड या क्विक कमांड चलाता है. ऐसे कमांड नहीं चुने जा सकते जिनके लिए अतिरिक्त आर्ग्युमेंट की ज़रूरत होती है.

5. चुने गए टाइप के आधार पर प्रॉम्प्ट को कॉन्फ़िगर करें:

   • अगर आपने टेक्स्ट प्रॉम्प्ट चुना है:

     1. टाइटल में, चिप पर दिखने वाले प्रॉम्प्ट का टाइटल डालें. इसमें ज़्यादा से ज़्यादा 30 वर्ण हो सकते हैं.
     2. प्रॉम्प्ट टेक्स्ट में, लिखने के लिए बार में मौजूद टेक्स्ट डालें. इसमें ज़्यादा से ज़्यादा 60 वर्ण होने चाहिए.
     3. ज़रूरी नहीं: अन्य भाषाओं का इस्तेमाल करने वाले उपयोगकर्ताओं के लिए, स्थानीय भाषा में टाइटल और टेक्स्ट जोड़ें:
     4. स्थानीय भाषा में प्रॉम्प्ट में जाकर, कोई भाषा जोड़ें पर क्लिक करें.
     5. भाषा में जाकर, ड्रॉप-डाउन से कोई ऐसी भाषा चुनें जो इस्तेमाल की जा सकती है.
     6. स्थानीय भाषा में टाइटल में, स्थानीय भाषा में टाइटल डालें. इसमें ज़्यादा से ज़्यादा 30 वर्ण हो सकते हैं.
     7. Localized Prompt text में, स्थानीय भाषा में प्रॉम्प्ट टेक्स्ट डालें. इसमें ज़्यादा से ज़्यादा 60 वर्ण होने चाहिए.
     8. ज़रूरत के हिसाब से ज़्यादा भाषाएं जोड़ने के लिए, यह तरीका दोहराएं.

   • अगर आपने कमांड प्रॉम्प्ट चुना है:

     1. स्लैश कमांड / क्विक कमांड में जाकर, ड्रॉप-डाउन से कमांड चुनें.

6. हो गया पर क्लिक करें. इसके बाद, पेज पर सबसे नीचे मौजूद सेव करें पर क्लिक करें.

अपनी सेवा के लिए, एचटीटीपी कॉल को फिर से करने की प्रोसेस को मैनेज करना

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

इवेंट ऑब्जेक्ट

Chat ऐप्लिकेशन को इवेंट ऑब्जेक्ट तब मिलते हैं, जब कोई Chat ट्रिगर चलता है या Chat के उपयोगकर्ता, Chat ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) से इंटरैक्ट करते हैं. जैसे, किसी बटन पर क्लिक करना या कोई डायलॉग सबमिट करना. इवेंट ऑब्जेक्ट की मदद से, इंटरैक्शन डेटा का इस्तेमाल करके यूज़र इंटरफ़ेस (यूआई) को अपडेट किया जा सकता है या जवाब दिया जा सकता है.

साल 2025 में, Google Chat ऐप्लिकेशन को ऐड-ऑन इवेंट के साथ काम करने के लिए अपडेट किया गया. जुलाई 2025 से, यह नए Chat ऐप्लिकेशन के लिए डिफ़ॉल्ट तौर पर सेट है. Chat के पूरे दस्तावेज़ में, ऐड-ऑन इवेंट, स्टैंडर्ड इवेंट टाइप होते हैं. इन्हें गाइड और कोड सैंपल में दिखाया जाता है. Chat इवेंट के दस्तावेज़ (ऐसे Chat ऐप्लिकेशन के लिए जो Google Workspace ऐड-ऑन नहीं हैं) को छोटे किए गए सेक्शन में बांटा गया है. उदाहरण के लिए, ऐसे Chat ऐप्लिकेशन जो ऐड-ऑन नहीं हैं: इंटरैक्शन इवेंट पाना और उनका जवाब देना.

{
  "addOns": {
    "chat": {}
  }
}

{
  "chat": {}
}

इवेंट ऑब्जेक्ट पेलोड

ऐड-ऑन के हर इवेंट ऑब्जेक्ट में, होस्ट और प्लैटफ़ॉर्म की जानकारी (hostApp: "CHAT", clientPlatform, userLocale, userTimezone, parameters, और formInputs) के साथ commonEventObject और Chat के हिसाब से कॉन्टेक्स्ट वाला chat ऑब्जेक्ट शामिल होता है:

• ऐप्लिकेशन के होम पेज के ट्रिगर (जब कोई उपयोगकर्ता Chat ऐप्लिकेशन के साथ सीधी बातचीत में होम टैब खोलता है) के लिए, chat ऑब्जेक्ट में chat.user और chat.eventTime शामिल होते हैं. हालांकि, इसमें यूनियन payload फ़ील्ड नहीं होता. जब कोई उपयोगकर्ता होम पेज कार्ड में मौजूद किसी बटन पर क्लिक करता है, तो इवेंट ऑब्जेक्ट में commonEventObject.parameters के साथ chat.buttonClickedPayload शामिल होता है. साथ ही, अगर कार्ड में फ़ॉर्म इनपुट शामिल हैं, तो commonEventObject.formInputs भी शामिल होता है.
• स्पेस और मैसेज इंटरैक्शन (स्पेस में जोड़ा गया, मैसेज, स्पेस से हटाया गया, ऐप्लिकेशन कमांड या बटन और विजेट इंटरैक्शन) के लिए, chat ऑब्जेक्ट में chat.user, chat.space, chat.eventTime, और उससे जुड़ा इंटरैक्शन पेलोड शामिल होता है:
  • messagePayload: जब कोई उपयोगकर्ता मैसेज भेजता है, तो इसमें space, message, और configCompleteRedirectUri शामिल होता है.
  • addedToSpacePayload: इसमें space, interactionAdd, और configCompleteRedirectUri शामिल होते हैं. ऐसा तब होता है, जब चैट ऐप्लिकेशन को किसी स्पेस में जोड़ा जाता है.
  • removedFromSpacePayload: इसमें space शामिल होता है. ऐसा तब होता है, जब चैट ऐप्लिकेशन को किसी स्पेस से हटाया जाता है.
  • buttonClickedPayload: जब कोई उपयोगकर्ता किसी कार्ड या डायलॉग बॉक्स पर मौजूद बटन पर क्लिक करता है, तो इसमें space, message, isDialogEvent, और dialogEventType शामिल होते हैं.
  • widgetUpdatedPayload: इसमें space शामिल होता है. ऐसा तब होता है, जब कोई उपयोगकर्ता किसी विजेट के साथ इंटरैक्ट करता है. जैसे, बाहरी डेटा सोर्स वाले, कई विकल्प चुनने की सुविधा देने वाले मेन्यू में टाइप करना.
  • appCommandPayload: जब कोई उपयोगकर्ता ऐप्लिकेशन के किसी निर्देश को ट्रिगर करता है, तो इसमें space, message, appCommandMetadata, isDialogEvent, dialogEventType, और configCompleteRedirectUri शामिल होते हैं.

Chat और Google Workspace के अन्य ऐप्लिकेशन में, ऐड-ऑन के इवेंट ऑब्जेक्ट के बारे में जानने के लिए, इवेंट ऑब्जेक्ट देखें.

जवाब देना

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

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

उपयोगकर्ता के इंटरैक्शन का तुरंत जवाब देने के लिए, आपका Chat ऐप्लिकेशन, आने वाले इवेंट ऑब्जेक्ट को मैनेज करता है. साथ ही, इनमें से कोई एक JSON ऑब्जेक्ट दिखाता है:

• DataActions: chatDataActionMarkup का इस्तेमाल करके, चैट मैसेज (CreateMessageAction, UpdateMessageAction) बनाता है या अपडेट करता है या लिंक की झलक (UpdateInlinePreviewAction) अटैच करता है.
• RenderActions: यह होम पेज या डायलॉग (pushCard, updateCard, endNavigation: "CLOSE_DIALOG") बनाता है, अपडेट करता है या बंद करता है. इसके अलावा, यह एक से ज़्यादा विकल्प चुनने की सुविधा देने वाले मेन्यू (modifyCard) के लिए, डाइनैमिक इनपुट के सुझाव देता है.
• AuthorizationError: यह उपयोगकर्ताओं को साइन इन करने या किसी बाहरी सेवा की पुष्टि करने के लिए, बुनियादी अनुमति कार्ड (basic_authorization_prompt) दिखाता है.

यहां दी गई टेबल में बताया गया है कि Chat ऐप्लिकेशन, कार्रवाइयों के साथ कैसे जवाब दे सकते हैं. चैट ऐप्लिकेशन, JSON ऑब्जेक्ट को सीधे तौर पर दिखा सकते हैं या Apps Script के AddOnResponseService और CardService का इस्तेमाल करके जवाब बना सकते हैं.

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

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

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

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

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

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

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": <var>MESSAGE</var>
      }
    }
  }
}

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

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

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Chat.
 * @param {Object} res The response object from the Chat app.
 */
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`.'
    }}}}});
  }
};

from flask import Flask, request, json
app = Flask(__name__)

@app.route('/', methods=['POST'])
def cymbal_app():
  """Sends an onboarding message when the Chat app is added to a space.

  Returns:
    Mapping[str, Any]: The response object from the Chat app.
  """
  chat_event = request.get_json()["chat"]
  if "addedToSpacePayload" in chat_event:
    return json.jsonify({ "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`.'
      }}
    }}})

@SpringBootApplication
@RestController
public class App {
  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }

  /*
   * Sends an onboarding message when the Chat app is added to a space.
   *
   * @return The response object from the Chat app.
   */
  @PostMapping("/")
  @ResponseBody
  public GenericJson onEvent(@RequestBody JsonNode event) throws Exception {
    JsonNode chatEvent = event.at("/chat");
    if (!chatEvent.at("/addedToSpacePayload").isEmpty()) {
      return new GenericJson() { {
        put("hostAppDataAction", new GenericJson() { {
          put("chatDataAction", new GenericJson() { {
            put("createMessageAction", new GenericJson() { {
              put("message", new Message().setText(
                "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`."
              ));
            } });
          } });
        } });
      } };
    }
    return new GenericJson();
  }
}

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Google Chat.
 * @return {Object} Response from the Chat app.
 */
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 ऐप्लिकेशन के मैसेज को अपडेट करने के लिए, UpdateMessageAction के साथ DataActions को वापस करें:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "updateMessageAction": {
        "message": <var>MESSAGE</var>
      }
    }
  }
}

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

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

Google Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से जवाब देना

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

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

अगर किसी इंटरैक्शन का जवाब 30 सेकंड के बाद दिया जाता है, तो उपयोगकर्ता को गड़बड़ी का मैसेज दिख सकता है. इसमें बताया जाता है कि आपका चैट ऐप्लिकेशन जवाब नहीं दे रहा है. इससे बचने के लिए, आपको 30 सेकंड के अंदर इवेंट ऑब्जेक्ट मिलने की पुष्टि करनी होगी. इसके लिए, आपको खाली जवाब देना होगा:

async function onEvent(req, res) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return res.send({});
};

def on_event(event) -> dict:
  # Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return {}

public String onEvent(JsonNode event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return "{}";
}

function onEvent(event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return null;
}

Chat API का इस्तेमाल करके मैसेज भेजने के लिए, पुष्टि करने की सुविधा सेट अप करें और spaces.messages.create तरीके को कॉल करें. इसका तरीका जानने के लिए, मैसेज भेजना लेख पढ़ें. Chat API के अन्य तरीकों का इस्तेमाल करने के बारे में जानने के लिए, Chat API की खास जानकारी देखें.

मिलते-जुलते विषय

• Google Chat API को कॉन्फ़िगर करना
• मैसेज भेजें
• निर्देशों का जवाब देना
• इंटरैक्टिव डायलॉग खोलना
• कार्ड पर उपयोगकर्ताओं के डाले गए फ़ॉर्म डेटा को पढ़ना
• लिंक की झलक देखना
• किसी चैट ऐप्लिकेशन के लिए होम पेज बनाना
• Chat से मिले अनुरोधों की पुष्टि करना
• Google Chat ऐप्लिकेशन के लिए, इंटरैक्टिव सुविधाओं की जांच करना

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      '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`.'
    });
  }
};

from flask import Flask, request, json
app = Flask(__name__)

@app.route('/', methods=['POST'])
def cymbal_app():
  """Sends an onboarding message when the Chat app is added to a space.

  Returns:
    Mapping[str, Any]: The response object from the Chat app.
  """
  event = request.get_json()
  if event['type'] == 'ADDED_TO_SPACE':
    return json.jsonify({
      '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`.'
    })
  return json.jsonify({})

@SpringBootApplication
@RestController
public class App {
  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }

  /*
   * Sends an onboarding message when the Chat app is added to a space.
   *
   * @return The response object from the Chat app.
   */
  @PostMapping("/")
  @ResponseBody
  public Message onEvent(@RequestBody JsonNode event) {
    switch (event.get("type").asText()) {
      case "ADDED_TO_SPACE":
        return new Message().setText(
          "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`.");
      default:
        return new Message();
    }
  }
}

/**
 * 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.
 */
function onAddToSpace(event) {
  return {
    '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`.'
  };
}