Google চ্যাট বার্তা পাঠান

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে Google Chat অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশনের উত্তর দিতে বার্তা পাঠাতে পারে।

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

  • স্ল্যাশ কমান্ড থেকে যোগাযোগ ফর্ম.
    চিত্র 1. একটি চ্যাট অ্যাপ একটি পাঠ্য বার্তা এবং বোতাম সহ একটি স্ল্যাশ কমান্ডের প্রতিক্রিয়া জানায়৷
  • একটি ডায়ালগে যোগাযোগ ফর্ম.
    চিত্র 2. একটি চ্যাট অ্যাপ একটি ডায়ালগ খোলে যেখানে ব্যবহারকারীরা তথ্য ইনপুট করতে পারে।
  • ফর্ম ইনপুট উইজেট সহ কার্ড বার্তা।
    চিত্র 5. একটি চ্যাট অ্যাপ পাঠ্য এবং একটি ইন্টারেক্টিভ কার্ড সহ একটি বার্তা পাঠায়৷

পূর্বশর্ত

Node.js

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

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

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

বার্তাটি ডিজাইন করুন

চ্যাট অ্যাপ্লিকেশানগুলি একটি বার্তায় নিম্নলিখিতগুলির যে কোনও একটি অন্তর্ভুক্ত করতে পারে:

  • হাইপারলিঙ্ক, @উল্লেখ এবং ইমোজি রয়েছে এমন টেক্সট।
  • এক বা একাধিক কার্ড, যা একটি বার্তায় প্রদর্শিত হতে পারে বা একটি ডায়ালগ হিসাবে একটি নতুন উইন্ডোতে খুলতে পারে৷
  • এক বা একাধিক আনুষঙ্গিক উইজেট, যা এমন বোতাম যা একটি বার্তার যেকোনো পাঠ্য বা কার্ডের পরে প্রদর্শিত হয়।

বার্তা ডিজাইন করা সম্পর্কে জানতে, নিম্নলিখিত Google Chat API ডকুমেন্টেশন দেখুন:

একটি বার্তা দিয়ে উত্তর দিন

চ্যাট অ্যাপ্লিকেশানগুলি নিম্নলিখিত ট্রিগার বা ইন্টারঅ্যাকশনগুলির যেকোনো একটি বার্তার সাথে প্রতিক্রিয়া জানাতে পারে:

  • মেসেজ ট্রিগার করে , যেমন ব্যবহারকারীরা যখন কোনো চ্যাট অ্যাপকে @উল্লেখ করে বা সরাসরি বার্তা পাঠায়।
  • স্পেস ট্রিগারে যোগ করা হয়েছে , যেমন ব্যবহারকারীরা যখন Google Workspace মার্কেটপ্লেস থেকে Chat অ্যাপটি ইনস্টল করেন বা এটিকে কোনো স্পেসে যোগ করেন।
  • বার্তা বা ডায়ালগে কার্ড থেকে বোতাম ক্লিক। উদাহরণস্বরূপ, যখন ব্যবহারকারীরা তথ্য ইনপুট করে এবং সাবমিট ক্লিক করে।

অন্যথায়, চ্যাট অ্যাপগুলি Google Chat API-এ কল করে সক্রিয়ভাবে বার্তা পাঠাতে পারে।

একটি বার্তার সাথে উত্তর দিতে, একটি CreateMessageAction অবজেক্টের সাথে DataActions ক্রিয়াটি ফিরিয়ে দিন:

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

চ্যাট API থেকে একটি Message সংস্থান দিয়ে MESSAGE প্রতিস্থাপন করুন। অ্যাকশনগুলি কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, চ্যাট অ্যাকশনগুলি দেখুন।

