Google Chat ऐप्लिकेशन के तौर पर, स्लैश कमांड का जवाब देना

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

स्लैश कमांड, Chat ऐप्लिकेशन को इस्तेमाल करने का एक सामान्य तरीका है. इसकी मदद से, उपयोगकर्ता Chat ऐप्लिकेशन को खोल सकते हैं और उससे इंटरैक्ट कर सकते हैं. साथ ही, स्लैश कमांड की मदद से, उपयोगकर्ता Chat ऐप्लिकेशन की मुख्य सुविधाओं को खोज सकते हैं और उनका इस्तेमाल कर सकते हैं.

स्लैश कमांड का इस्तेमाल करने के लिए, उपयोगकर्ता स्लैश (/) और फिर एक छोटा टेक्स्ट कमांड टाइप करते हैं. जैसे, Chat ऐप्लिकेशन के बारे में जानकारी पाने के लिए /about. उपयोगकर्ता, Google Chat में स्लैश टाइप करके, उपलब्ध स्लैश कमांड देख सकते हैं. इससे एक विंडो खुलती है, जिसमें Chat ऐप्लिकेशन के लिए उपलब्ध कमांड की सूची दिखती है:

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

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

निजी जवाबों के साथ स्लैश कमांड

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

उदाहरण के लिए, अगर उपयोगकर्ता को किसी स्पेस में कोई Chat ऐप्लिकेशन दिखता है, तो उसके बारे में जानने के लिए वह /about या /help जैसे निर्देशों का इस्तेमाल कर सकता है. स्पेस में मौजूद सभी लोगों को सूचना न देने के लिए, Chat ऐप्लिकेशन निजी तौर पर जवाब दे सकता है. इसमें, Chat ऐप्लिकेशन को इस्तेमाल करने और सहायता पाने के तरीके के बारे में जानकारी दी जा सकती है.

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

ध्यान दें: इस गाइड में दिए गए कोड सैंपल, Node.js, Python, और Java के लिए Google Cloud फ़ंक्शन के तौर पर चलाए जाने के लिए लिखे गए हैं.

Node.js

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

Apps Script

Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हों. Apps Script में इंटरैक्टिव Chat ऐप्लिकेशन बनाने के लिए, यह शुरुआती लेख पढ़ें.

Python

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

Java

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

स्लैश कमांड सेट अप करना

इस सेक्शन में, स्लैश कमांड सेट अप करने के लिए, नीचे दिए गए चरणों को पूरा करने का तरीका बताया गया है:

1. अपने स्लैश कमांड के लिए कोई नाम बनाएं.
2. Google Chat API में स्लैश कमांड कॉन्फ़िगर करें.

अपने स्लैश कमांड को नाम दें

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

दूसरी इमेज: स्लैश कमांड का नाम और ब्यौरा.

स्लैश कमांड के लिए नाम और ब्यौरा चुनते समय, इन सुझावों का ध्यान रखें:

• स्लैश कमांड को नाम देने के लिए:

  • उपयोगकर्ता के लिए निर्देशों को साफ़ और आसान बनाने के लिए, छोटे, जानकारी देने वाले, और कार्रवाई करने वाले शब्दों या वाक्यांशों का इस्तेमाल करें. उदाहरण के लिए, /createAReminder के बजाय /remindMe का इस्तेमाल करें.
  • अगर आपके निर्देश में एक से ज़्यादा शब्द हैं, तो उपयोगकर्ताओं को निर्देश पढ़ने में मदद करें. इसके लिए, पहले शब्द के लिए सभी छोटे अक्षरों का इस्तेमाल करें और फिर बाकी शब्दों के पहले अक्षर को कैपिटल लेटर में लिखें. उदाहरण के लिए, /updatecontact के बजाय, /updateContact का इस्तेमाल करें.
  • यह तय करें कि आपको अपने निर्देश के लिए कोई यूनीक नाम इस्तेमाल करना है या कोई सामान्य नाम. अगर आपके निर्देश में किसी सामान्य इंटरैक्शन या सुविधा के बारे में बताया गया है, तो किसी ऐसे सामान्य नाम का इस्तेमाल किया जा सकता है जिसे उपयोगकर्ता पहचानते हों और जिसकी उम्मीद करते हों. जैसे, /settings या /feedback. इसके अलावा, निर्देशों के लिए यूनीक नाम इस्तेमाल करें. ऐसा इसलिए, क्योंकि अगर आपके निर्देश का नाम, चैट के दूसरे ऐप्लिकेशन के निर्देशों के नाम से मेल खाता है, तो उपयोगकर्ता को आपके निर्देश को ढूंढने और इस्तेमाल करने के लिए, मिलते-जुलते निर्देशों को फ़िल्टर करना होगा.

