Google চ্যাট অ্যাপ হিসেবে স্ল্যাশ কমান্ডে সাড়া দিন

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে আপনার Google Chat অ্যাপের জন্য স্ল্যাশ কমান্ড সেট আপ করতে হয় এবং প্রতিক্রিয়া জানাতে হয়।

একটি স্ল্যাশ কমান্ড হল একটি সাধারণ উপায় যা ব্যবহারকারীরা একটি চ্যাট অ্যাপের সাথে যোগাযোগ করে। স্ল্যাশ কমান্ডগুলি ব্যবহারকারীদের একটি চ্যাট অ্যাপের মূল বৈশিষ্ট্যগুলি আবিষ্কার করতে এবং ব্যবহার করতে সহায়তা করে।

একটি স্ল্যাশ কমান্ড ব্যবহার করতে, ব্যবহারকারীরা একটি স্ল্যাশ ( / ) এবং তারপর একটি ছোট পাঠ্য কমান্ড টাইপ করে, যেমন /about চ্যাট অ্যাপ সম্পর্কে তথ্য পেতে। ব্যবহারকারীরা Google চ্যাটে একটি স্ল্যাশ টাইপ করে উপলব্ধ স্ল্যাশ কমান্ডগুলি আবিষ্কার করতে পারে, যা একটি উইন্ডো প্রদর্শন করে যা চ্যাট অ্যাপের জন্য উপলব্ধ কমান্ডগুলি তালিকাভুক্ত করে:

স্ল্যাশ কমান্ড উইন্ডো
চিত্র 1 : ব্যবহারকারীরা Google চ্যাটে স্ল্যাশ টাইপ করলে যে উইন্ডোটি প্রদর্শিত হয়।

আপনার স্ল্যাশ কমান্ড সেট আপ করা উচিত কিনা তা সিদ্ধান্ত নিতে এবং কীভাবে ব্যবহারকারীর ইন্টারঅ্যাকশন ডিজাইন করবেন তা বুঝতে, সমস্ত ব্যবহারকারীর যাত্রা সংজ্ঞায়িত করুন দেখুন।

ব্যক্তিগত প্রতিক্রিয়া সহ স্ল্যাশ কমান্ড

যখন একজন ব্যবহারকারী একটি বার্তা পাঠায় যাতে একটি স্ল্যাশ কমান্ড থাকে, তখন বার্তাটি শুধুমাত্র ব্যবহারকারী এবং চ্যাট অ্যাপের কাছে দৃশ্যমান হয়। আপনি যদি আপনার চ্যাট অ্যাপটিকে একাধিক ব্যক্তির সাথে স্পেসগুলিতে যোগ করার জন্য কনফিগার করে থাকেন, তাহলে আপনি ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে ইন্টারঅ্যাকশন ব্যক্তিগত রাখতে ব্যক্তিগতভাবে স্ল্যাশ কমান্ডের প্রতিক্রিয়া বিবেচনা করতে পারেন।

উদাহরণস্বরূপ, একটি স্পেস এ আবিষ্কার করা একটি চ্যাট অ্যাপ সম্পর্কে জানতে, ব্যবহারকারীরা /about বা /help এর মতো কমান্ড ব্যবহার করতে পারে। স্পেসে অন্য সকলকে অবহিত করা এড়াতে, চ্যাট অ্যাপটি কীভাবে চ্যাট অ্যাপটি ব্যবহার করতে হয় এবং সহায়তা পেতে হয় সে সম্পর্কে তথ্য সহ ব্যক্তিগতভাবে প্রতিক্রিয়া জানাতে পারে।

পূর্বশর্ত

Node.js

একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। একটি HTTP পরিষেবা ব্যবহার করে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।

অ্যাপস স্ক্রিপ্ট

একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। Apps Script-এ একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।

পাইথন

একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। একটি HTTP পরিষেবা ব্যবহার করে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।

জাভা

একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। একটি HTTP পরিষেবা ব্যবহার করে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি সম্পূর্ণ করুন।

একটি স্ল্যাশ কমান্ড সেট আপ করুন

এই বিভাগটি ব্যাখ্যা করে কিভাবে একটি স্ল্যাশ কমান্ড সেট আপ করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করতে হয়:

  1. আপনার স্ল্যাশ কমান্ডের জন্য একটি নাম তৈরি করুন
  2. Google Chat API-এ স্ল্যাশ কমান্ড কনফিগার করুন

আপনার স্ল্যাশ কমান্ডের নাম দিন

একটি স্ল্যাশ কমান্ডের নাম হল ব্যবহারকারীরা চ্যাট অ্যাপটি চালু করতে একটি চ্যাট বার্তায় যা টাইপ করে। কমান্ডটি কীভাবে ব্যবহার করবেন সে সম্পর্কে ব্যবহারকারীদের আরও প্রম্পট করতে নামের নীচে একটি সংক্ষিপ্ত বিবরণও উপস্থিত হয়:

স্ল্যাশ কমান্ডের নাম এবং বিবরণ
চিত্র 2 : একটি স্ল্যাশ কমান্ডের নাম এবং বিবরণ।

আপনার স্ল্যাশ কমান্ডের জন্য একটি নাম এবং বিবরণ নির্বাচন করার সময়, নিম্নলিখিত সুপারিশগুলি বিবেচনা করুন:

  • আপনার স্ল্যাশ কমান্ডের নাম দিতে:

    • ব্যবহারকারীর কাছে কমান্ডগুলিকে পরিষ্কার এবং সহজ করতে সংক্ষিপ্ত, বর্ণনামূলক এবং কার্যকরী শব্দ বা বাক্যাংশ ব্যবহার করুন। উদাহরণস্বরূপ, /createAReminder বলার পরিবর্তে, /remindMe ব্যবহার করুন।
    • যদি আপনার কমান্ডে একাধিক শব্দ থাকে, প্রথম শব্দের জন্য সমস্ত ছোট হাতের অক্ষর ব্যবহার করে এবং তারপর অতিরিক্ত শব্দের প্রথম অক্ষর বড় করে ব্যবহারকারীদের কমান্ড পড়তে সাহায্য করুন। উদাহরণস্বরূপ, /updatecontact এর পরিবর্তে, /updateContact ব্যবহার করুন।
    • আপনার কমান্ডের জন্য একটি অনন্য বা সাধারণ নাম ব্যবহার করবেন কিনা তা বিবেচনা করুন। যদি আপনার কমান্ড একটি সাধারণ মিথস্ক্রিয়া বা বৈশিষ্ট্য বর্ণনা করে, আপনি একটি সাধারণ নাম ব্যবহার করতে পারেন যা ব্যবহারকারীরা চিনতে পারে এবং আশা করে, যেমন /settings বা /feedback । অন্যথায়, অনন্য কমান্ডের নাম ব্যবহার করার চেষ্টা করুন, কারণ আপনার কমান্ডের নাম যদি অন্যান্য চ্যাট অ্যাপের জন্য একই হয়, তাহলে ব্যবহারকারীকে অবশ্যই আপনার খুঁজে পেতে এবং ব্যবহার করতে অনুরূপ কমান্ডের মাধ্যমে ফিল্টার করতে হবে।
  • আপনার স্ল্যাশ কমান্ড বর্ণনা করতে:

    • বর্ণনা সংক্ষিপ্ত এবং পরিষ্কার রাখুন যাতে ব্যবহারকারীরা জানতে পারে যে তারা যখন কমান্ডটি ব্যবহার করবে তখন কী আশা করা উচিত।
    • কমান্ডের জন্য কোন ফর্ম্যাটিং প্রয়োজনীয়তা আছে কিনা তা ব্যবহারকারীদের জানান। উদাহরণ স্বরূপ, আপনি যদি একটি /remindMe কমান্ড তৈরি করেন যার জন্য আর্গুমেন্ট টেক্সট প্রয়োজন হয়, তাহলে বর্ণনাটিকে এমন কিছুতে সেট করুন যেমন Remind me to do [something] at [time] .
    • চ্যাট অ্যাপটি স্পেসের প্রত্যেকের কাছে বা গোপনে যে ব্যবহারকারীর কমান্ড আহ্বান করে তাদের উত্তর দেয় কিনা তা ব্যবহারকারীদের জানান। উদাহরণস্বরূপ, স্ল্যাশ কমান্ডের জন্য /about , আপনি এটিকে Learn about this app (Only visible to you) হিসাবে বর্ণনা করতে পারেন। একটি স্ল্যাশ কমান্ডে ব্যক্তিগতভাবে প্রতিক্রিয়া জানাতে, একটি ব্যক্তিগত বার্তার সাথে প্রতিক্রিয়া বিভাগটি দেখুন।

Google Chat API-এ আপনার স্ল্যাশ কমান্ড কনফিগার করুন

একটি স্ল্যাশ কমান্ড তৈরি করতে, আপনাকে Google Chat API-এর জন্য আপনার চ্যাট অ্যাপের কনফিগারেশনে কমান্ড সম্পর্কে তথ্য উল্লেখ করতে হবে।

