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

এই পৃষ্ঠাটি 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 চ্যাট অ্যাপ কনফিগার করুন দেখুন।

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

ঘটনা বস্তু

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

ইভেন্ট অবজেক্ট
commonEventObject object ( CommonEventObject )
হোস্ট অ্যাপ্লিকেশন নির্বিশেষে, সমস্ত ইভেন্ট অবজেক্টের জন্য সাধারণ তথ্য ধারণকারী একটি বস্তু।
chat object ( Chat )
চ্যাট মিথস্ক্রিয়া সম্পর্কে সমস্ত তথ্য ধারণকারী একটি বস্তু।

চ্যাট

চ্যাট
chat.user object ( User )
চ্যাট অ্যাপের সাথে যোগাযোগকারী চ্যাট ব্যবহারকারী।
chat.space object ( Space )
চ্যাট স্পেস যেখানে একজন ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন।
chat.eventTime

string ( Timestamp format)

যে সময় মিথস্ক্রিয়া ঘটেছে।

ইউনিয়ন ফিল্ড payload ।

payload নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

chat.messagePayload

object ( MessagePayload )

একটি বার্তা ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড গ্রহণ করে।

chat.addedToSpacePayload

object ( AddedToSpacePayload )

পেলোড যা চ্যাট অ্যাপগুলি একটি অ্যাডেড টু স্পেস ট্রিগার থেকে পায়।

chat.removedFromSpacePayload

object ( RemovedFromSpacePayload )

স্পেস থেকে সরানো ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড পায়।

chat.buttonClickedPayload

object ( ButtonClickedPayload )

ব্যবহারকারীরা মেসেজ বা কার্ড থেকে একটি বোতামে ক্লিক করলে Chat অ্যাপগুলি যে পেলোড পায়। কোনো ব্যবহারকারী তথ্য জমা দেওয়ার জন্য একটি বোতামে ক্লিক করলে, commonEventObject.formInputs অবজেক্টে ব্যবহারকারীর কাছ থেকে সংগৃহীত মান থাকে। বিস্তারিত জানার জন্য, Google Chat ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ দেখুন।

chat.widgetUpdatedPayload

object ( WidgetUpdatedPayload )

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

CommonEventObject.parameters['autocomplete_widget_query'] অবজেক্টে স্ট্রিং মান থাকে যা ব্যবহারকারী মেনুতে টাইপ করে।

chat.appCommandPayload

object ( AppCommandPayload )

একজন ব্যবহারকারী যখন চ্যাট অ্যাপ থেকে একটি কমান্ড ব্যবহার করেন তখন চ্যাট অ্যাপগুলি যে পেলোড পায়।

পেলোড

ইন্টারঅ্যাকশনের ধরণের উপর নির্ভর করে, ইভেন্টে এক বা একাধিক চ্যাট API সংস্থান সহ একটি পেলোড রয়েছে।

বার্তা পেলোড
মেসেজপেলোড
chat.messagePayload.message object ( Message )
চ্যাট বার্তা যা ইভেন্টটিকে ট্রিগার করেছে৷
chat.messagePayload.space object ( Space )
চ্যাট স্পেস যেখানে একজন ব্যবহারকারী মেসেজ পাঠিয়েছেন যা চ্যাট অ্যাপকে আহ্বান করেছে।

স্থান পেলোড যোগ করা হয়েছে
AddedToSpacePayload
chat.addedToSpacePayload.space object ( Space )
চ্যাট স্পেস যেখানে ব্যবহারকারী চ্যাট অ্যাপ যোগ বা ইনস্টল করেছেন।

অ্যাডমিনিস্ট্রেটররা যখন চ্যাট অ্যাপস ইনস্টল করেন, তখন space.adminInstalled ইনস্টল করা ক্ষেত্রটি true হিসাবে সেট করা হয়।

chat.addedToSpacePayload.interactionAdd boolean
একজন ব্যবহারকারী একটি বার্তা ব্যবহার করে একটি স্পেসে চ্যাট অ্যাপ যোগ করে কিনা। উদাহরণস্বরূপ, চ্যাট অ্যাপে @ উল্লেখ করে বা একটি স্ল্যাশ কমান্ড ব্যবহার করে। true হলে, চ্যাট একটি messagePayload সহ অন্য ইভেন্ট অবজেক্ট পাঠায় যাতে বার্তা সম্পর্কে তথ্য থাকে।

স্থান পেলোড থেকে সরানো হয়েছে
SpacePayload থেকে সরানো হয়েছে
chat.removedFromSpacePayload.space object ( Space )
চ্যাট স্পেস যেখান থেকে ব্যবহারকারী চ্যাট অ্যাপটি সরিয়ে বা আনইনস্টল করেছেন।

