একটি Google চ্যাট অ্যাপ কনফিগার করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে একটি গুগল চ্যাট অ্যাপকে গুগল ওয়ার্কস্পেস অ্যাড-অন হিসেবে কনফিগার এবং স্থাপন করতে হয়।

চ্যাটকে সম্প্রসারিত করে এমন একটি গুগল ওয়ার্কস্পেস অ্যাড-অন ডেপ্লয় এবং টেস্ট করতে, আপনাকে অবশ্যই গুগল চ্যাট এপিআই (Google Chat API) ব্যবহার করে একটি চ্যাট অ্যাপ সক্রিয় এবং কনফিগার করতে হবে। চ্যাট এপিআই কনফিগারেশন সেটিংসে আপনি চ্যাট অ্যাপটির নাম, অ্যাভাটার, ডেপ্লয়মেন্ট এবং আপনি যে ইন্টারেক্টিভ ফিচারগুলো ব্যবহার করতে চান, সেগুলোর মতো সমস্ত বিবরণ নির্দিষ্ট করেন।

দ্রষ্টব্য: এই পৃষ্ঠায় অ্যাপস স্ক্রিপ্ট বা একটি HTTP পরিষেবা ব্যবহার করে কীভাবে একটি চ্যাট অ্যাপ কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে। Dialogflow এবং Pub/Sub উপলব্ধ নয়। বিস্তারিত জানতে, সীমাবদ্ধতা এবং জ্ঞাত সমস্যাসমূহ দেখুন।

পূর্বশর্ত

• গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।

• একটি গুগল ক্লাউড প্রজেক্ট। এটি তৈরি করতে, “একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন” দেখুন।

• OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
• গুগল চ্যাট এপিআই সক্রিয় করুন ।

আপনার চ্যাট অ্যাপের জন্য একটি প্রদর্শনের নাম, অবতার এবং বিবরণ বেছে নিন।

চ্যাট অ্যাপের নাম, অ্যাভাটার এবং বিবরণ চ্যাট UI-তে ব্যবহারকারীদের দেখানো হয়। চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করার জন্য, ব্যবহারকারীরা নিম্নলিখিত উপায়ে এই তথ্যগুলো দেখে বা ব্যবহার করে:

• চ্যাট অ্যাপটিকে কোনো স্পেসে যুক্ত করতে বা মেসেজ পাঠাতে @mention করুন।
• চ্যাট অ্যাপটি খুঁজুন এবং এর সাথে একটি সরাসরি বার্তা শুরু করুন। অ্যাপস মেনুতে, সরাসরি বার্তাগুলোতে চ্যাট অ্যাপটির নাম এবং অ্যাভাটার দেখা যায়।
• কম্পোজ বার থেকে ব্যবহারকারীরা চ্যাট অ্যাপগুলো ব্রাউজ করতে এবং তাদের নাম, অ্যাভাটার ও বিবরণ দেখতে পারেন।

চ্যাট অ্যাপ কনফিগার করার আগে, আপনাকে নিম্নলিখিত তথ্যগুলো প্রস্তুত করতে হবে:

মাঠ	বর্ণনা	ফর্ম্যাট
অ্যাপের নাম	চ্যাট অ্যাপটির প্রদর্শিত নাম।	২৫টি পর্যন্ত আলফানিউমেরিক অক্ষর
অবতার ইউআরএল	যে ছবিটি আপনার চ্যাট অ্যাপের অ্যাভাটার হিসেবে প্রদর্শিত হয়।	একটি HTTPS URL যা একটি বর্গাকার গ্রাফিক্স ইমেজ (PNG বা JPEG) নির্দেশ করে। প্রস্তাবিত আকার হলো ২৫৬ বাই ২৫৬ পিক্সেল বা তার বেশি।
বর্ণনা	চ্যাট অ্যাপটির উদ্দেশ্যের একটি সংক্ষিপ্ত বিবরণ।	৪০টি পর্যন্ত আলফানিউমেরিক অক্ষর

পরবর্তী অংশে, আপনি চ্যাট এপিআই-এর কনফিগারেশন সেটিংসে এই তথ্যগুলো নির্দিষ্ট করবেন।

গুগল ক্লাউড কনসোলে আপনার চ্যাট অ্যাপটি কনফিগার করুন।

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

আপনার চ্যাট অ্যাপের বিবরণ হাতে পেলে, আপনার ক্লাউড প্রজেক্টটি খুলুন এবং চ্যাট এপিআই কনফিগার করুন:

1. গুগল ক্লাউড কনসোলে, চ্যাট এপিআই (Chat API) পৃষ্ঠায় যান এবং কনফিগারেশন (Configuration) পৃষ্ঠায় ক্লিক করুন:

   চ্যাট এপিআই কনফিগারেশন পৃষ্ঠায় যান

2. অ্যাপ্লিকেশন তথ্যের অধীনে, অ্যাপের নাম , অ্যাভাটার ইউআরএল এবং বিবরণ ক্ষেত্রগুলি পূরণ করুন।

