Google চ্যাট ইন্টারফেস তৈরি করুন

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস দেয়।

এই পৃষ্ঠাটি Google Chat প্রসারিত করে এমন Google Workspace অ্যাড-অনগুলির জন্য কীভাবে ইউজার ইন্টারফেস (UIs) তৈরি করতে হয় তার একটি ওভারভিউ প্রদান করে।

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

চ্যাট অ্যাপের জন্য ইন্টারফেস তৈরি করতে, আপনি নিম্নলিখিত অ্যাড-অন উপাদানগুলি ব্যবহার করেন:

• ট্রিগারস : যে উপায়ে Google চ্যাট ব্যবহারকারীরা একটি চ্যাট অ্যাপ চালু করতে পারে, যেমন এটিকে একটি স্পেসে যোগ করা বা এটিকে একটি বার্তা পাঠানো।
• ইভেন্ট অবজেক্ট : চ্যাট অ্যাপ ট্রিগার বা UI ইন্টারঅ্যাকশন থেকে যে ডেটা পায়।
• অ্যাকশন : যে উপায়ে চ্যাট অ্যাপগুলি ইন্টারঅ্যাকশনে প্রতিক্রিয়া জানাতে পারে, যেমন বার্তা পাঠানো বা কার্ড-ভিত্তিক ইউজার ইন্টারফেস ফেরত দেওয়া।

চিত্র 1 : যখন একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে, তখন Added to Space ট্রিগার ফায়ার করে এবং একটি ইভেন্ট অবজেক্ট পাঠায়। একটি বার্তার সাথে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপটি ইভেন্ট অবজেক্ট পরিচালনা করে এবং একটি ক্রিয়া ফেরত দেয় যা বার্তাটি তৈরি করে।

চ্যাট অ্যাপগুলি নিম্নলিখিত ইন্টারফেসে কার্ড তৈরি এবং প্রদর্শন করতে পারে:

• বার্তা যাতে পাঠ্য, স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড এবং বোতাম থাকতে পারে।
• ডায়ালগ যা কার্ড যা একটি নতুন উইন্ডোতে খোলে এবং সাধারণত ব্যবহারকারীদের তথ্য জমা দিতে অনুরোধ করে।
• লিঙ্ক প্রিভিউ যা কার্ড যা একটি বহিরাগত পরিষেবা সম্পর্কে তথ্যের পূর্বরূপ দেখায়।

ট্রিগার

এই বিভাগে Google Workspace অ্যাড-অনগুলি Chat-এ ব্যবহার করা ট্রিগারগুলি ব্যাখ্যা করে।

ট্রিগার হল নির্দিষ্ট উপায় যা ব্যবহারকারীরা চ্যাট UI ব্যবহার করে একটি চ্যাট অ্যাপ চালু করে, যেমন @উল্লেখ বা অ্যাপ কমান্ড ব্যবহার করা।

নিম্নলিখিত সারণীতে চ্যাট ট্রিগার, একটি বিবরণ এবং চ্যাট অ্যাপগুলি সাধারণত কীভাবে প্রতিক্রিয়া দেখায় তা দেখায়:

