এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

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

চ্যাট অ্যাপটি একটি অ্যাড টু স্পেস ট্রিগার থেকে একটি ইভেন্ট অবজেক্ট গ্রহণ করে — **চিত্র ১** : যখন একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন, তখন **Added to space** ট্রিগারটি সক্রিয় হয় এবং একটি ইভেন্ট অবজেক্ট পাঠায়। একটি বার্তার প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপ ইভেন্ট অবজেক্টটি পরিচালনা করে এবং বার্তা তৈরি করে এমন একটি ক্রিয়া ফেরত দেয়।

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

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

ট্রিগার

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

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

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

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

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

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

ইভেন্ট অবজেক্ট

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

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

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

চ্যাট অ্যাকশন

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

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

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

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

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

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

Google Chat API ব্যবহার করে উত্তর দিন

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

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

৩০ সেকেন্ড পরে কোনও ইন্টারঅ্যাকশন ইভেন্টে সাড়া দেওয়ার সময়, আপনার চ্যাট অ্যাপ সাড়া দিচ্ছে না বলে ব্যবহারকারীর মুখোমুখি হওয়া ত্রুটির বার্তা এড়াতে, আপনাকে ৩০ সেকেন্ডের মধ্যে একটি খালি প্রতিক্রিয়া পাঠিয়ে ইন্টারঅ্যাকশন ইভেন্টের প্রাপ্তি স্বীকার করতে হবে, যেমনটি এখানে দেখানো হয়েছে:

নোড.জেএস

async function onEvent(req, res) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return res.send({});
};

পাইথন

def on_event(event) -> dict:
  # Trigger asynchronous job that will respond using the Google Chat API.
  ...

  # Respond with an empty response to the Google Chat platform.
  return {}

জাভা

public String onEvent(JsonNode event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return "{}";
}

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

function onEvent(event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return null;
}

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