এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে আপনার Google Chat অ্যাপের জন্য দ্রুত কমান্ড সেট আপ করতে হয় এবং প্রতিক্রিয়া জানাতে হয়।
একটি দ্রুত কমান্ড হল এমন একটি উপায় যা ব্যবহারকারীরা একটি চ্যাট অ্যাপের সাথে যোগাযোগ করতে এবং যোগাযোগ করতে পারে। একটি দ্রুত কমান্ড ব্যবহার করতে, চ্যাট স্পেস বা কথোপকথনে Google Workspace Tools ক্লিক করে ইন্টিগ্রেশন মেনু খুলুন এবং তারপর একটি নাম সহ একটি অ্যাপ কমান্ড নির্বাচন করুন যা স্ল্যাশ ( / ) দিয়ে শুরু হয় না। একটি দ্রুত কমান্ড নির্বাচন করে, চ্যাট অ্যাপটি ব্যবহারকারীর কাছ থেকে আরও ইনপুট ছাড়াই সরাসরি আহ্বান করা হয়, যাতে দ্রুত ব্যবহারকারীর মিথস্ক্রিয়া করার অনুমতি দেওয়া হয়।
ব্যবহারকারীরা একটি স্ল্যাশ কমান্ডের মাধ্যমে একটি চ্যাট অ্যাপও ব্যবহার করতে পারেন। স্ল্যাশ কমান্ডের তুলনায়, চ্যাট UI-তে দ্রুত কমান্ডগুলি আরও ব্যবহারকারী-বান্ধব নামের সাথে ফর্ম্যাট করা হয়, সেগুলি নির্বাচন করার সাথে সাথেই আহ্বান করা হয় এবং সেগুলি ব্যবহারকারীকে স্ল্যাশ কমান্ডের নাম মনে রাখার বা টাইপ করার প্রয়োজন হয় না।
Google Chat API-এ একটি দ্রুত কমান্ড সেট আপ করুন
দ্রুত কমান্ড তৈরি করতে বা বিদ্যমান যেকোনো স্ল্যাশ কমান্ড দ্রুত কমান্ডে আপডেট করতে, আপনাকে Google Chat API-এর জন্য আপনার চ্যাট অ্যাপের কনফিগারেশনে কমান্ড সম্পর্কে তথ্য উল্লেখ করতে হবে।
Google Chat API-এ একটি দ্রুত কমান্ড কনফিগার করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:
Google ক্লাউড কনসোলে, মেনু > APIs & Services > Enabled APIs & Services > Google Chat API-এ ক্লিক করুন
কনফিগারেশন ক্লিক করুন।
উন্নত সেটিংসের অধীনে, ট্রিগারগুলিতে যান এবং পরীক্ষা করুন যে অ্যাপ কমান্ড ক্ষেত্রে একটি ট্রিগার রয়েছে, যেমন একটি HTTP এন্ডপয়েন্ট বা অ্যাপস স্ক্রিপ্ট ফাংশন। দ্রুত কমান্ডের প্রতিক্রিয়া জানাতে আপনাকে অবশ্যই নিম্নলিখিত বিভাগে এই ট্রিগারটি ব্যবহার করতে হবে।
কমান্ডের অধীনে, একটি কমান্ড যোগ করুন ক্লিক করুন।
কমান্ডের জন্য একটি কমান্ড আইডি, নাম, বিবরণ এবং কমান্ডের ধরন লিখুন:
- কমান্ড আইডি: 1 থেকে 1000 পর্যন্ত একটি সংখ্যা যা আপনার চ্যাট অ্যাপ কমান্ড চিনতে এবং একটি প্রতিক্রিয়া ফেরাতে ব্যবহার করে।
- নাম: কমান্ডের প্রদর্শনের নাম। নাম 50 অক্ষর পর্যন্ত হতে পারে এবং বিশেষ অক্ষর অন্তর্ভুক্ত করতে পারে।
- ব্যবহারকারীর কাছে কমান্ডগুলি পরিষ্কার করার জন্য সংক্ষিপ্ত, বর্ণনামূলক এবং কার্যকরী শব্দ বা বাক্যাংশ ব্যবহার করুন। উদাহরণস্বরূপ, একটি কমান্ডের জন্য আপডেট পরিচিতি ব্যবহার করুন যা একটি পরিচিতি রেকর্ড পরিবর্তন করে।
- বর্ণনা: কমান্ডটি কী করে তা বর্ণনা করে এমন পাঠ্য। বর্ণনা 50 অক্ষর পর্যন্ত হতে পারে এবং বিশেষ অক্ষর অন্তর্ভুক্ত করতে পারে।
- বর্ণনা সংক্ষিপ্ত এবং পরিষ্কার রাখুন যাতে ব্যবহারকারীরা জানতে পারে যে তারা যখন কমান্ডটি ব্যবহার করবে তখন কী আশা করা উচিত।
- চ্যাট অ্যাপটি স্পেসের প্রত্যেকের কাছে বা গোপনে যে ব্যবহারকারীকে কমান্ড আহ্বান করে তাদের উত্তর দেয় কিনা তা ব্যবহারকারীদের জানান। উদাহরণস্বরূপ, সম্পর্কে দ্রুত কমান্ডের জন্য, আপনি এটিকে এই অ্যাপ সম্পর্কে জানুন হিসাবে বর্ণনা করতে পারেন (শুধুমাত্র আপনার কাছে দৃশ্যমান) ৷
- কমান্ডের ধরন: দ্রুত কমান্ড নির্বাচন করুন।
ঐচ্ছিক: আপনি যদি চান যে আপনার চ্যাট অ্যাপ একটি ডায়ালগের সাথে কমান্ডের প্রতিক্রিয়া জানাতে, একটি ডায়ালগ খুলুন চেকবক্স নির্বাচন করুন।
Save এ ক্লিক করুন।
চ্যাট অ্যাপের জন্য দ্রুত কমান্ডটি এখন কনফিগার করা হয়েছে।
দ্রুত আদেশে সাড়া দিন
যখন ব্যবহারকারীরা একটি দ্রুত কমান্ড ব্যবহার করেন, তখন আপনার চ্যাট অ্যাপ একটি ইভেন্ট অবজেক্ট পায় যাতে দ্রুত কমান্ড সম্পর্কে তথ্য থাকে। ইভেন্ট অবজেক্টে একটি AppCommand পেলোড রয়েছে যাতে বলা কমান্ড সম্পর্কে বিশদ বিবরণ রয়েছে (কমান্ড আইডি সহ), যাতে আপনি একটি উপযুক্ত প্রতিক্রিয়া ফেরত দিতে পারেন।
একটি দ্রুত কমান্ডের প্রতিক্রিয়া জানাতে, আপনাকে অবশ্যই অ্যাপ কমান্ড ট্রিগার প্রয়োগ করতে হবে যাতে আপনার চ্যাট অ্যাপটি অ্যাপ কমান্ড মেটাডেটা ধারণ করে এমন কোনো ইভেন্ট অবজেক্ট পরিচালনা করতে পারে।
নিম্নলিখিত কোডটি একটি চ্যাট অ্যাপের উদাহরণ দেখায় যা সাহায্য কমান্ডের উত্তর দেয়। দ্রুত কমান্ডের প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপ একটি অ্যাপ কমান্ড ট্রিগার থেকে ইভেন্ট অবজেক্টগুলি পরিচালনা করে। যখন একটি ইভেন্ট অবজেক্টের পেলোডে একটি দ্রুত কমান্ড আইডি থাকে, তখন চ্যাট অ্যাপ createMessageAction অবজেক্টের সাথে DataActions অ্যাকশন প্রদান করে:
অ্যাপস স্ক্রিপ্ট
// The ID of the slash command "/about".
// It's not enabled by default, set to the actual ID to enable it. You must
// use the same ID as set in the Google Chat API configuration.
const HELP_COMMAND_ID = 0;
/**
* Responds to an APP_COMMAND event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onAppCommand(event) {
// Stores the Google Chat app command metadata as a variable.
const appCommandMetadata = event.chat.appCommandPayload.appCommandMetadata;
if (appCommandMetadata.appCommandType == "QUICK_COMMAND") {
// Executes the quick command logic based on its ID.
// Quick command IDs are set in the Google Chat API configuration.
switch (appCommandMetadata.appCommandId) {
case HELP_COMMAND_ID:
return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
text: 'The Avatar app replies to Google Chat messages.'
}}}}};
}
}
}
এই কোডের নমুনাটি ব্যবহার করতে, HELP_COMMAND_ID কমান্ড আইডি দিয়ে প্রতিস্থাপন করুন যা আপনি Chat API-এ দ্রুত কমান্ড কনফিগার করার সময় নির্দিষ্ট করেছিলেন। চ্যাটে দ্রুত কমান্ড পরীক্ষা করতে, Google Workspace Tools ক্লিক করে ইন্টিগ্রেশন মেনু খুলুন এবং তারপর আপনার দ্রুত কমান্ড নির্বাচন করুন।