ট্রিগার	বর্ণনা	সাধারণ প্রতিক্রিয়া
স্থান যোগ করা হয়েছে	একজন ব্যবহারকারী একটি স্পেসে Chat অ্যাপ যোগ করেন বা Google Workspace অ্যাডমিনিস্ট্রেটর তাদের প্রতিষ্ঠানের ব্যবহারকারীদের জন্য সরাসরি মেসেজের জায়গায় Chat অ্যাপ ইনস্টল করেন। অ্যাডমিনিস্ট্রেটরদের দ্বারা ইনস্টল করা Chat অ্যাপ সম্পর্কে জানতে, Google Workspace অ্যাডমিন সহায়তা ডকুমেন্টেশনে আপনার ডোমেনে মার্কেটপ্লেস অ্যাপ ইনস্টল করুন দেখুন।	চ্যাট অ্যাপটি একটি অনবোর্ডিং বার্তা পাঠায় যা ব্যাখ্যা করে যে এটি কী করে এবং কীভাবে স্পেসে ব্যবহারকারীরা এটির সাথে ইন্টারঅ্যাক্ট করতে পারে।
বার্তা	একজন ব্যবহারকারী নিম্নলিখিত উপায়গুলির মধ্যে একটি বার্তায় চ্যাট অ্যাপের সাথে যোগাযোগ করে: চ্যাট অ্যাপের মাধ্যমে সরাসরি বার্তা (DM) স্পেসে একটি বার্তা পাঠায়। @ যেকোন ধরনের স্পেসে চ্যাট অ্যাপ উল্লেখ করে। একটি বার্তা পাঠায় যাতে একটি লিঙ্ক রয়েছে যা লিঙ্কের পূর্বরূপগুলির জন্য URL প্যাটার্নের সাথে মেলে৷ একটি selectionInput উইজেটের বহুনির্বাচন মেনুতে পাঠ্য টাইপ করে।	চ্যাট অ্যাপ মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সাড়া দেয়। উদাহরণ স্বরূপ, একটি চ্যাট অ্যাপ স্ল্যাশ কমান্ডের উত্তর দেয় /about একটি বার্তার সাথে যা চ্যাট অ্যাপটি যে কাজগুলি করতে পারে তা ব্যাখ্যা করে।
স্থান থেকে সরানো হয়েছে	একজন ব্যবহারকারী স্পেস থেকে Chat অ্যাপ সরিয়ে দেন বা Google Workspace অ্যাডমিনিস্ট্রেটর তাদের প্রতিষ্ঠানের ব্যবহারকারীর জন্য Chat অ্যাপ আনইনস্টল করেন। ব্যবহারকারীরা তাদের অ্যাডমিনিস্ট্রেটর দ্বারা ইনস্টল করা চ্যাট অ্যাপগুলি সরাতে পারবেন না। যদি কোনও ব্যবহারকারী আগে Chat অ্যাপ ইনস্টল করে থাকেন, তাহলে Google Workspace অ্যাডমিনিস্ট্রেটর আনইনস্টল করার চেষ্টা করুক না কেন, Chat অ্যাপ ইনস্টল থাকবে।	চ্যাট অ্যাপটি স্থানের জন্য কনফিগার করা যেকোনো ইনকামিং বিজ্ঞপ্তি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং যেকোনো অভ্যন্তরীণ স্টোরেজ সাফ করে। চ্যাট অ্যাপগুলি এই ট্রিগারে বার্তাগুলির সাথে প্রতিক্রিয়া জানাতে পারে না, কারণ তারা আর স্পেসের সদস্য নয়৷
অ্যাপ কমান্ড	একজন ব্যবহারকারী একটি চ্যাট অ্যাপ কমান্ড ব্যবহার করেন।	চ্যাট অ্যাপ কমান্ডে সাড়া দেয়। উদাহরণস্বরূপ, একটি বার্তার সাথে উত্তর দেয় বা একটি ডায়ালগ খোলে৷

অন্যান্য Google Workspace অ্যাড-অনগুলির থেকে ভিন্ন, আপনাকে Google Chat API ব্যবহার করে এই ট্রিগারগুলির জন্য যেকোনো কলব্যাক ফাংশন কনফিগার করতে হবে। নির্দেশনার জন্য, একটি Google চ্যাট অ্যাপ কনফিগার করুন দেখুন।

একটি ট্রিগারে প্রতিক্রিয়া জানাতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

• Google চ্যাট বার্তা পাঠান
• ইন্টারেক্টিভ ডায়ালগ খুলুন
• Google চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন

ঘটনা বস্তু

চ্যাট অ্যাপগুলি ইভেন্ট অবজেক্টগুলি পায় যখন একটি চ্যাট ট্রিগার ফায়ার হয় বা যখন চ্যাট ব্যবহারকারীরা চ্যাট অ্যাপ থেকে একটি UI এর সাথে ইন্টারঅ্যাক্ট করেন (যেমন একটি বোতামে ক্লিক করা)। ইভেন্ট অবজেক্টে ইন্টারঅ্যাকশনের ডেটা থাকে যা চ্যাট অ্যাপ একটি UI-এর প্রতিক্রিয়া বা আপডেট করতে ব্যবহার করতে পারে।