3. ইন্টারেক্টিভ ফিচারস- এর অধীনে, ‘Enable interactive features’ অপশনটি অন করুন এবং নিম্নলিখিতগুলি সম্পূর্ণ করুন:

   1. আপনার চ্যাট অ্যাপটি ইনস্টল ও ব্যবহারের জন্য উপলব্ধ করতে, ‘Functionality’-এর অধীনে ‘Join spaces and group conversations’ নির্বাচন করুন।

      ডিফল্টরূপে, ব্যবহারকারীরা চ্যাট অ্যাপটি ইনস্টল করতে এবং ব্যবহারকারী ও চ্যাট অ্যাপের মধ্যে একটি নির্দিষ্ট স্থানে মেসেজ পাঠাতে পারেন। ব্যবহারকারীরা একাধিক ব্যক্তি থাকা স্পেসেও চ্যাট অ্যাপটি যুক্ত করতে এবং এর সাথে যোগাযোগ করতে পারেন।

   2. কানেকশন সেটিংস-এর অধীনে, চ্যাট থেকে ইভেন্ট অবজেক্ট গ্রহণ করার জন্য আপনি যে আর্কিটেকচারটি ব্যবহার করতে চান তা নির্বাচন করুন:

      • HTTP পরিষেবা ব্যবহার করতে, HTTP এন্ডপয়েন্ট URL নির্বাচন করুন এবং একটি URL প্রদান করুন।
      • একটি গুগল অ্যাপস স্ক্রিপ্ট প্রজেক্ট ব্যবহার করতে, অ্যাপস স্ক্রিপ্ট নির্বাচন করুন এবং প্রজেক্টটির জন্য একটি ডিপ্লয়মেন্ট আইডি প্রদান করুন।
      সতর্কতা: যদি একটি অ্যাপস স্ক্রিপ্ট ডেপ্লয়মেন্ট আইডি আগে থেকেই দেওয়া থাকে, তাহলে ক্লাউড প্রজেক্টটি একটি বিদ্যমান গুগল ওয়ার্কস্পেস অ্যাড-অনের সাথে সংযুক্ত। আপনি যদি চ্যাট এপিআই-তে ডেপ্লয়মেন্ট আইডি আপডেট করেন, তাহলে আপনার অ্যাড-অনের জন্যও ডেপ্লয়মেন্ট আইডি আপডেট হয়ে যাবে এবং এটি গুগল ওয়ার্কস্পেস মার্কেটপ্লেসে আপনার লিস্টিংকে প্রভাবিত করতে পারে। আপনার অ্যাড-অন কনফিগারেশন পর্যালোচনা করতে, গুগল ওয়ার্কস্পেস মার্কেটপ্লেস ডকুমেন্টেশনে "গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে-তে আপনার অ্যাপ কনফিগার করুন" অংশটি দেখুন।

   3. ঐচ্ছিক: একাধিক এন্ডপয়েন্ট বা ফাংশনে ইভেন্ট অবজেক্ট গ্রহণ করতে, সংযোগ সেটিংস > ট্রিগার-এ যান এবং নিম্নলিখিত চ্যাট ট্রিগারগুলির জন্য কলব্যাক ফাংশনগুলি প্রদান বা আপডেট করুন:

      দ্রষ্টব্য: অ্যাপস স্ক্রিপ্টের ক্ষেত্রে, আপনি যদি ট্রিগারগুলি আপডেট না করেন, তাহলে আপনাকে অবশ্যই এই বিভাগে দেওয়া সংশ্লিষ্ট কলব্যাক ফাংশনগুলি (যেমন onMessage , onAddedToSpace , এবং onRemovedFromSpace ) ব্যবহার করতে হবে।
      • স্পেসে যুক্ত করা : একজন ব্যবহারকারী কোনো গ্রুপ কথোপকথন বা স্পেসে চ্যাট অ্যাপটি যুক্ত করেন, অথবা ব্যক্তিগত বার্তা আদান-প্রদানের জন্য চ্যাট অ্যাপটি ইনস্টল করেন।
      • বার্তা : একজন ব্যবহারকারী চ্যাট অ্যাপে একটি বার্তা পাঠান। উদাহরণস্বরূপ, চ্যাট অ্যাপে সরাসরি বার্তা পাঠান অথবা একাধিক ব্যক্তি আছে এমন কোনো স্পেসে চ্যাট অ্যাপটিকে @মেনশন করেন।
      • স্পেস থেকে সরানো হয়েছে : একজন ব্যবহারকারী কোনো স্পেস থেকে চ্যাট অ্যাপটি আনইনস্টল বা সরিয়ে ফেলেন।
      • অ্যাপ কমান্ড : একজন ব্যবহারকারী চ্যাট অ্যাপ থেকে কুইক কমান্ড বা স্ল্যাশ কমান্ড ব্যবহার করেন।

   4. ঐচ্ছিক: অন্যান্য ইন্টারেক্টিভ বৈশিষ্ট্য যোগ করুন, যেমন কুইক কমান্ড , স্ল্যাশ কমান্ড বা লিঙ্ক প্রিভিউ ।

   5. ভিজিবিলিটি- এর অধীনে আপনার ইমেলটি উল্লেখ করুন, যাতে আপনি গুগল ওয়ার্কস্পেস মার্কেটপ্লেসে প্রকাশ করার আগে চ্যাট অ্যাপটি ইনস্টল ও পরীক্ষা করতে পারেন। আপনি আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশন থেকে সর্বোচ্চ পাঁচজন ব্যক্তি, অথবা এক বা একাধিক গুগল গ্রুপ নির্দিষ্ট করতে পারেন।

