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

এই পৃষ্ঠায় গুগল চ্যাটের পরিধি বর্ধনকারী গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য ইউজার ইন্টারফেস (UI) কীভাবে তৈরি করতে হয়, তার একটি সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে।

দ্রষ্টব্য: গুগল চ্যাটে, অ্যাড-অনগুলি ব্যবহারকারীদের কাছে গুগল চ্যাট অ্যাপ হিসেবে প্রদর্শিত হয়। আপনি গুগল চ্যাট এপিআই ইন্টারঅ্যাকশন ইভেন্ট ব্যবহার করেও আপনার চ্যাট অ্যাপ তৈরি করতে পারেন। আরও জানতে, ‘ এক্সটেন্ড গুগল চ্যাট ওভারভিউ’ দেখুন।

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

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

চিত্র ১ : যখন কোনো ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন, তখন ‘অ্যাডেড টু স্পেস’ ট্রিগারটি সক্রিয় হয় এবং একটি ইভেন্ট অবজেক্ট পাঠায়। একটি বার্তা দিয়ে সাড়া দেওয়ার জন্য, চ্যাট অ্যাপটি ইভেন্ট অবজেক্টটি হ্যান্ডেল করে এবং এমন একটি অ্যাকশন রিটার্ন করে যা বার্তাটি তৈরি করে।

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

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

ট্রিগার

এই অংশে গুগল ওয়ার্কস্পেস অ্যাড-অনগুলো চ্যাটে যে ট্রিগারগুলো ব্যবহার করে, তা ব্যাখ্যা করা হয়েছে।

ট্রিগার হলো সেই নির্দিষ্ট উপায়, যার মাধ্যমে ব্যবহারকারীরা চ্যাট ইউআই ব্যবহার করে কোনো চ্যাট অ্যাপ চালু করে, যেমন @মেনশন বা অ্যাপ কমান্ড ব্যবহার করে।

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

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

অন্যান্য অ্যাড-অনের মতো নয়, এই ট্রিগারগুলির জন্য যেকোনো কলব্যাক ফাংশন আপনাকে অবশ্যই গুগল চ্যাট এপিআই (Google Chat API) ব্যবহার করে কনফিগার করতে হবে। নির্দেশনার জন্য, ‘একটি চ্যাট অ্যাপ কনফিগার করুন’ (Configure a Chat app) দেখুন।

কোনো ট্রিগারে সাড়া দিতে, নিম্নলিখিত নির্দেশিকাগুলো দেখুন:

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

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

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

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

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

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

চ্যাট কার্যক্রম

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

একটি অ্যাড-অন অ্যাকশনের মাধ্যমে সাড়া দিতে হলে, একটি চ্যাট অ্যাপকে অবশ্যই ৩০ সেকেন্ডের মধ্যে উত্তর দিতে হবে এবং সেই উত্তরটি অবশ্যই সেই স্পেসে পোস্ট করতে হবে যেখানে কথোপকথনটি হয়েছিল। অন্যথায়, চ্যাট অ্যাপটিকে অবশ্যই অথেনটিকেশন সেট আপ করতে হবে এবং উত্তর দেওয়ার জন্য গুগল চ্যাট এপিআই (Google Chat API)-কে কল করতে হবে ।

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

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

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

নিচের সারণিতে দেখানো হয়েছে চ্যাট অ্যাপগুলো কীভাবে বিভিন্ন অ্যাকশনের মাধ্যমে সাড়া দিতে পারে। চ্যাট অ্যাপগুলো JSON অবজেক্ট রিটার্ন করতে পারে অথবা অ্যাপস স্ক্রিপ্টের AddOnResponseService ব্যবহার করে রেসপন্স তৈরি করতে পারে।

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

গুগল চ্যাট এপিআই ব্যবহার করে উত্তর দিন

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

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

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

নোড.জেএস

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;
}

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

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

• গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য ট্রিগার
• একটি গুগল চ্যাট অ্যাপ কনফিগার করুন
• ইভেন্ট অবজেক্ট
• অতিরিক্ত ক্রিয়াকলাপ
• গুগল চ্যাট বার্তা পাঠান
• ইন্টারেক্টিভ ডায়ালগ খুলুন
• গুগল চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন
• চ্যাট এপিআই-এর সংক্ষিপ্ত বিবরণ