Google Chat-এ স্ল্যাশ কমান্ডের উত্তর দিন

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

Google Chat-এ অ্যাড-অনগুলি ব্যবহারকারীদের কাছে Google Chat অ্যাপ হিসেবে দেখা যায়। আরও জানতে, এক্সটেন্ড Google চ্যাট ওভারভিউ দেখুন।

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

ব্যবহারকারীরা কিভাবে স্ল্যাশ কমান্ড ব্যবহার করে

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

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

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

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

পূর্বশর্ত

Node.js

একটি Google Workspace অ্যাড-অন যা Google Chat প্রসারিত করে। একটি তৈরি করতে, HTTP কুইকস্টার্ট সম্পূর্ণ করুন।

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

একটি Google Workspace অ্যাড-অন যা Google Chat প্রসারিত করে। একটি তৈরি করতে, Apps Script quickstart সম্পূর্ণ করুন।

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

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

  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. উন্নত সেটিংসের অধীনে, ট্রিগারগুলিতে যান এবং পরীক্ষা করুন যে MESSAGE ক্ষেত্রে একটি ট্রিগার রয়েছে, যেমন একটি HTTP এন্ডপয়েন্ট বা অ্যাপস স্ক্রিপ্ট ফাংশন৷ স্ল্যাশ কমান্ডের প্রতিক্রিয়া জানাতে আপনাকে অবশ্যই নিম্নলিখিত বিভাগে এই ট্রিগারটি ব্যবহার করতে হবে।

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

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

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

  6. ঐচ্ছিক: আপনি যদি চান যে আপনার চ্যাট অ্যাপ একটি ডায়ালগের সাথে কমান্ডের প্রতিক্রিয়া জানাতে, তাহলে একটি ডায়ালগ খুলুন চেকবক্স নির্বাচন করুন।

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

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

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

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

একটি স্ল্যাশ কমান্ডের প্রতিক্রিয়া জানাতে, আপনাকে অবশ্যই মেসেজ ট্রিগার প্রয়োগ করতে হবে যাতে আপনার চ্যাট অ্যাপ স্ল্যাশ কমান্ড মেটাডেটা ধারণ করে এমন কোনো ইভেন্ট অবজেক্ট পরিচালনা করতে পারে।

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

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

Node.js 

// 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 ABOUT_COMMAND_ID = 0;

/**
 * Google Cloud Function that responds to messages sent from a
 * Google Chat space.
 *
 * @param {Object} req Request sent from Google Chat space
 * @param {Object} res Response to send back
 */
exports.avatarApp = function avatarApp(req, res) {
    if (req.method === 'GET' || !req.body.chat) {
        return res.send('Hello! This function is meant to be used ' +
            'in a Google Chat Space.');
    }

    // Stores the Google Chat event as a variable.
    const chatMessage = req.body.chat.messagePayload.message;

    if (chatMessage.slashCommand) {
        // Executes the slash command logic based on its ID.
        // Slash command IDs are set in the Google Chat API configuration.
        switch (chatMessage.slashCommand.commandId) {
            case ABOUT_COMMAND_ID:
                return res.send({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
                    text: 'The Avatar app replies to Google Chat messages.'
                }}}}});
        }
    }

    // Replies with the sender's avatar in a card otherwise.
    const displayName = chatMessage.sender.displayName;
    const avatarUrl = chatMessage.sender.avatarUrl;
    res.send({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
        text: 'Here\'s your avatar',
        cardsV2: [{
            cardId: 'avatarCard',
            card: {
                name: 'Avatar Card',
                header: {
                    title: `Hello ${displayName}!`,
                },
                sections: [{
                    widgets: [{
                        textParagraph: { text: 'Your avatar picture: ' }
                    }, {
                        image: { imageUrl: avatarUrl }
                    }]
                }]
            }
        }]
    }}}}});
};

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

// 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 ABOUT_COMMAND_ID = 0;

/**
 * Responds to a MESSAGE event in Google Chat.
 *
 * @param {Object} event the event object from Google Chat
 */
function onMessage(event) {
    // Stores the Google Chat event as a variable.
    const chatMessage = event.chat.messagePayload.message;

    if (chatMessage.slashCommand) {
        // Executes the slash command logic based on its ID.
        // Slash command IDs are set in the Google Chat API configuration.
        switch (chatMessage.slashCommand.commandId) {
            case ABOUT_COMMAND_ID:
                return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
                    text: 'The Avatar app replies to Google Chat messages.'
                }}}}};
        }
    }

    // Replies with the sender's avatar in a card otherwise.
    const displayName = chatMessage.sender.displayName;
    const avatarUrl = chatMessage.sender.avatarUrl;
    return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
        text: 'Here\'s your avatar',
        cardsV2: [{
            cardId: 'avatarCard',
            card: {
                name: 'Avatar Card',
                header: {
                    title: `Hello ${displayName}!`,
                },
                sections: [{
                    widgets: [{
                        textParagraph: { text: 'Your avatar picture: ' }
                    }, {
                        image: { imageUrl: avatarUrl }
                    }]
                }]
            }
        }]
    }}}}};
}

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