ইভেন্ট অবজেক্ট পরিচালনা সম্পর্কে জানতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

• Google চ্যাট বার্তা পাঠান
• ইন্টারেক্টিভ ডায়ালগ খুলুন
• Google চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন

Chat এবং অন্যান্য Google Workspace অ্যাপ্লিকেশনের মধ্যে অ্যাড-অন ইভেন্ট অবজেক্ট সম্পর্কে জানতে, ইভেন্ট অবজেক্ট দেখুন।

চ্যাট কর্ম

এই বিভাগটি ব্যাখ্যা করে যে কীভাবে চ্যাট অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানাতে অ্যাড-অন অ্যাকশন ব্যবহার করতে পারে।

একটি অ্যাড-অন অ্যাকশনের সাথে প্রতিক্রিয়া জানাতে, একটি চ্যাট অ্যাপকে অবশ্যই 30 সেকেন্ডের মধ্যে প্রতিক্রিয়া জানাতে হবে এবং প্রতিক্রিয়াটি অবশ্যই সেই জায়গায় পোস্ট করতে হবে যেখানে ইন্টারঅ্যাকশনটি ঘটেছে৷ অন্যথায়, চ্যাট অ্যাপটিকে অবশ্যই প্রমাণীকরণ সেট আপ করতে হবে এবং প্রতিক্রিয়া জানাতে Google Chat API-কে কল করতে হবে ।

চ্যাট অ্যাপগুলি বিভিন্ন উপায়ে মিথস্ক্রিয়াগুলি পরিচালনা করতে এবং প্রতিক্রিয়া জানাতে পারে। অনেক ক্ষেত্রে, চ্যাট অ্যাপ একটি বার্তার সাথে উত্তর দেয়। চ্যাট অ্যাপগুলি ডেটা উত্স থেকে কিছু তথ্য সন্ধান করতে পারে, ইভেন্ট অবজেক্টের তথ্য রেকর্ড করতে পারে বা অন্য কিছু সম্পর্কে। এই প্রক্রিয়াকরণ আচরণটি মূলত Google Chat অ্যাপকে সংজ্ঞায়িত করে।

ব্যবহারকারীর মিথস্ক্রিয়ায় প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপগুলিকে অবশ্যই সংশ্লিষ্ট ইভেন্ট অবজেক্ট পরিচালনা করতে হবে এবং নিম্নলিখিত JSON অবজেক্টগুলির মধ্যে একটি ফিরিয়ে দিতে হবে:

• DataActions : Google Workspace ডেটা তৈরি বা আপডেট করে। চ্যাট বার্তা পাঠাতে বা আপডেট করতে , বস্তুটিতে অবশ্যই মার্কআপ থাকতে হবে যা Message ডেটার পরিবর্তনগুলিকে সংজ্ঞায়িত করে, যা chatDataActionMarkup হিসাবে উপস্থাপিত হয়।
• RenderActions : একটি ডায়ালগ তৈরি বা আপডেট করুন বা একটি বহু-নির্বাচন মেনুর জন্য ইনপুট পরামর্শ প্রদান করুন।
• AuthorizationError : একটি অনুমোদন কার্ড সহ ব্যবহারকারীদের সাইন ইন করতে বা Google-এর বাহ্যিক পরিষেবাতে প্রমাণীকরণের জন্য অনুরোধ করে৷ চ্যাটে, শুধুমাত্র মৌলিক অনুমোদন কার্ড সমর্থিত।

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

Google Chat API ব্যবহার করে সাড়া দিন

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

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

চ্যাট API প্রমাণীকরণ এবং কল করার বিষয়ে জানতে, চ্যাট API ওভারভিউ দেখুন।

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

• Google Workspace অ্যাড-অনগুলির জন্য ট্রিগার
• একটি Google চ্যাট অ্যাপ কনফিগার করুন
• ঘটনা বস্তু
• অ্যাড-অন অ্যাকশন
• Google চ্যাট বার্তা পাঠান
• ইন্টারেক্টিভ ডায়ালগ খুলুন
• Google চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন
• চ্যাট API ওভারভিউ