• अपने स्लैश कमांड के बारे में बताने के लिए:

  • जानकारी को कम और साफ़ शब्दों में रखें, ताकि उपयोगकर्ताओं को यह पता रहे कि कमांड का इस्तेमाल करने पर क्या होगा.
  • उपयोगकर्ताओं को बताएं कि कमांड के लिए फ़ॉर्मैट करने से जुड़ी कोई ज़रूरी शर्त है या नहीं. उदाहरण के लिए, अगर आपने ऐसा /remindMe निर्देश बनाया है जिसके लिए आर्ग्युमेंट टेक्स्ट की ज़रूरत है, तो ब्यौरे को Remind me to do [something] at [time] जैसा सेट करें.
  • उपयोगकर्ताओं को बताएं कि Chat ऐप्लिकेशन, स्पेस में मौजूद सभी लोगों को जवाब देता है या सिर्फ़ उस व्यक्ति को जवाब देता है जिसने निर्देश दिया है. उदाहरण के लिए, स्लैश कमांड /about के लिए, इसे Learn about this app (Only visible to you) के तौर पर दिखाया जा सकता है.

Google Chat API में स्लैश कमांड कॉन्फ़िगर करना

स्लैश कमांड बनाने के लिए, आपको Google Chat API के लिए अपने Chat ऐप्लिकेशन के कॉन्फ़िगरेशन में कमांड के बारे में जानकारी देनी होगी.

Google Chat API में स्लैश कमांड कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

1. Google Cloud कंसोल में, मेन्यू > एपीआई और सेवाएं > चालू किए गए एपीआई और सेवाएं > Google Chat API पर क्लिक करें

   Google Chat API पेज पर जाएं

2. कॉन्फ़िगरेशन पर क्लिक करें.

3. स्लैश कमांड में जाकर, स्लैश कमांड जोड़ें पर क्लिक करें.

4. निर्देश का नाम, निर्देश आईडी, और जानकारी डालें:

   1. नाम: यह कमांड का डिसप्ले नेम होता है. साथ ही, यह वह नाम होता है जिसे उपयोगकर्ता आपके ऐप्लिकेशन को चालू करने के लिए टाइप करते हैं. यह स्लैश से शुरू होना चाहिए. इसमें सिर्फ़ टेक्स्ट होना चाहिए और इसमें 50 वर्ण हो सकते हैं.
   2. जानकारी: यह टेक्स्ट, निर्देश को इस्तेमाल और फ़ॉर्मैट करने का तरीका बताता है. ब्यौरे में ज़्यादा से ज़्यादा 50 वर्ण हो सकते हैं.
   3. कमांड आईडी: यह एक संख्या होती है, जो 1 से 1,000 के बीच होती है. इसका इस्तेमाल, आपके Chat ऐप्लिकेशन में स्लैश कमांड की पहचान करने और जवाब देने के लिए किया जाता है.

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

6. सेव करें पर क्लिक करें.

स्लैश कमांड अब Chat ऐप्लिकेशन के लिए कॉन्फ़िगर हो गया है.

स्लैश कमांड का जवाब देना

ज़्यादा उदाहरणों के लिए, Google Chat ऐप्लिकेशन के सैंपल देखें.