4. ঐচ্ছিক: গুগল ক্লাউড লগিং ব্যবহার করার জন্য, ‘লগস’ (Logs) এর অধীনে ‘লগিং-এ ত্রুটি লগ করুন’ (Log errors to Logging) চেকবক্সটি নির্বাচন করুন। আরও তথ্যের জন্য, চ্যাট এপিআই (Chat API) ডকুমেন্টেশনে ‘চ্যাট অ্যাপের জন্য ত্রুটির লগ কোয়েরি করুন’ (Query error logs for Chat apps) অংশটি দেখুন।

5. সংরক্ষণ করুন- এ ক্লিক করুন।

কনফিগারেশনটি সেভ করার পর, চ্যাট এপিআই-এর ভিজিবিলিটি সেটিং-এ আপনার নির্দিষ্ট করা যে কেউ চ্যাট অ্যাপটি ইনস্টল, পরীক্ষা বা ব্যবহার করতে পারবে। আপনার চ্যাট অ্যাপ পরীক্ষা ও ডিবাগ করা শুরু করতে, চ্যাট এপিআই ডকুমেন্টেশনে ‘Test interactive features for Google Chat apps’ অংশটি দেখুন।

বিদ্যমান গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য বিবেচ্য বিষয়গুলি

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

• ব্যক্তিবিশেষ এবং গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর উভয়কেই মার্কেটপ্লেস থেকে আপনার অ্যাড-অনটি ইনস্টল করার সুযোগ দিতে হবে। আপনি গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে-তে এই ইনস্টলেশন সেটিংস কনফিগার করেন।
• চ্যাট অ্যাপগুলো ম্যানিফেস্টের addons.common অবজেক্টে অন্যান্য গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনের জন্য আপনার কনফিগার করা নাম এবং লোগো ব্যবহার করে না।
• যেসব অ্যাড-অন গুগল ওয়ার্কস্পেস মার্কেটপ্লেসে প্রকাশিত হয়, সেগুলোর গুগল চ্যাট এপিআই কনফিগারেশন সেটিংসে করা কোনো পরিবর্তনের ড্রাফট আপনি সেভ করতে পারবেন না। চ্যাট এপিআই কনফিগারেশন সেটিংস আপডেট ও সেভ করার পর, আপডেট করা চ্যাট অ্যাপটি সকল বিদ্যমান ব্যবহারকারীর জন্য উপলব্ধ হয়ে যায়। আপনার মার্কেটপ্লেস লিস্টিং আপডেট করতে, কোনো পরিবর্তন সাবমিট করার আগে আপনি একটি ড্রাফট তৈরি করে নিতে পারেন।

• যদি আপনি অ্যাপস স্ক্রিপ্ট ব্যবহার করে আপনার অ্যাড-অনটি তৈরি করে থাকেন:

  • আপনার অ্যাড-অন কনফিগারেশনের বাকি অংশের জন্য আপনি যে অ্যাপস স্ক্রিপ্ট ডিপ্লয়মেন্ট আইডি ব্যবহার করেন, সেটিই আপনাকে অবশ্যই ব্যবহার করতে হবে।
  • আপনি অ্যাপস স্ক্রিপ্ট এডিটর ব্যবহার করে চ্যাটে টেস্ট ডেপ্লয়মেন্ট ইনস্টল করতে পারবেন না। এর পরিবর্তে, আপনাকে অবশ্যই সরাসরি চ্যাট UI থেকে সেগুলি ইনস্টল করতে হবে।

• আপনি যদি কোনো HTTP পরিষেবা ব্যবহার করে আপনার অ্যাড-অনটি তৈরি করে থাকেন, তাহলে Google Workspace অ্যাড-অন API ব্যবহার করে তৈরি করা ম্যানিফেস্ট এবং ডিপ্লয়মেন্টগুলিতে চ্যাট অ্যাপের কনফিগারেশন সংক্রান্ত কোনো বিবরণ বাদ দিন। Google Workspace মার্কেটপ্লেস SDK-তে আপনি যে HTTP ডিপ্লয়মেন্টগুলি নির্দিষ্ট করেন, সেগুলি শুধুমাত্র অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য ব্যবহৃত হয়।

সম্পর্কিত বিষয়

• চ্যাট এপিআই-তে অ্যাক্সেস পরিচালনা করতে, গুগল চ্যাট এপিআই ডকুমেন্টেশনে ‘গুগল চ্যাট এপিআই কনফিগার করুন’ অংশটি দেখুন।
• গুগল চ্যাট অ্যাপের ইন্টারেক্টিভ ফিচারগুলো পরীক্ষা করুন