নিম্নলিখিত উদাহরণে, যখনই একটি স্পেস যোগ করা হয় তখন একটি চ্যাট অ্যাপ একটি পাঠ্য বার্তা তৈরি করে এবং পাঠায়। একটি টেক্সট মেসেজ পাঠানোর জন্য যখন কোনো ব্যবহারকারী আপনার চ্যাট অ্যাপটিকে একটি স্পেসে যোগ করে, আপনার চ্যাট অ্যাপটি অ্যাডেড টু স্পেস ট্রিগারে প্রতিক্রিয়া জানায় DataActions :

Node.js 

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace Add-on.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 *                     introduces the app and helps people get started with it.
 */
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`.'
    }}}}});
  }
};

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

/**
 * 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. An onboarding message that
 *                  introduces the app and helps people get started with it.
 */
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`.'
  }}}}};
}

কোড নমুনা নিম্নলিখিত পাঠ্য বার্তা প্রদান করে:

অনবোর্ডিং বার্তার উদাহরণ।

একটি বার্তার সাথে কীভাবে প্রতিক্রিয়া জানাতে হয় তার অতিরিক্ত উদাহরণের জন্য, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

একটি বার্তা আপডেট করুন

চ্যাট অ্যাপগুলি তাদের পাঠানো বার্তাগুলিও আপডেট করতে পারে। উদাহরণস্বরূপ, ব্যবহারকারী একটি ডায়ালগ জমা দেওয়ার পরে বা একটি বার্তা একটি বোতামে ক্লিক করার পরে একটি বার্তা আপডেট করতে৷

একটি চ্যাট অ্যাপ বার্তা আপডেট করতে, একটি UpdateMessageAction এর সাথে DataActions ক্রিয়াটি ফিরিয়ে দিন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

চ্যাট API থেকে একটি Message সংস্থান দিয়ে MESSAGE প্রতিস্থাপন করুন।

অ্যাকশনগুলি কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, চ্যাট অ্যাকশনগুলি দেখুন।

চ্যাট অ্যাপগুলি ব্যবহারকারীর পাঠানো একটি লিঙ্কের পূর্বরূপ ফেরত দেওয়ার জন্য একটি বার্তা আপডেট করতে পারে। বিশদ বিবরণের জন্য, Google চ্যাট বার্তাগুলিতে পূর্বরূপ লিঙ্কগুলি দেখুন।

ইন্টারঅ্যাকশনের উত্তর দিন বা Google Chat API ব্যবহার করে সক্রিয় বার্তা পাঠান

একটি অ্যাড-অন অ্যাকশন ফেরত দেওয়ার পরিবর্তে, চ্যাট অ্যাপগুলিকে একটি ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানাতে Google Chat API ব্যবহার করতে হতে পারে। উদাহরণস্বরূপ, চ্যাট অ্যাপগুলিকে নিম্নলিখিতগুলির যেকোন একটি করতে Google Chat API কল করতে হবে:

  • একটি সময়সূচীতে বা বাহ্যিক সংস্থানগুলির পরিবর্তন সম্পর্কে বার্তা পাঠান৷ উদাহরণস্বরূপ, একটি নতুন সমস্যা বা কেস সম্পর্কে বিজ্ঞপ্তি।
  • ইন্টারঅ্যাকশনের 30 সেকেন্ডের বেশি উত্তর দিন। উদাহরণস্বরূপ, একটি দীর্ঘ-চলমান কাজ শেষ করার পরে একটি বার্তার সাথে প্রতিক্রিয়া জানানো।
  • যেখানে ইন্টারঅ্যাকশন হয়েছে সেই স্থানের বাইরে একটি বার্তা পাঠান।
  • চ্যাট ব্যবহারকারীর পক্ষ থেকে একটি বার্তা পাঠান।

চ্যাট API ব্যবহার করে একটি বার্তা পাঠাতে, আপনাকে অবশ্যই প্রমাণীকরণ সেট আপ করতে হবে এবং Message সংস্থানে create() পদ্ধতিতে কল করতে হবে। পদক্ষেপের জন্য, Google Chat API ব্যবহার করে একটি বার্তা পাঠান দেখুন।