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

চ্যাট অ্যাপগুলি নিম্নলিখিত ইন্টারফেসে কার্ড তৈরি এবং প্রদর্শন করতে পারে:
- বার্তা যাতে পাঠ্য, স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড এবং বোতাম থাকতে পারে।
- ডায়ালগ যা কার্ড যা একটি নতুন উইন্ডোতে খোলে এবং সাধারণত ব্যবহারকারীদের তথ্য জমা দিতে অনুরোধ করে।
- লিঙ্ক প্রিভিউ যা কার্ড যা একটি বহিরাগত পরিষেবা সম্পর্কে তথ্যের পূর্বরূপ দেখায়।
ট্রিগার
এই বিভাগে Google Workspace অ্যাড-অনগুলি Chat-এ ব্যবহার করা ট্রিগারগুলি ব্যাখ্যা করে।
ট্রিগার হল নির্দিষ্ট উপায় যা ব্যবহারকারীরা চ্যাট UI ব্যবহার করে একটি চ্যাট অ্যাপ চালু করে, যেমন @উল্লেখ বা অ্যাপ কমান্ড ব্যবহার করা।
নিম্নলিখিত সারণীতে চ্যাট ট্রিগার, একটি বিবরণ এবং চ্যাট অ্যাপগুলি সাধারণত কীভাবে প্রতিক্রিয়া দেখায় তা দেখায়:
ট্রিগার | বর্ণনা | সাধারণ প্রতিক্রিয়া |
---|---|---|
স্থান যোগ করা হয়েছে | একজন ব্যবহারকারী একটি স্পেসে Chat অ্যাপ যোগ করেন বা Google Workspace অ্যাডমিনিস্ট্রেটর তাদের প্রতিষ্ঠানের ব্যবহারকারীদের জন্য সরাসরি মেসেজের জায়গায় Chat অ্যাপ ইনস্টল করেন। অ্যাডমিনিস্ট্রেটরদের দ্বারা ইনস্টল করা Chat অ্যাপ সম্পর্কে জানতে, Google Workspace অ্যাডমিন সহায়তা ডকুমেন্টেশনে আপনার ডোমেনে মার্কেটপ্লেস অ্যাপ ইনস্টল করুন দেখুন। | চ্যাট অ্যাপটি একটি অনবোর্ডিং বার্তা পাঠায় যা ব্যাখ্যা করে যে এটি কী করে এবং কীভাবে স্পেসে ব্যবহারকারীরা এটির সাথে ইন্টারঅ্যাক্ট করতে পারে। |
বার্তা | একজন ব্যবহারকারী নিম্নলিখিত উপায়গুলির মধ্যে একটি বার্তায় চ্যাট অ্যাপের সাথে যোগাযোগ করে:
| চ্যাট অ্যাপ মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সাড়া দেয়। উদাহরণ স্বরূপ, একটি চ্যাট অ্যাপ স্ল্যাশ কমান্ডের উত্তর দেয় /about একটি বার্তার সাথে যা চ্যাট অ্যাপটি যে কাজগুলি করতে পারে তা ব্যাখ্যা করে। |
স্থান থেকে সরানো হয়েছে | একজন ব্যবহারকারী স্পেস থেকে Chat অ্যাপ সরিয়ে দেন বা Google Workspace অ্যাডমিনিস্ট্রেটর তাদের প্রতিষ্ঠানের ব্যবহারকারীর জন্য Chat অ্যাপ আনইনস্টল করেন। ব্যবহারকারীরা তাদের অ্যাডমিনিস্ট্রেটর দ্বারা ইনস্টল করা চ্যাট অ্যাপগুলি সরাতে পারবেন না। যদি কোনও ব্যবহারকারী আগে Chat অ্যাপ ইনস্টল করে থাকেন, তাহলে Google Workspace অ্যাডমিনিস্ট্রেটর আনইনস্টল করার চেষ্টা করুক না কেন, Chat অ্যাপ ইনস্টল থাকবে। | চ্যাট অ্যাপটি স্থানের জন্য কনফিগার করা যেকোনো ইনকামিং বিজ্ঞপ্তি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং যেকোনো অভ্যন্তরীণ স্টোরেজ সাফ করে। চ্যাট অ্যাপগুলি এই ট্রিগারে বার্তাগুলির সাথে প্রতিক্রিয়া জানাতে পারে না, কারণ তারা আর স্পেসের সদস্য নয়৷ |
অ্যাপ কমান্ড | একজন ব্যবহারকারী একটি চ্যাট অ্যাপ কমান্ড ব্যবহার করেন। | চ্যাট অ্যাপ কমান্ডে সাড়া দেয়। উদাহরণস্বরূপ, একটি বার্তার সাথে উত্তর দেয় বা একটি ডায়ালগ খোলে৷ |
অন্যান্য Google Workspace অ্যাড-অনগুলির থেকে ভিন্ন, আপনাকে Google Chat API ব্যবহার করে এই ট্রিগারগুলির জন্য যেকোনো কলব্যাক ফাংশন কনফিগার করতে হবে। নির্দেশনার জন্য, একটি Google চ্যাট অ্যাপ কনফিগার করুন দেখুন।
একটি ট্রিগারে প্রতিক্রিয়া জানাতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:
- Google চ্যাট বার্তা পাঠান
- ইন্টারেক্টিভ ডায়ালগ খুলুন
- Google চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন
ঘটনা বস্তু
এই বিভাগটি চ্যাট ইভেন্ট অবজেক্টের সমস্ত উপাদানকে সংজ্ঞায়িত করে এবং ব্যাখ্যা করে। আরও জানতে, ইভেন্ট অবজেক্ট দেখুন।
ইভেন্ট অবজেক্ট | |
---|---|
commonEventObject | object ( CommonEventObject ) হোস্ট অ্যাপ্লিকেশন নির্বিশেষে, সমস্ত ইভেন্ট অবজেক্টের জন্য সাধারণ তথ্য ধারণকারী একটি বস্তু। |
chat | object ( Chat ) চ্যাট মিথস্ক্রিয়া সম্পর্কে সমস্ত তথ্য ধারণকারী একটি বস্তু। |
চ্যাট
চ্যাট | |
---|---|
chat.user | object ( User ) চ্যাট অ্যাপের সাথে যোগাযোগকারী চ্যাট ব্যবহারকারী। |
chat.space | object ( Space ) চ্যাট স্পেস যেখানে একজন ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন। |
chat.eventTime | |
ইউনিয়ন ফিল্ড | |
chat.messagePayload | একটি বার্তা ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড গ্রহণ করে। |
chat.addedToSpacePayload | পেলোড যা চ্যাট অ্যাপগুলি একটি অ্যাডেড টু স্পেস ট্রিগার থেকে পায়। |
chat.removedFromSpacePayload | স্পেস থেকে সরানো ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড পায়। |
chat.buttonClickedPayload | ব্যবহারকারীরা মেসেজ বা কার্ড থেকে একটি বোতামে ক্লিক করলে Chat অ্যাপগুলি যে পেলোড পায়। কোনো ব্যবহারকারী তথ্য জমা দেওয়ার জন্য একটি বোতামে ক্লিক করলে, |
chat.widgetUpdatedPayload | ব্যবহারকারীরা একটি |
chat.appCommandPayload | একজন ব্যবহারকারী যখন চ্যাট অ্যাপ থেকে একটি কমান্ড ব্যবহার করেন তখন চ্যাট অ্যাপগুলি যে পেলোড পায়। |
পেলোড
ইন্টারঅ্যাকশনের ধরণের উপর নির্ভর করে, ইভেন্টে এক বা একাধিক চ্যাট API সংস্থান সহ একটি পেলোড রয়েছে।
বার্তা পেলোড
স্থান পেলোড যোগ করা হয়েছে
AddedToSpacePayload | |
---|---|
chat.addedToSpacePayload.space | object ( Space ) চ্যাট স্পেস যেখানে ব্যবহারকারী চ্যাট অ্যাপ যোগ বা ইনস্টল করেছেন। অ্যাডমিনিস্ট্রেটররা যখন চ্যাট অ্যাপস ইনস্টল করেন, তখন |
chat.addedToSpacePayload.interactionAdd | boolean একজন ব্যবহারকারী একটি বার্তা ব্যবহার করে একটি স্পেসে চ্যাট অ্যাপ যোগ করে কিনা। উদাহরণস্বরূপ, চ্যাট অ্যাপটি @উল্লেখ করে বা একটি কমান্ড ব্যবহার করে। true হলে, চ্যাট একটি messagePayload সহ অন্য ইভেন্ট অবজেক্ট পাঠায় যাতে বার্তা সম্পর্কে তথ্য থাকে। |
স্থান পেলোড থেকে সরানো হয়েছে
SpacePayload থেকে সরানো হয়েছে | |
---|---|
chat.removedFromSpacePayload.space | object ( Space ) চ্যাট স্পেস যেখান থেকে ব্যবহারকারী চ্যাট অ্যাপটি সরিয়ে বা আনইনস্টল করেছেন। যখন অ্যাডমিনিস্ট্রেটররা চ্যাট অ্যাপ আনইনস্টল করে, তখন |
বোতামে ক্লিক করা পেলোড
বাটন ক্লিক করা পেলোড | |
---|---|
chat.buttonClickedPayload.message | object ( Message ) চ্যাট মেসেজে ব্যবহারকারীর ক্লিক করা বোতামটি রয়েছে। |
chat.buttonClickedPayload.space | object ( Space ) চ্যাট স্পেস যেখানে ব্যবহারকারী চ্যাট অ্যাপ মেসেজ থেকে একটি বোতামে ক্লিক করেছেন। |
chat.buttonClickedPayload.isDialogEvent | boolean ব্যবহারকারী একটি ডায়ালগের সাথে ইন্টারঅ্যাক্ট করতে বোতামটি ক্লিক করেছেন কিনা। |
chat.buttonClickedPayload.dialogEventType | enum ( DialogEventType ) যদি isDialogEvent true হয়, একটি ডায়ালগে ইন্টারঅ্যাকশনের ধরন। |
Enum | |
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 | |
TYPE_UNSPECIFIED | ডিফল্ট মান। অনির্দিষ্ট। |
REQUEST_DIALOG | একটি ব্যবহারকারী একটি ডায়ালগ অনুরোধ. উদাহরণস্বরূপ, তারা একটি কমান্ড ব্যবহার করে বা একটি বার্তা থেকে একটি বোতামে ক্লিক করে। |
SUBMIT_DIALOG | একজন ব্যবহারকারী একটি ডায়ালগের মধ্যে একটি ইন্টারেক্টিভ উপাদান ক্লিক করে। উদাহরণস্বরূপ, একজন ব্যবহারকারী একটি ডায়ালগে তথ্য পূরণ করে এবং তথ্য জমা দিতে একটি বোতামে ক্লিক করে। |
অ্যাপ কমান্ড মেটাডেটা
AppCommandMetadata | |
---|---|
chat.appCommandPayload.appCommandMetadata.appCommandId | কমান্ড আইডি। |
chat.appCommandPayload.appCommandMetadata.appCommandType | enum ( AppCommandType ) আদেশের ধরন। |
Enum | |
APP_COMMAND_TYPE_UNSPECIFIED | ডিফল্ট মান। অনির্দিষ্ট। |
SLASH_COMMAND | একজন ব্যবহারকারী একটি বার্তা পাঠিয়ে কমান্ডটি ব্যবহার করে যা একটি স্ল্যাশ / দিয়ে শুরু হয়। |
চ্যাট কর্ম
এই বিভাগটি ব্যাখ্যা করে যে কীভাবে চ্যাট অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানাতে অ্যাড-অন অ্যাকশন ব্যবহার করতে পারে।
একটি অ্যাড-অন অ্যাকশনের সাথে প্রতিক্রিয়া জানাতে, একটি চ্যাট অ্যাপকে অবশ্যই 30 সেকেন্ডের মধ্যে প্রতিক্রিয়া জানাতে হবে এবং প্রতিক্রিয়াটি অবশ্যই সেই জায়গায় পোস্ট করতে হবে যেখানে ইন্টারঅ্যাকশনটি ঘটেছে৷ অন্যথায়, চ্যাট অ্যাপটিকে অবশ্যই প্রমাণীকরণ সেট আপ করতে হবে এবং প্রতিক্রিয়া জানাতে Google Chat API-কে কল করতে হবে ।
চ্যাট অ্যাপগুলি বিভিন্ন উপায়ে মিথস্ক্রিয়াগুলি পরিচালনা করতে এবং প্রতিক্রিয়া জানাতে পারে। অনেক ক্ষেত্রে, চ্যাট অ্যাপ একটি বার্তার সাথে উত্তর দেয়। চ্যাট অ্যাপগুলি একটি ডেটা উত্স থেকে কিছু তথ্য সন্ধান করতে পারে, ইভেন্ট অবজেক্টের তথ্য রেকর্ড করতে পারে বা অন্য কিছু সম্পর্কে। এই প্রক্রিয়াকরণ আচরণটি মূলত Google Chat অ্যাপকে সংজ্ঞায়িত করে।
ব্যবহারকারীর মিথস্ক্রিয়ায় প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপগুলিকে অবশ্যই সংশ্লিষ্ট ইভেন্ট অবজেক্ট পরিচালনা করতে হবে এবং নিম্নলিখিত JSON অবজেক্টগুলির মধ্যে একটি ফিরিয়ে দিতে হবে:
-
DataActions
: Google Workspace ডেটা তৈরি বা আপডেট করে। চ্যাট বার্তা পাঠাতে বা আপডেট করতে , বস্তুটিতে অবশ্যই মার্কআপ থাকতে হবে যাMessage
ডেটার পরিবর্তনগুলিকে সংজ্ঞায়িত করে, যাchatDataActionMarkup
হিসাবে উপস্থাপিত হয়। -
RenderActions
: বার্তা এবং ডায়ালগে কার্ডগুলির মধ্যে প্রদর্শন বা নেভিগেট করে । -
basic_authorization_prompt
: একটি অনুমোদন কার্ড সহ ব্যবহারকারীদের সাইন ইন করতে বা Google-এর বাহ্যিক পরিষেবাতে প্রমাণীকরণের জন্য অনুরোধ করে৷ বিস্তারিত জানতে, আপনার Google Workspace অ্যাড-অনকে একটি থার্ড-পার্টি পরিষেবাতে কানেক্ট করুন দেখুন।
চ্যাট অ্যাপের কাঙ্খিত সাড়া | ফিরে আসার জন্য প্রয়োজনীয় ব্যবস্থা |
---|---|
একটি বার্তা পাঠান বা আপডেট করুন । | DataActions |
একটি ডায়ালগ খুলুন, আপডেট করুন বা বন্ধ করুন৷ | RenderActions |
একটি কার্ড বা ডায়ালগ থেকে তথ্য সংগ্রহ করতে , ব্যবহারকারীরা একটি মাল্টিসিলেক্ট মেনুতে কী টাইপ করে তার উপর ভিত্তি করে নির্বাচন আইটেমগুলি সাজেস্ট করুন৷ | RenderActions |
চ্যাট ব্যবহারকারীরা একটি স্পেসে পাঠান এমন বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন । | DataActions |
Google Chat API ব্যবহার করে সাড়া দিন
একটি অ্যাড-অন অ্যাকশন ফেরত দেওয়ার পরিবর্তে, চ্যাট অ্যাপগুলিকে একটি ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানাতে Google Chat API ব্যবহার করতে হতে পারে। উদাহরণস্বরূপ, চ্যাট অ্যাপগুলিকে নিম্নলিখিতগুলির যেকোন একটি করতে Google Chat API কল করতে হবে:
- 30 সেকেন্ড পরে একটি মিথস্ক্রিয়া প্রতিক্রিয়া.
- যেখানে মিথস্ক্রিয়া ঘটেছে স্থানের বাইরে কাজগুলি সম্পাদন করুন।
- চ্যাটে এমন কাজগুলি করুন যা অ্যাড-অন অ্যাকশন হিসাবে উপলব্ধ নয়। উদাহরণস্বরূপ, স্পেস তালিকাভুক্ত করুন যেগুলি একজন ব্যবহারকারী বা চ্যাট অ্যাপের সদস্য, অথবা ব্যবহারকারীদের স্পেসে যোগ করুন।
- চ্যাট ব্যবহারকারীর পক্ষে কাজগুলি সম্পাদন করুন (যার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন)।
চ্যাট API প্রমাণীকরণ এবং কল করার বিষয়ে জানতে, চ্যাট API ওভারভিউ দেখুন।
সম্পর্কিত বিষয়
- Google Workspace অ্যাড-অনগুলির জন্য ট্রিগার
- একটি Google চ্যাট অ্যাপ কনফিগার করুন
- ঘটনা বস্তু
- অ্যাড-অন অ্যাকশন
- Google চ্যাট বার্তা পাঠান
- ইন্টারেক্টিভ ডায়ালগ খুলুন
- Google চ্যাট বার্তাগুলিতে লিঙ্কগুলির পূর্বরূপ দেখুন
- চ্যাট API ওভারভিউ