যখন অ্যাডমিনিস্ট্রেটররা চ্যাট অ্যাপ আনইনস্টল করে, তখন space.adminInstalled ক্ষেত্রটি false সেট করা হয়।

বোতামে ক্লিক করা পেলোড
বাটন ক্লিক করা পেলোড
chat.buttonClickedPayload.message object ( Message )
চ্যাট মেসেজে ব্যবহারকারীর ক্লিক করা বোতামটি রয়েছে।
chat.buttonClickedPayload.space object ( Space )
চ্যাট স্পেস যেখানে ব্যবহারকারী চ্যাট অ্যাপ মেসেজ থেকে একটি বোতামে ক্লিক করেছেন।
chat.buttonClickedPayload.isDialogEvent boolean
ব্যবহারকারী একটি ডায়ালগের সাথে ইন্টারঅ্যাক্ট করতে বোতামটি ক্লিক করেছেন কিনা।
chat.buttonClickedPayload.dialogEventType enum ( DialogEventType )
যদি isDialogEvent true হয়, একটি ডায়ালগে ইন্টারঅ্যাকশনের ধরন।

Enum DialogEventType .

dialogEventType টাইপের মান নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

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

উইজেট আপডেট পেলোড
WidgetUpdatedPayload
chat.widgetUpdatedPayload.space object ( Space )
চ্যাট স্পেস যেখানে মিথস্ক্রিয়া ঘটেছে।

অ্যাপ কমান্ড পেলোড
AppCommandPayload
chat.appCommandPayload.appCommandMetadata object ( AppCommandMetadata )
ব্যবহারকারী কোন কমান্ড ব্যবহার করেছেন এবং কিভাবে তারা কমান্ডটি ট্রিগার করেছে সে সম্পর্কে মেটাডেটা।
chat.appCommandPayload.space object ( Space )
চ্যাট স্পেস যেখানে একজন ব্যবহারকারী কমান্ড ব্যবহার করেছেন।
chat.appCommandPayload.thread object ( Thread )
যদি কোনো থ্রেডে ইন্টারঅ্যাকশন ঘটে থাকে, Chat থ্রেড যেখানে ব্যবহারকারী কমান্ডটি ব্যবহার করেছেন।
chat.appCommandPayload.message object ( Message )
স্ল্যাশ কমান্ড দিয়ে ব্যবহারকারী যে বার্তা পাঠিয়েছেন।
chat.appCommandPayload.configCompleteRedirectUri string
কমান্ডের জন্য অনুমোদন বা কনফিগারেশনের প্রয়োজন হলে, ব্যবহারকারীরা Google Chat-এর বাইরে প্রক্রিয়াটি সম্পূর্ণ করার পরে তাদের রিডাইরেক্ট করার জন্য একটি URL।
chat.appCommandPayload.isDialogEvent boolean
কমান্ড একটি ডায়ালগ খোলে কিনা।
chat.appCommandPayload.dialogEventType enum ( DialogEventType )
ডায়ালগের সাথে ইন্টারঅ্যাকশনের ধরন।

Enum DialogEventType .

dialogEventType টাইপের মান নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

TYPE_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট।
REQUEST_DIALOG একটি ব্যবহারকারী একটি ডায়ালগ অনুরোধ. উদাহরণস্বরূপ, তারা একটি স্ল্যাশ কমান্ড ব্যবহার করে বা একটি বার্তা থেকে একটি বোতামে ক্লিক করে।
SUBMIT_DIALOG একজন ব্যবহারকারী একটি ডায়ালগের মধ্যে একটি ইন্টারেক্টিভ উপাদান ক্লিক করে। উদাহরণস্বরূপ, একজন ব্যবহারকারী একটি ডায়ালগে তথ্য পূরণ করে এবং তথ্য জমা দিতে একটি বোতামে ক্লিক করে।
অ্যাপ কমান্ড মেটাডেটা
AppCommandMetadata
chat.appCommandPayload.appCommandMetadata.appCommandId

string ( int64 format)

কমান্ড আইডি।

chat.appCommandPayload.appCommandMetadata.appCommandType enum ( AppCommandType )
আদেশের ধরন।

Enum AppCommandType ।

AppCommandType এর মান নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

APP_COMMAND_TYPE_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট।
SLASH_COMMAND একজন ব্যবহারকারী একটি বার্তা পাঠিয়ে কমান্ডটি ব্যবহার করে যা একটি স্ল্যাশ / দিয়ে শুরু হয়।

চ্যাট কর্ম

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

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

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

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

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

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

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

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

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