जब उपयोगकर्ता, Chat में कोई ऐसा मैसेज बनाते हैं जिसमें स्लैश कमांड शामिल होता है, तो आपके Chat ऐप्लिकेशन को MESSAGE इंटरैक्शन इवेंट मिलता है. इवेंट पेलोड में slashCommand और slashCommandMetadata ऑब्जेक्ट शामिल होते हैं. इन ऑब्जेक्ट में, मैसेज में इस्तेमाल किए गए कमांड के बारे में जानकारी होती है. इसमें कमांड आईडी भी शामिल होता है, ताकि आप सही जवाब दे सकें.

Chat ऐप्लिकेशन, स्लैश कमांड /help का इस्तेमाल करके, सहायता पाने का तरीका बताने के लिए निजी तौर पर जवाब देता है.

नीचे दिए गए कोड में, Chat ऐप्लिकेशन का एक उदाहरण दिया गया है. यह ऐप्लिकेशन, MESSAGE इंटरैक्शन इवेंट को मैनेज करके, /about स्लैश कमांड का जवाब देता है. साथ ही, यह पता लगाता है कि मैसेज में मैच होने वाला कमांड आईडी है या नहीं. अगर मैसेज में कमांड आईडी शामिल है, तो Chat ऐप्लिकेशन एक निजी मैसेज दिखाता है:

Node.js

node/avatar-app/index.js

GitHub पर देखना

/**
 * Handles slash and quick commands.
 *
 * @param {Object} event - The Google Chat event.
 * @param {Object} res - The HTTP response object.
 */
function handleAppCommands(event, res) {
  const {appCommandId, appCommandType} = event.appCommandMetadata;

  switch (appCommandId) {
    case ABOUT_COMMAND_ID:
      return res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
    case HELP_COMMAND_ID:
      return res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
  }
}

Apps Script

apps-script/avatar-app/avatar-app.gs

GitHub पर देखना

// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

Python

python/avatar-app/main.py

GitHub पर देखना

def handle_app_commands(event: Mapping[str, Any]) -> Mapping[str, Any]:
    """Handles slash and quick commands.

    Args:
        Mapping[str, Any] event: The Google Chat event.

    Returns:
        Mapping[str, Any]: the response
    """
    app_command_id = event["appCommandMetadata"]["appCommandId"]

    if app_command_id == ABOUT_COMMAND_ID:
        return {
            "privateMessageViewer": event["user"],
            "text": "The Avatar app replies to Google Chat messages.",
        }
    elif app_command_id == HELP_COMMAND_ID:
        return {
            "privateMessageViewer": event["user"],
            "text": "The Avatar app replies to Google Chat messages.",
        }
    return {}

Java

java/avatar-app/src/main/java/AvatarApp.java

GitHub पर देखना

/**
 * Handles slash and quick commands.
 *
 * @param event    The Google Chat event.
 * @param response The HTTP response object.
 */
private void handleAppCommands(JsonObject event, HttpResponse response) throws Exception {
  int appCommandId = event.getAsJsonObject("appCommandMetadata").get("appCommandId").getAsInt();

  switch (appCommandId) {
    case ABOUT_COMMAND_ID:
      Message aboutMessage = new Message();
      aboutMessage.setText("The Avatar app replies to Google Chat messages.");
      aboutMessage.setPrivateMessageViewer(new User()
          .setName(event.getAsJsonObject("user").get("name").getAsString()));
      response.getWriter().write(gson.toJson(aboutMessage));
      return;
    case HELP_COMMAND_ID:
      Message helpMessage = new Message();
      helpMessage.setText("The Avatar app replies to Google Chat messages.");
      helpMessage.setPrivateMessageViewer(new User()
          .setName(event.getAsJsonObject("user").get("name").getAsString()));
      response.getWriter().write(gson.toJson(helpMessage));
      return;
  }
}

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

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

• स्लैश कमांड का इस्तेमाल करने वाले Chat ऐप्लिकेशन के सैंपल देखना
• मैसेज भेजें
• निजी मैसेज भेजना
• इंटरैक्टिव डायलॉग बॉक्स खोलना