Google Chat API-এ একটি স্ল্যাশ কমান্ড কনফিগার করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Enabled APIs & Services > Google Chat API- এ ক্লিক করুন

    Google Chat API পৃষ্ঠায় যান

  2. কনফিগারেশন ক্লিক করুন।

  3. স্ল্যাশ কমান্ডের অধীনে, একটি স্ল্যাশ কমান্ড যোগ করুন ক্লিক করুন।

  4. কমান্ডের জন্য একটি নাম, কমান্ড আইডি এবং বিবরণ লিখুন:

    1. নাম: কমান্ডের জন্য প্রদর্শনের নাম, এবং ব্যবহারকারীরা আপনার অ্যাপ চালু করতে কী টাইপ করে। একটি স্ল্যাশ দিয়ে শুরু করতে হবে, শুধুমাত্র পাঠ্য থাকতে হবে এবং 50টি অক্ষর পর্যন্ত হতে পারে৷
    2. বর্ণনা: টেক্সট যেটি বর্ণনা করে কিভাবে কমান্ডটি ব্যবহার এবং ফরম্যাট করতে হয়। বর্ণনা 50টি অক্ষর পর্যন্ত হতে পারে।
    3. কমান্ড আইডি: 1 থেকে 1000 পর্যন্ত একটি সংখ্যা যা আপনার চ্যাট অ্যাপ স্ল্যাশ কমান্ড চিনতে এবং একটি প্রতিক্রিয়া ফেরাতে ব্যবহার করে।
  5. ঐচ্ছিক: আপনি যদি চান যে আপনার চ্যাট অ্যাপ একটি ডায়ালগের সাথে কমান্ডের প্রতিক্রিয়া জানাতে, একটি ডায়ালগ খুলুন চেকবক্স নির্বাচন করুন।

  6. Save এ ক্লিক করুন।

স্ল্যাশ কমান্ডটি এখন চ্যাট অ্যাপের জন্য কনফিগার করা হয়েছে।

একটি স্ল্যাশ কমান্ডে সাড়া দিন

যখন ব্যবহারকারীরা একটি চ্যাট বার্তা তৈরি করে যাতে একটি স্ল্যাশ কমান্ড থাকে, তখন আপনার চ্যাট অ্যাপ একটি MESSAGE ইন্টারঅ্যাকশন ইভেন্ট পায়। ইভেন্ট পেলোডে slashCommand এবং slashCommandMetadata অবজেক্ট থাকে। এই বস্তুগুলিতে বার্তায় ব্যবহৃত কমান্ডের বিবরণ রয়েছে (কমান্ড আইডি সহ), যাতে আপনি একটি উপযুক্ত প্রতিক্রিয়া ফেরত দিতে পারেন।

Cymbal Labs Chat অ্যাপের জন্য ব্যক্তিগত বার্তা। বার্তাটি বলে যে চ্যাট অ্যাপটি সিম্বাল ল্যাব দ্বারা তৈরি করা হয়েছে এবং ডকুমেন্টেশনের একটি লিঙ্ক এবং সহায়তা দলের সাথে যোগাযোগ করার একটি লিঙ্ক ভাগ করেছে।
একটি চ্যাট অ্যাপ কীভাবে সমর্থন পেতে হয় তা ব্যাখ্যা করতে স্ল্যাশ কমান্ড /help ব্যক্তিগতভাবে প্রতিক্রিয়া জানায়।

নিম্নলিখিত কোডটি একটি চ্যাট অ্যাপের একটি উদাহরণ দেখায় যা MESSAGE ইন্টারঅ্যাকশন ইভেন্টগুলি পরিচালনা করে এবং বার্তাটিতে মিলিত কমান্ড আইডি রয়েছে কিনা তা সনাক্ত করে /about স্ল্যাশ কমান্ডের উত্তর দেয়। বার্তাটিতে কমান্ড আইডি থাকলে, চ্যাট অ্যাপ একটি ব্যক্তিগত বার্তা ফেরত দেয়:

Node.js

node/avatar-app/index.js
// 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 res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
  }
}

অ্যাপস স্ক্রিপ্ট

apps-script/avatar-app/avatar-app.gs
// 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/avatar-app/main.py
# Checks for the presence of a slash command in the message.
if "slashCommand" in request_json["message"]:
  # Executes the slash command logic based on its ID.
  # Slash command IDs are set in the Google Chat API configuration.
  if request_json["message"]["slashCommand"]["commandId"] == ABOUT_COMMAND_ID:
    return {
      "privateMessageViewer": request_json["user"],
      "text": 'The Avatar app replies to Google Chat messages.'
    }

জাভা

java/avatar-app/src/main/java/App.java
// Checks for the presence of a slash command in the message.
if (body.getAsJsonObject("message").has("slashCommand")) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  JsonObject slashCommand = body.getAsJsonObject("message").getAsJsonObject("slashCommand");
  switch (slashCommand.get("commandId").getAsString()) {
    case ABOUT_COMMAND_ID:
    JsonObject aboutMessage = new JsonObject();
    aboutMessage.addProperty("text", "The Avatar app replies to Google Chat messages.");
    aboutMessage.add("privateMessageViewer", body.getAsJsonObject("user"));
      response.getWriter().write(gson.toJson(aboutMessage));
      return;
  }
}

ABOUT_COMMAND_ID কমান্ড আইডি দিয়ে সেট করুন যা আপনি Chat API-এ স্ল্যাশ কমান্ড কনফিগার করার সময় নির্দিষ্ট করেছিলেন। এই কোডটি পরীক্ষা করতে, Google Chat অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্য পরীক্ষা করুন।