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

ব্যবহারকারীর মিথস্ক্রিয়া গ্রহণ এবং প্রতিক্রিয়া

এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে আপনার Google Chat অ্যাপ ব্যবহারকারীর ইন্টারঅ্যাকশন গ্রহণ করতে এবং প্রতিক্রিয়া জানাতে পারে, Google Chat অ্যাপ ইন্টারঅ্যাকশন ইভেন্ট হিসেবেও পরিচিত।

এই পৃষ্ঠাটি কীভাবে নিম্নলিখিতগুলি করতে হয় তা বর্ণনা করে:

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন।
আপনার পরিকাঠামোতে মিথস্ক্রিয়া ইভেন্ট প্রক্রিয়া করুন।
উপযুক্ত হলে, মিথস্ক্রিয়া ইভেন্টগুলিতে সাড়া দিন।

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

Chat ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করে এমন একটি Chat অ্যাপ তৈরি করতে, আপনি একটি Google Workspace অ্যাড-অন তৈরি করতে পারেন যা Chat-কে প্রসারিত করে। চ্যাট এপিআই থেকে ইন্টারঅ্যাকশন ইভেন্টগুলি পাওয়ার পরিবর্তে, চ্যাট অ্যাপ অ্যাড-অন ইভেন্ট অবজেক্টগুলি গ্রহণ করে এবং প্রতিক্রিয়া জানায়। আরও জানতে, Google Workspace অ্যাড-অন ডকুমেন্টেশনে Google Chat প্রসারিত করুন দেখুন।

পূর্বশর্ত

একটি Google চ্যাট অ্যাপ যা ইন্টারেক্টিভ বৈশিষ্ট্যের জন্য সক্ষম। একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করতে, আপনি যে অ্যাপ আর্কিটেকচার ব্যবহার করতে চান তার উপর ভিত্তি করে নিচের একটি দ্রুত শুরু করুন:

মিথস্ক্রিয়া ইভেন্টের প্রকার

একটি Google চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্ট এমন যেকোনো পদক্ষেপকে প্রতিনিধিত্ব করে যা একজন ব্যবহারকারী একটি চ্যাট অ্যাপের সাথে যোগাযোগ করতে বা ইন্টারঅ্যাক্ট করতে করেন, যেমন একটি চ্যাট অ্যাপকে @উল্লেখ করা বা স্পেসে যোগ করা।

যখন ব্যবহারকারীরা একটি চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেন, তখন Google চ্যাট চ্যাট অ্যাপটিকে একটি ইন্টারঅ্যাকশন ইভেন্ট পাঠায়, যা চ্যাট এপিআই-এ একটি Event ধরন হিসাবে উপস্থাপন করা হয়। চ্যাট অ্যাপটি মিথস্ক্রিয়া প্রক্রিয়া করতে ইভেন্টটি ব্যবহার করতে পারে এবং ঐচ্ছিকভাবে একটি বার্তার সাথে প্রতিক্রিয়া জানাতে পারে।

প্রতিটি ধরনের ব্যবহারকারীর ইন্টারঅ্যাকশনের জন্য, Google Chat একটি ভিন্ন ধরনের ইন্টারঅ্যাকশন ইভেন্ট পাঠায় যা আপনার চ্যাট অ্যাপকে প্রতিটি ইভেন্টের ধরন অনুযায়ী পরিচালনা করতে সাহায্য করে। eventType অবজেক্ট ব্যবহার করে ইন্টারঅ্যাকশন ইভেন্টের ধরন উপস্থাপন করা হয়।

উদাহরণ স্বরূপ, Google Chat ইভেন্ট টাইপ ADDED_TO_SPACE ব্যবহার করে যেকোন ইন্টারঅ্যাকশনের জন্য যেখানে একজন ব্যবহারকারী চ্যাট অ্যাপটিকে একটি স্পেসে যোগ করে, যাতে চ্যাট অ্যাপটি স্পেসে একটি স্বাগত বার্তার সাথে সাথে সাথে প্রতিক্রিয়া জানাতে পারে।

চ্যাট অ্যাপ একটি স্বাগত বার্তা পোস্ট করে। — **চিত্র 1** : যখন একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন, তখন চ্যাট অ্যাপ একটি `ADDED_TO_SPACE` ইন্টারঅ্যাকশন ইভেন্ট পায় যা চ্যাট অ্যাপটি স্পেসে একটি স্বাগত বার্তা পাঠাতে পরিচালনা করে।

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

ব্যবহারকারীর মিথস্ক্রিয়া	`eventType`	একটি চ্যাট অ্যাপ থেকে সাধারণ প্রতিক্রিয়া
একজন ব্যবহারকারী একটি চ্যাট অ্যাপকে @উল্লেখ করে বা একটি স্ল্যাশ কমান্ড ব্যবহার করে আহ্বান করেন।	`MESSAGE`	চ্যাট অ্যাপ মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সাড়া দেয়। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপ `/about` কমান্ডের উত্তর দেয় একটি বার্তা সহ যা চ্যাট অ্যাপটি যে কাজগুলি করতে পারে তা ব্যাখ্যা করে।
একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন।	`ADDED_TO_SPACE`	চ্যাট অ্যাপটি একটি অনবোর্ডিং বার্তা পাঠায় যা ব্যাখ্যা করে যে এটি কী করে এবং কীভাবে স্পেসে ব্যবহারকারীরা এটির সাথে ইন্টারঅ্যাক্ট করতে পারে।
একজন ব্যবহারকারী একটি স্পেস থেকে একটি চ্যাট অ্যাপ সরিয়ে দেয়।	`REMOVED_FROM_SPACE`	চ্যাট অ্যাপটি স্থানের জন্য কনফিগার করা যেকোনো ইনকামিং বিজ্ঞপ্তি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং যেকোনো অভ্যন্তরীণ স্টোরেজ সাফ করে।
একজন ব্যবহারকারী চ্যাট অ্যাপ মেসেজ, ডায়ালগ বা হোমপেজ থেকে কার্ডের একটি বোতামে ক্লিক করেন।	`CARD_CLICKED`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।
একজন ব্যবহারকারী 1:1 মেসেজে হোম ট্যাবে ক্লিক করে চ্যাট অ্যাপের হোমপেজ খোলেন।	`APP_HOME`	চ্যাট অ্যাপ হোমপেজ থেকে একটি স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড ফেরত দেয়।
একজন ব্যবহারকারী চ্যাট অ্যাপের হোমপেজ থেকে একটি ফর্ম জমা দেন।	`SUBMIT_FORM`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।

সমস্ত সমর্থিত ইন্টারঅ্যাকশন ইভেন্ট দেখতে, EventType রেফারেন্স ডকুমেন্টেশন দেখুন।

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

যদি আপনার চ্যাট অ্যাপ ডায়ালগগুলি খোলে, ইন্টারঅ্যাকশন ইভেন্টে নিম্নলিখিত অতিরিক্ত তথ্য থাকে যা আপনি একটি প্রতিক্রিয়া প্রক্রিয়া করতে ব্যবহার করতে পারেন:

isDialogEvent true হিসাবে সেট করা হয়েছে।
DialogEventType স্পষ্ট করে যে ইন্টারঅ্যাকশন একটি ডায়ালগ খোলার জন্য ট্রিগার করে, একটি ডায়ালগ থেকে তথ্য জমা দেয়, বা একটি ডায়ালগ বন্ধ করে।

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

একটি ডায়ালগের সাথে ব্যবহারকারীর মিথস্ক্রিয়া	ডায়ালগ ইভেন্টের ধরন	সাধারণ প্রতিক্রিয়া
একটি ব্যবহারকারী একটি ডায়ালগ অনুরোধ ট্রিগার. উদাহরণস্বরূপ, তারা একটি স্ল্যাশ কমান্ড ব্যবহার করে বা একটি বার্তা থেকে একটি বোতামে ক্লিক করে।	`REQUEST_DIALOG`	চ্যাট অ্যাপ ডায়ালগ খোলে।
একজন ব্যবহারকারী একটি বোতামে ক্লিক করে ডায়ালগে তথ্য জমা দেন।	`SUBMIT_DIALOG`	চ্যাট অ্যাপ হয় অন্য ডায়ালগে নেভিগেট করে অথবা ইন্টারঅ্যাকশন সম্পূর্ণ করতে ডায়ালগ বন্ধ করে।
তথ্য জমা দেওয়ার আগে একজন ব্যবহারকারী ডায়ালগ থেকে প্রস্থান করে বা বন্ধ করে।	`CANCEL_DIALOG`	ঐচ্ছিকভাবে, চ্যাট অ্যাপটি একটি নতুন বার্তার সাথে প্রতিক্রিয়া জানাতে পারে, অথবা ব্যবহারকারী যে বার্তা বা কার্ডটি থেকে ডায়ালগটি খোলেন সেটি আপডেট করতে পারে৷

আরও তথ্যের জন্য, ইন্টারেক্টিভ ডায়ালগ খুলুন দেখুন।

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

এই বিভাগটি বর্ণনা করে যে কীভাবে আপনার চ্যাট অ্যাপের জন্য ইন্টারঅ্যাকশন ইভেন্টগুলি গ্রহণ করবেন এবং প্রক্রিয়া করবেন।

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

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

আপনি যে ইন্টারেক্টিভ বৈশিষ্ট্যগুলি তৈরি করতে চান তার প্রতিটির জন্য, আপনাকে অবশ্যই Chat API-এ আপনার কনফিগারেশন আপডেট করতে হবে যাতে Google Chat আপনার চ্যাট অ্যাপে সম্পর্কিত ইন্টারঅ্যাকশন ইভেন্ট পাঠাতে পারে:

Google ক্লাউড কনসোলে, চ্যাট API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:
চ্যাট API কনফিগারেশন পৃষ্ঠায় যান

ইন্টারেক্টিভ বৈশিষ্ট্যের অধীনে, আপনি যে বৈশিষ্ট্যগুলি তৈরি করতে চান তার উপর ভিত্তি করে সেটিংস পর্যালোচনা করুন এবং আপডেট করুন:

মাঠ	বর্ণনা
কার্যকারিতা	প্রয়োজন। ক্ষেত্রগুলির একটি সেট যা নির্ধারণ করে যে চ্যাট অ্যাপ কীভাবে ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করতে পারে: 1:1 বার্তা গ্রহণ করুন : ব্যবহারকারীরা সরাসরি Google Chat-এ চ্যাট অ্যাপ খুঁজে পেতে এবং বার্তা পাঠাতে পারেন। স্পেস এবং গ্রুপ কথোপকথনে যোগ দিন : ব্যবহারকারীরা স্পেস এবং গ্রুপ কথোপকথনে চ্যাট অ্যাপ যোগ করতে পারেন।
সংযোগ সেটিংস	প্রয়োজন। চ্যাট অ্যাপের শেষ পয়েন্ট, যা নিম্নলিখিতগুলির মধ্যে একটি: HTTP এন্ডপয়েন্ট URL : একটি HTTPS এন্ডপয়েন্ট যা চ্যাট অ্যাপ বাস্তবায়ন হোস্ট করে। অ্যাপস স্ক্রিপ্ট : একটি অ্যাপস স্ক্রিপ্ট প্রকল্পের জন্য একটি স্থাপনার আইডি যা একটি চ্যাট অ্যাপ প্রয়োগ করে। ক্লাউড পাব/সাব বিষয়ের নাম : একটি পাব/সাব বিষয় যা চ্যাট অ্যাপ একটি এন্ডপয়েন্ট হিসেবে সদস্যতা নেয়। ডায়ালগফ্লো : একটি ডায়ালগফ্লো ইন্টিগ্রেশন সহ চ্যাট অ্যাপ নিবন্ধন করে। আরও তথ্যের জন্য, প্রাকৃতিক ভাষা বোঝে এমন একটি ডায়ালগফ্লো Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
স্ল্যাশ কমান্ড	ঐচ্ছিক। Google Chat-এর মধ্যে ব্যবহারকারীদের কাছে প্রদর্শিত কমান্ড। ব্যবহারকারীদের Google Chat-এর মধ্যে আপনার চ্যাট অ্যাপের মূল অ্যাকশনগুলি দেখতে দেয় এবং একটি নির্দিষ্ট অ্যাকশন বেছে নিতে দেয় যার সাথে তারা ইন্টারঅ্যাক্ট করতে চায়। আরও তথ্যের জন্য, চ্যাট অ্যাপ হিসেবে স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
লিঙ্ক পূর্বরূপ	ঐচ্ছিক। ইউআরএল প্যাটার্ন যা Chat অ্যাপ চিনতে পারে এবং ব্যবহারকারীরা লিঙ্ক পাঠালে অতিরিক্ত কন্টেন্ট প্রদান করে। আরও তথ্যের জন্য, পূর্বরূপ লিঙ্কগুলি দেখুন।
দৃশ্যমানতা	ঐচ্ছিক। সর্বাধিক পাঁচজন ব্যক্তি বা এক বা একাধিক Google গ্রুপ যারা আপনার চ্যাট অ্যাপ দেখতে এবং ইনস্টল করতে পারে। আপনার চ্যাট অ্যাপ পরীক্ষা করতে বা আপনার দলের সাথে চ্যাট অ্যাপ শেয়ার করতে এই ক্ষেত্রটি ব্যবহার করুন। আরও তথ্যের জন্য, পরীক্ষা ইন্টারেক্টিভ বৈশিষ্ট্য দেখুন।

Save এ ক্লিক করুন। আপনি Chat অ্যাপ কনফিগারেশন সেভ করলে, আপনার Chat অ্যাপটি আপনার Google Workspace সংস্থার নির্দিষ্ট ব্যবহারকারীদের কাছে উপলভ্য হয়।

আপনার চ্যাট অ্যাপটি এখন Google Chat থেকে ইন্টারঅ্যাকশন ইভেন্টগুলি পাওয়ার জন্য কনফিগার করা হয়েছে।

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

যদি আপনার পরিষেবার জন্য একটি HTTPS অনুরোধ ব্যর্থ হয় (যেমন একটি টাইমআউট, অস্থায়ী নেটওয়ার্ক ব্যর্থতা, বা নন-2xx HTTPS স্ট্যাটাস কোড), Google Chat কয়েক মিনিটের মধ্যে কয়েকবার ডেলিভারি করার চেষ্টা করতে পারে (কিন্তু এটি নিশ্চিত নয়)। ফলস্বরূপ, একটি চ্যাট অ্যাপ নির্দিষ্ট পরিস্থিতিতে কয়েকবার একই বার্তা পেতে পারে। যদি অনুরোধটি সফলভাবে সম্পন্ন হয় কিন্তু একটি অবৈধ মেসেজ পেলোড ফেরত দেয়, Google Chat অনুরোধটি আবার চেষ্টা করে না।

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

এই বিভাগটি ব্যাখ্যা করে যে কীভাবে Google Chat অ্যাপগুলি ইন্টারঅ্যাকশন ইভেন্টগুলি প্রক্রিয়া করতে এবং প্রতিক্রিয়া জানাতে পারে।

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

সিঙ্ক্রোনাসভাবে প্রতিক্রিয়া জানাতে, একটি চ্যাট অ্যাপকে অবশ্যই 30 সেকেন্ডের মধ্যে প্রতিক্রিয়া জানাতে হবে এবং প্রতিক্রিয়াটি অবশ্যই সেই জায়গায় পোস্ট করতে হবে যেখানে মিথস্ক্রিয়াটি ঘটেছে। অন্যথায়, চ্যাট অ্যাপ অ্যাসিঙ্ক্রোনাসভাবে প্রতিক্রিয়া জানাতে পারে।

প্রতিটি ইন্টারঅ্যাকশন ইভেন্টের জন্য, চ্যাট অ্যাপগুলি একটি রিকোয়েস্ট বডি পায়, যা ইভেন্টের প্রতিনিধিত্ব করে JSON পেলোড। আপনি একটি প্রতিক্রিয়া প্রক্রিয়া করতে তথ্য ব্যবহার করতে পারেন. ইভেন্ট পেলোডের উদাহরণের জন্য, চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টের প্রকার দেখুন।

নিম্নলিখিত চিত্রটি দেখায় যে কীভাবে Google Chat অ্যাপ সাধারণত বিভিন্ন ধরনের ইন্টারঅ্যাকশন ইভেন্ট প্রক্রিয়া করে বা প্রতিক্রিয়া জানায়:

Google Chat অ্যাপ কীভাবে ইন্টারঅ্যাকশন ইভেন্ট প্রক্রিয়া করে তার আর্কিটেকচার।

রিয়েল টাইমে সাড়া দিন

ইন্টারঅ্যাকশন ইভেন্টগুলি চ্যাট অ্যাপগুলিকে রিয়েল টাইমে বা সিঙ্ক্রোনাসভাবে প্রতিক্রিয়া জানাতে দেয়৷ সিঙ্ক্রোনাস প্রতিক্রিয়াগুলির প্রমাণীকরণের প্রয়োজন হয় না৷

রিয়েল টাইমে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপটিকে অবশ্যই একটি Message বস্তু ফেরত দিতে হবে। স্পেসে একটি বার্তার সাথে উত্তর দিতে , Message বস্তুটিতে text , cardsV2 , এবং accessoryWidgets বস্তু থাকতে পারে৷ অন্যান্য ধরণের প্রতিক্রিয়াগুলির সাথে ব্যবহার করতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

একটি বার্তা দিয়ে উত্তর দিন

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

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

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

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

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

কোড নমুনা নিম্নলিখিত পাঠ্য বার্তা প্রদান করে:

অনবোর্ডিং বার্তার উদাহরণ।

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

কখনও কখনও চ্যাট অ্যাপগুলিকে অবশ্যই 30 সেকেন্ড পরে একটি ইন্টারঅ্যাকশন ইভেন্টে প্রতিক্রিয়া জানাতে হবে বা ইন্টারঅ্যাকশন ইভেন্টটি তৈরি করা হয়েছে এমন স্থানের বাইরে কাজগুলি সম্পাদন করতে হবে। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপকে একটি দীর্ঘ-চলমান কাজ শেষ করার পরে ব্যবহারকারীকে প্রতিক্রিয়া জানাতে হতে পারে। এই ক্ষেত্রে, চ্যাট অ্যাপগুলি Google Chat API-কে কল করে অ্যাসিঙ্ক্রোনাসভাবে প্রতিক্রিয়া জানাতে পারে।

চ্যাট API ব্যবহার করে একটি বার্তা তৈরি করতে, একটি বার্তা তৈরি করুন দেখুন। অতিরিক্ত চ্যাট এপিআই পদ্ধতি ব্যবহার করার জন্য গাইডের জন্য, চ্যাট এপিআই ওভারভিউ দেখুন।

এই পৃষ্ঠাটি কীভাবে নিম্নলিখিতগুলি করতে হয় তা বর্ণনা করে:

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন।
আপনার পরিকাঠামোতে মিথস্ক্রিয়া ইভেন্ট প্রক্রিয়া করুন।
উপযুক্ত হলে, মিথস্ক্রিয়া ইভেন্টগুলিতে সাড়া দিন।

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

পূর্বশর্ত

মিথস্ক্রিয়া ইভেন্টের প্রকার

ব্যবহারকারীর মিথস্ক্রিয়া	`eventType`	একটি চ্যাট অ্যাপ থেকে সাধারণ প্রতিক্রিয়া
একজন ব্যবহারকারী একটি চ্যাট অ্যাপকে @উল্লেখ করে বা একটি স্ল্যাশ কমান্ড ব্যবহার করে আহ্বান করেন।	`MESSAGE`	চ্যাট অ্যাপ মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সাড়া দেয়। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপ `/about` কমান্ডের উত্তর দেয় একটি বার্তা সহ যা চ্যাট অ্যাপটি যে কাজগুলি করতে পারে তা ব্যাখ্যা করে।
একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন।	`ADDED_TO_SPACE`	চ্যাট অ্যাপটি একটি অনবোর্ডিং বার্তা পাঠায় যা ব্যাখ্যা করে যে এটি কী করে এবং কীভাবে স্পেসে ব্যবহারকারীরা এটির সাথে ইন্টারঅ্যাক্ট করতে পারে।
একজন ব্যবহারকারী একটি স্পেস থেকে একটি চ্যাট অ্যাপ সরিয়ে দেয়।	`REMOVED_FROM_SPACE`	চ্যাট অ্যাপটি স্থানের জন্য কনফিগার করা যেকোনো ইনকামিং বিজ্ঞপ্তি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং যেকোনো অভ্যন্তরীণ স্টোরেজ সাফ করে।
একজন ব্যবহারকারী চ্যাট অ্যাপ মেসেজ, ডায়ালগ বা হোমপেজ থেকে কার্ডের একটি বোতামে ক্লিক করেন।	`CARD_CLICKED`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।
একজন ব্যবহারকারী 1:1 মেসেজে হোম ট্যাবে ক্লিক করে চ্যাট অ্যাপের হোমপেজ খোলেন।	`APP_HOME`	চ্যাট অ্যাপ হোমপেজ থেকে একটি স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড ফেরত দেয়।
একজন ব্যবহারকারী চ্যাট অ্যাপের হোমপেজ থেকে একটি ফর্ম জমা দেন।	`SUBMIT_FORM`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

isDialogEvent true হিসাবে সেট করা হয়েছে।
DialogEventType স্পষ্ট করে যে ইন্টারঅ্যাকশন একটি ডায়ালগ খোলার জন্য ট্রিগার করে, একটি ডায়ালগ থেকে তথ্য জমা দেয়, বা একটি ডায়ালগ বন্ধ করে।

একটি ডায়ালগের সাথে ব্যবহারকারীর মিথস্ক্রিয়া	ডায়ালগ ইভেন্টের ধরন	সাধারণ প্রতিক্রিয়া
একটি ব্যবহারকারী একটি ডায়ালগ অনুরোধ ট্রিগার. উদাহরণস্বরূপ, তারা একটি স্ল্যাশ কমান্ড ব্যবহার করে বা একটি বার্তা থেকে একটি বোতামে ক্লিক করে।	`REQUEST_DIALOG`	চ্যাট অ্যাপ ডায়ালগ খোলে।
একজন ব্যবহারকারী একটি বোতামে ক্লিক করে ডায়ালগে তথ্য জমা দেন।	`SUBMIT_DIALOG`	চ্যাট অ্যাপ হয় অন্য ডায়ালগে নেভিগেট করে অথবা ইন্টারঅ্যাকশন সম্পূর্ণ করতে ডায়ালগ বন্ধ করে।
তথ্য জমা দেওয়ার আগে একজন ব্যবহারকারী ডায়ালগ থেকে প্রস্থান করে বা বন্ধ করে।	`CANCEL_DIALOG`	ঐচ্ছিকভাবে, চ্যাট অ্যাপটি একটি নতুন বার্তার সাথে প্রতিক্রিয়া জানাতে পারে, অথবা ব্যবহারকারী যে বার্তা বা কার্ডটি থেকে ডায়ালগটি খোলেন সেটি আপডেট করতে পারে৷

আরও তথ্যের জন্য, ইন্টারেক্টিভ ডায়ালগ খুলুন দেখুন।

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

Google ক্লাউড কনসোলে, চ্যাট API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:
চ্যাট API কনফিগারেশন পৃষ্ঠায় যান

মাঠ	বর্ণনা
কার্যকারিতা	প্রয়োজন। ক্ষেত্রগুলির একটি সেট যা নির্ধারণ করে যে চ্যাট অ্যাপ কীভাবে ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করতে পারে: 1:1 বার্তা গ্রহণ করুন : ব্যবহারকারীরা সরাসরি Google Chat-এ চ্যাট অ্যাপ খুঁজে পেতে এবং বার্তা পাঠাতে পারেন। স্পেস এবং গ্রুপ কথোপকথনে যোগ দিন : ব্যবহারকারীরা স্পেস এবং গ্রুপ কথোপকথনে চ্যাট অ্যাপ যোগ করতে পারেন।
সংযোগ সেটিংস	প্রয়োজন। চ্যাট অ্যাপের শেষ পয়েন্ট, যা নিম্নলিখিতগুলির মধ্যে একটি: HTTP এন্ডপয়েন্ট URL : একটি HTTPS এন্ডপয়েন্ট যা চ্যাট অ্যাপ বাস্তবায়ন হোস্ট করে। অ্যাপস স্ক্রিপ্ট : একটি অ্যাপস স্ক্রিপ্ট প্রকল্পের জন্য একটি স্থাপনার আইডি যা একটি চ্যাট অ্যাপ প্রয়োগ করে। ক্লাউড পাব/সাব বিষয়ের নাম : একটি পাব/সাব বিষয় যা চ্যাট অ্যাপ একটি এন্ডপয়েন্ট হিসেবে সদস্যতা নেয়। ডায়ালগফ্লো : একটি ডায়ালগফ্লো ইন্টিগ্রেশন সহ চ্যাট অ্যাপ নিবন্ধন করে। আরও তথ্যের জন্য, প্রাকৃতিক ভাষা বোঝে এমন একটি ডায়ালগফ্লো Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
স্ল্যাশ কমান্ড	ঐচ্ছিক। Google Chat-এর মধ্যে ব্যবহারকারীদের কাছে প্রদর্শিত কমান্ড। ব্যবহারকারীদের Google Chat-এর মধ্যে আপনার চ্যাট অ্যাপের মূল অ্যাকশনগুলি দেখতে দেয় এবং একটি নির্দিষ্ট অ্যাকশন বেছে নিতে দেয় যার সাথে তারা ইন্টারঅ্যাক্ট করতে চায়। আরও তথ্যের জন্য, চ্যাট অ্যাপ হিসেবে স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
লিঙ্ক পূর্বরূপ	ঐচ্ছিক। ইউআরএল প্যাটার্ন যা Chat অ্যাপ চিনতে পারে এবং ব্যবহারকারীরা লিঙ্ক পাঠালে অতিরিক্ত কন্টেন্ট প্রদান করে। আরও তথ্যের জন্য, পূর্বরূপ লিঙ্কগুলি দেখুন।
দৃশ্যমানতা	ঐচ্ছিক। সর্বাধিক পাঁচজন ব্যক্তি বা এক বা একাধিক Google গ্রুপ যারা আপনার চ্যাট অ্যাপ দেখতে এবং ইনস্টল করতে পারে। আপনার চ্যাট অ্যাপ পরীক্ষা করতে বা আপনার দলের সাথে চ্যাট অ্যাপ শেয়ার করতে এই ক্ষেত্রটি ব্যবহার করুন। আরও তথ্যের জন্য, পরীক্ষা ইন্টারেক্টিভ বৈশিষ্ট্য দেখুন।

Save এ ক্লিক করুন। আপনি Chat অ্যাপ কনফিগারেশন সেভ করলে, আপনার Chat অ্যাপটি আপনার Google Workspace সংস্থার নির্দিষ্ট ব্যবহারকারীদের কাছে উপলভ্য হয়।

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

Google Chat অ্যাপ কীভাবে ইন্টারঅ্যাকশন ইভেন্ট প্রক্রিয়া করে তার আর্কিটেকচার।

রিয়েল টাইমে সাড়া দিন

একটি বার্তা দিয়ে উত্তর দিন

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

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

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

কোড নমুনা নিম্নলিখিত পাঠ্য বার্তা প্রদান করে:

অনবোর্ডিং বার্তার উদাহরণ।

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

এই পৃষ্ঠাটি কীভাবে নিম্নলিখিতগুলি করতে হয় তা বর্ণনা করে:

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন।
আপনার পরিকাঠামোতে মিথস্ক্রিয়া ইভেন্ট প্রক্রিয়া করুন।
উপযুক্ত হলে, মিথস্ক্রিয়া ইভেন্টগুলিতে সাড়া দিন।

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

পূর্বশর্ত

মিথস্ক্রিয়া ইভেন্টের প্রকার

ব্যবহারকারীর মিথস্ক্রিয়া	`eventType`	একটি চ্যাট অ্যাপ থেকে সাধারণ প্রতিক্রিয়া
একজন ব্যবহারকারী একটি চ্যাট অ্যাপকে @উল্লেখ করে বা একটি স্ল্যাশ কমান্ড ব্যবহার করে আহ্বান করেন।	`MESSAGE`	চ্যাট অ্যাপ মেসেজের বিষয়বস্তুর উপর ভিত্তি করে সাড়া দেয়। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপ `/about` কমান্ডের উত্তর দেয় একটি বার্তা সহ যা চ্যাট অ্যাপটি যে কাজগুলি করতে পারে তা ব্যাখ্যা করে।
একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করেন।	`ADDED_TO_SPACE`	চ্যাট অ্যাপটি একটি অনবোর্ডিং বার্তা পাঠায় যা ব্যাখ্যা করে যে এটি কী করে এবং কীভাবে স্পেসে ব্যবহারকারীরা এটির সাথে ইন্টারঅ্যাক্ট করতে পারে।
একজন ব্যবহারকারী একটি স্পেস থেকে একটি চ্যাট অ্যাপ সরিয়ে দেয়।	`REMOVED_FROM_SPACE`	চ্যাট অ্যাপটি স্থানের জন্য কনফিগার করা যেকোনো ইনকামিং বিজ্ঞপ্তি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং যেকোনো অভ্যন্তরীণ স্টোরেজ সাফ করে।
একজন ব্যবহারকারী চ্যাট অ্যাপ মেসেজ, ডায়ালগ বা হোমপেজ থেকে কার্ডের একটি বোতামে ক্লিক করেন।	`CARD_CLICKED`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।
একজন ব্যবহারকারী 1:1 মেসেজে হোম ট্যাবে ক্লিক করে চ্যাট অ্যাপের হোমপেজ খোলেন।	`APP_HOME`	চ্যাট অ্যাপ হোমপেজ থেকে একটি স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড ফেরত দেয়।
একজন ব্যবহারকারী চ্যাট অ্যাপের হোমপেজ থেকে একটি ফর্ম জমা দেন।	`SUBMIT_FORM`	চ্যাট অ্যাপ হয় ব্যবহারকারীর জমা দেওয়া ডেটা প্রসেস ও স্টোর করে বা অন্য কার্ড ফেরত দেয়।

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

isDialogEvent true হিসাবে সেট করা হয়েছে।
DialogEventType স্পষ্ট করে যে ইন্টারঅ্যাকশন একটি ডায়ালগ খোলার জন্য ট্রিগার করে, একটি ডায়ালগ থেকে তথ্য জমা দেয়, বা একটি ডায়ালগ বন্ধ করে।

একটি ডায়ালগের সাথে ব্যবহারকারীর মিথস্ক্রিয়া	ডায়ালগ ইভেন্টের ধরন	সাধারণ প্রতিক্রিয়া
একটি ব্যবহারকারী একটি ডায়ালগ অনুরোধ ট্রিগার. উদাহরণস্বরূপ, তারা একটি স্ল্যাশ কমান্ড ব্যবহার করে বা একটি বার্তা থেকে একটি বোতামে ক্লিক করে।	`REQUEST_DIALOG`	চ্যাট অ্যাপ ডায়ালগ খোলে।
একজন ব্যবহারকারী একটি বোতামে ক্লিক করে ডায়ালগে তথ্য জমা দেন।	`SUBMIT_DIALOG`	চ্যাট অ্যাপ হয় অন্য ডায়ালগে নেভিগেট করে অথবা ইন্টারঅ্যাকশন সম্পূর্ণ করতে ডায়ালগ বন্ধ করে।
তথ্য জমা দেওয়ার আগে একজন ব্যবহারকারী ডায়ালগ থেকে প্রস্থান করে বা বন্ধ করে।	`CANCEL_DIALOG`	ঐচ্ছিকভাবে, চ্যাট অ্যাপটি একটি নতুন বার্তার সাথে প্রতিক্রিয়া জানাতে পারে, অথবা ব্যবহারকারী যে বার্তা বা কার্ডটি থেকে ডায়ালগটি খোলেন সেটি আপডেট করতে পারে৷

আরও তথ্যের জন্য, ইন্টারেক্টিভ ডায়ালগ খুলুন দেখুন।

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

Google ক্লাউড কনসোলে, চ্যাট API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:
চ্যাট API কনফিগারেশন পৃষ্ঠায় যান

মাঠ	বর্ণনা
কার্যকারিতা	প্রয়োজন। ক্ষেত্রগুলির একটি সেট যা নির্ধারণ করে যে চ্যাট অ্যাপ কীভাবে ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করতে পারে: 1:1 বার্তা গ্রহণ করুন : ব্যবহারকারীরা সরাসরি Google Chat-এ চ্যাট অ্যাপ খুঁজে পেতে এবং বার্তা পাঠাতে পারেন। স্পেস এবং গ্রুপ কথোপকথনে যোগ দিন : ব্যবহারকারীরা স্পেস এবং গ্রুপ কথোপকথনে চ্যাট অ্যাপ যোগ করতে পারেন।
সংযোগ সেটিংস	প্রয়োজন। চ্যাট অ্যাপের শেষ পয়েন্ট, যা নিম্নলিখিতগুলির মধ্যে একটি: HTTP এন্ডপয়েন্ট URL : একটি HTTPS এন্ডপয়েন্ট যা চ্যাট অ্যাপ বাস্তবায়ন হোস্ট করে। অ্যাপস স্ক্রিপ্ট : একটি অ্যাপস স্ক্রিপ্ট প্রকল্পের জন্য একটি স্থাপনার আইডি যা একটি চ্যাট অ্যাপ প্রয়োগ করে। ক্লাউড পাব/সাব বিষয়ের নাম : একটি পাব/সাব বিষয় যা চ্যাট অ্যাপ একটি এন্ডপয়েন্ট হিসেবে সদস্যতা নেয়। ডায়ালগফ্লো : একটি ডায়ালগফ্লো ইন্টিগ্রেশন সহ চ্যাট অ্যাপ নিবন্ধন করে। আরও তথ্যের জন্য, প্রাকৃতিক ভাষা বোঝে এমন একটি ডায়ালগফ্লো Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
স্ল্যাশ কমান্ড	ঐচ্ছিক। Google Chat-এর মধ্যে ব্যবহারকারীদের কাছে প্রদর্শিত কমান্ড। ব্যবহারকারীদের Google Chat-এর মধ্যে আপনার চ্যাট অ্যাপের মূল অ্যাকশনগুলি দেখতে দেয় এবং একটি নির্দিষ্ট অ্যাকশন বেছে নিতে দেয় যার সাথে তারা ইন্টারঅ্যাক্ট করতে চায়। আরও তথ্যের জন্য, চ্যাট অ্যাপ হিসেবে স্ল্যাশ কমান্ডের প্রতিক্রিয়া দেখুন।
লিঙ্ক পূর্বরূপ	ঐচ্ছিক। ইউআরএল প্যাটার্ন যা Chat অ্যাপ চিনতে পারে এবং ব্যবহারকারীরা লিঙ্ক পাঠালে অতিরিক্ত কন্টেন্ট প্রদান করে। আরও তথ্যের জন্য, পূর্বরূপ লিঙ্কগুলি দেখুন।
দৃশ্যমানতা	ঐচ্ছিক। সর্বাধিক পাঁচজন ব্যক্তি বা এক বা একাধিক Google গ্রুপ যারা আপনার চ্যাট অ্যাপ দেখতে এবং ইনস্টল করতে পারে। আপনার চ্যাট অ্যাপ পরীক্ষা করতে বা আপনার দলের সাথে চ্যাট অ্যাপ শেয়ার করতে এই ক্ষেত্রটি ব্যবহার করুন। আরও তথ্যের জন্য, পরীক্ষা ইন্টারেক্টিভ বৈশিষ্ট্য দেখুন।

Save এ ক্লিক করুন। আপনি Chat অ্যাপ কনফিগারেশন সেভ করলে, আপনার Chat অ্যাপটি আপনার Google Workspace সংস্থার নির্দিষ্ট ব্যবহারকারীদের কাছে উপলভ্য হয়।

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

Google Chat অ্যাপ কীভাবে ইন্টারঅ্যাকশন ইভেন্ট প্রক্রিয়া করে তার আর্কিটেকচার।

রিয়েল টাইমে সাড়া দিন

একটি বার্তা দিয়ে উত্তর দিন

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

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

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

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

কোড নমুনা নিম্নলিখিত পাঠ্য বার্তা প্রদান করে:

অনবোর্ডিং বার্তার উদাহরণ।

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

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

চ্যাট এপিআই ব্যবহার করে একটি বার্তা তৈরি করতে, একটি বার্তা তৈরি করুন । অতিরিক্ত চ্যাট এপিআই পদ্ধতিগুলি ব্যবহার করার জন্য গাইডের জন্য, চ্যাট এপিআই ওভারভিউ দেখুন।

এই পৃষ্ঠাটি বর্ণনা করে যে আপনার গুগল চ্যাট অ্যাপ্লিকেশনটি কীভাবে ব্যবহারকারীর ইন্টারঅ্যাকশনগুলিতে গ্রহণ করতে এবং প্রতিক্রিয়া জানাতে পারে, এটি গুগল চ্যাট অ্যাপ্লিকেশন ইন্টারঅ্যাকশন ইভেন্ট হিসাবেও পরিচিত।

এই পৃষ্ঠাটি নিম্নলিখিতগুলি কীভাবে করবেন তা বর্ণনা করে:

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপটি কনফিগার করুন।
আপনার অবকাঠামোতে ইন্টারঅ্যাকশন ইভেন্টটি প্রক্রিয়া করুন।
যদি উপযুক্ত হয় তবে ইন্টারঅ্যাকশন ইভেন্টগুলিতে সাড়া দিন।

গুগল ওয়ার্কস্পেস অ্যাড-অন হিসাবে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ্লিকেশন তৈরি করুন

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

পূর্বশর্ত

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

ইন্টারঅ্যাকশন ইভেন্টের প্রকার

একটি গুগল চ্যাট অ্যাপ্লিকেশন ইন্টারঅ্যাকশন ইভেন্ট কোনও চ্যাট অ্যাপ্লিকেশনটির সাথে অনুরোধ বা ইন্টারঅ্যাক্ট করতে ব্যবহারকারী যে কোনও ক্রিয়াকলাপকে প্রতিনিধিত্ব করে, যেমন কোনও চ্যাট অ্যাপ্লিকেশনটি ব্যবহার করা বা এটি কোনও জায়গাতে যুক্ত করা।

ব্যবহারকারীরা যখন কোনও চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেন, গুগল চ্যাট চ্যাট অ্যাপটিকে একটি ইন্টারঅ্যাকশন ইভেন্ট প্রেরণ করে, যা চ্যাট এপিআইতে Event ধরণ হিসাবে প্রতিনিধিত্ব করে। চ্যাট অ্যাপ্লিকেশনটি ইন্টারঅ্যাকশনটি প্রক্রিয়া করতে ইভেন্টটি ব্যবহার করতে পারে এবং ally চ্ছিকভাবে একটি বার্তা দিয়ে প্রতিক্রিয়া জানায়।

প্রতিটি ধরণের ব্যবহারকারীর মিথস্ক্রিয়াটির জন্য, গুগল চ্যাট একটি ভিন্ন ধরণের ইন্টারঅ্যাকশন ইভেন্ট প্রেরণ করে যা আপনার চ্যাট অ্যাপ্লিকেশনটিকে সেই অনুযায়ী প্রতিটি ইভেন্টের ধরণ পরিচালনা করতে সহায়তা করে। ইন্টারঅ্যাকশন ইভেন্টের ধরণটি eventType অবজেক্টটি ব্যবহার করে প্রতিনিধিত্ব করা হয়।

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

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

ব্যবহারকারীর মিথস্ক্রিয়া	`eventType`	একটি চ্যাট অ্যাপ্লিকেশন থেকে সাধারণ প্রতিক্রিয়া
একজন ব্যবহারকারী @mentioning বা স্ল্যাশ কমান্ড ব্যবহার করে একটি চ্যাট অ্যাপ্লিকেশন প্রার্থনা করে।	`MESSAGE`	চ্যাট অ্যাপ্লিকেশন বার্তার সামগ্রীর ভিত্তিতে সাড়া দেয়। উদাহরণস্বরূপ, একটি চ্যাট অ্যাপ্লিকেশন `/about` কমান্ডের সাথে একটি বার্তা সহ জবাব দেয় যা চ্যাট অ্যাপটি করতে পারে এমন কাজগুলি ব্যাখ্যা করে।
একজন ব্যবহারকারী একটি স্পেসে একটি চ্যাট অ্যাপ্লিকেশন যুক্ত করে।	`ADDED_TO_SPACE`	চ্যাট অ্যাপ্লিকেশনটি একটি অনবোর্ডিং বার্তা প্রেরণ করে যা এটি কী করে এবং স্পেসের ব্যবহারকারীরা কীভাবে এটির সাথে ইন্টারঅ্যাক্ট করতে পারে তা ব্যাখ্যা করে।
একজন ব্যবহারকারী কোনও স্থান থেকে একটি চ্যাট অ্যাপ্লিকেশন সরিয়ে দেয়।	`REMOVED_FROM_SPACE`	চ্যাট অ্যাপটি স্পেসের জন্য কনফিগার করা কোনও আগত বিজ্ঞপ্তিগুলি সরিয়ে দেয় (যেমন একটি ওয়েবহুক মুছে ফেলা) এবং কোনও অভ্যন্তরীণ স্টোরেজ সাফ করে।
একজন ব্যবহারকারী চ্যাট অ্যাপ্লিকেশন বার্তা, ডায়ালগ বা হোমপেজ থেকে কোনও কার্ডে একটি বোতাম ক্লিক করে।	`CARD_CLICKED`	চ্যাট অ্যাপটি হয় ব্যবহারকারী জমা দেওয়া কোনও ডেটা প্রক্রিয়া করে এবং সঞ্চয় করে বা অন্য কার্ড দেয়।
একজন ব্যবহারকারী 1: 1 বার্তায় হোম ট্যাবে ক্লিক করে চ্যাট অ্যাপ্লিকেশনটির হোমপেজটি খোলেন।	`APP_HOME`	চ্যাট অ্যাপ্লিকেশন হোমপেজ থেকে একটি স্ট্যাটিক বা ইন্টারেক্টিভ কার্ড প্রদান করে।
একজন ব্যবহারকারী চ্যাট অ্যাপের হোমপেজ থেকে একটি ফর্ম জমা দেয়।	`SUBMIT_FORM`	চ্যাট অ্যাপটি হয় ব্যবহারকারী জমা দেওয়া কোনও ডেটা প্রক্রিয়া করে এবং সঞ্চয় করে বা অন্য কার্ড দেয়।

সমস্ত সমর্থিত ইন্টারঅ্যাকশন ইভেন্টগুলি দেখতে, EventType রেফারেন্স ডকুমেন্টেশন দেখুন।

ডায়ালগগুলি থেকে ইন্টারঅ্যাকশন ইভেন্টগুলি

যদি আপনার চ্যাট অ্যাপটি ডায়ালগগুলি খোলে তবে ইন্টারঅ্যাকশন ইভেন্টে নিম্নলিখিত অতিরিক্ত তথ্য রয়েছে যা আপনি প্রতিক্রিয়া প্রক্রিয়া করতে ব্যবহার করতে পারেন:

isDialogEvent true সেট করা আছে।
DialogEventType স্পষ্ট করে যে মিথস্ক্রিয়াটি কোনও কথোপকথনটি খোলার জন্য ট্রিগার করে, কোনও ডায়ালগ থেকে তথ্য জমা দেয় বা কোনও ডায়ালগ বন্ধ করে দেয় কিনা তা স্পষ্ট করে।

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

একটি ডায়ালগের সাথে ব্যবহারকারীর মিথস্ক্রিয়া	ডায়ালগ ইভেন্টের ধরণ	সাধারণ প্রতিক্রিয়া
একজন ব্যবহারকারী একটি ডায়ালগ অনুরোধ ট্রিগার করে। উদাহরণস্বরূপ, তারা একটি স্ল্যাশ কমান্ড ব্যবহার করে বা কোনও বার্তা থেকে একটি বোতাম ক্লিক করে।	`REQUEST_DIALOG`	চ্যাট অ্যাপটি ডায়ালগটি খোলে।
একজন ব্যবহারকারী একটি বোতাম ক্লিক করে ডায়ালগে তথ্য জমা দেয়।	`SUBMIT_DIALOG`	চ্যাট অ্যাপটি হয় অন্য ডায়ালগে নেভিগেট করে বা ইন্টারঅ্যাকশনটি সম্পূর্ণ করতে ডায়ালগটি বন্ধ করে দেয়।
কোনও ব্যবহারকারী তথ্য জমা দেওয়ার আগে ডায়ালগটি প্রস্থান বা বন্ধ করে দেয়।	`CANCEL_DIALOG`	Ally চ্ছিকভাবে, চ্যাট অ্যাপ্লিকেশনটি একটি নতুন বার্তা দিয়ে প্রতিক্রিয়া জানাতে পারে, বা বার্তা বা কার্ড আপডেট করতে পারে যা থেকে ব্যবহারকারী ডায়ালগটি খুলেছে।

আরও তথ্যের জন্য, ওপেন ইন্টারেক্টিভ ডায়ালগগুলি দেখুন।

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

এই বিভাগটি কীভাবে আপনার চ্যাট অ্যাপের জন্য ইন্টারঅ্যাকশন ইভেন্টগুলি গ্রহণ এবং প্রক্রিয়া করবেন তা বর্ণনা করে।

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপটি কনফিগার করুন

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

আপনি যে প্রতিটি ইন্টারেক্টিভ বৈশিষ্ট্য তৈরি করতে চান তার জন্য আপনাকে অবশ্যই চ্যাট এপিআইতে আপনার কনফিগারেশনটি আপডেট করতে হবে যাতে গুগল চ্যাট আপনার চ্যাট অ্যাপ্লিকেশনটিতে সম্পর্কিত ইন্টারঅ্যাকশন ইভেন্টগুলি প্রেরণ করতে পারে:

গুগল ক্লাউড কনসোলে, চ্যাট এপিআই পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:
চ্যাট এপিআই কনফিগারেশন পৃষ্ঠাতে যান

ইন্টারেক্টিভ বৈশিষ্ট্যগুলির অধীনে, আপনি যে বৈশিষ্ট্যগুলি তৈরি করতে চান তার উপর ভিত্তি করে সেটিংস এবং আপডেট পর্যালোচনা করুন:

মাঠ	বর্ণনা
কার্যকারিতা	প্রয়োজন। ক্ষেত্রগুলির একটি সেট যা চ্যাট অ্যাপ্লিকেশন ব্যবহারকারীদের সাথে কীভাবে যোগাযোগ করতে পারে তা নির্ধারণ করে: 1: 1 বার্তা গ্রহণ করুন : ব্যবহারকারীরা সরাসরি গুগল চ্যাটে চ্যাট অ্যাপটি সন্ধান এবং বার্তা দিতে পারেন। স্পেস এবং গ্রুপ কথোপকথনে যোগদান করুন : ব্যবহারকারীরা স্পেস এবং গ্রুপ কথোপকথনে চ্যাট অ্যাপ্লিকেশন যুক্ত করতে পারে।
সংযোগ সেটিংস	প্রয়োজন। চ্যাট অ্যাপের শেষ পয়েন্ট, যা নিম্নলিখিতগুলির মধ্যে একটি: এইচটিটিপি এন্ডপয়েন্ট পয়েন্ট ইউআরএল : একটি এইচটিটিপিএস এন্ডপয়েন্ট যা চ্যাট অ্যাপ্লিকেশন বাস্তবায়নের হোস্ট করে। অ্যাপ্লিকেশন স্ক্রিপ্ট : একটি অ্যাপস স্ক্রিপ্ট প্রকল্পের জন্য একটি ডিপ্লোয়মেন্ট আইডি যা একটি চ্যাট অ্যাপ্লিকেশন প্রয়োগ করে। ক্লাউড পাব/সাব বিষয়ের নাম : একটি পাব/সাব বিষয় যা চ্যাট অ্যাপ্লিকেশনটি একটি শেষ পয়েন্ট হিসাবে সাবস্ক্রাইব করে। ডায়ালগফ্লো : একটি ডায়ালগফ্লো ইন্টিগ্রেশন সহ চ্যাট অ্যাপ্লিকেশনটি নিবন্ধিত করে। আরও তথ্যের জন্য, একটি ডায়ালগফ্লো গুগল চ্যাট অ্যাপ্লিকেশন তৈরি করুন যা প্রাকৃতিক ভাষা বোঝে ।
স্ল্যাশ কমান্ড	ঐচ্ছিক। কমান্ডগুলি যা গুগল চ্যাটের মধ্যে ব্যবহারকারীদের কাছে প্রকাশিত হতে পারে। ব্যবহারকারীদের গুগল চ্যাটের মধ্যে আপনার চ্যাট অ্যাপের জন্য মূল ক্রিয়াগুলি দেখতে এবং তাদের সাথে ইন্টারঅ্যাক্ট করতে চান এমন একটি নির্দিষ্ট ক্রিয়া চয়ন করার অনুমতি দেয়। আরও তথ্যের জন্য, চ্যাট অ্যাপ হিসাবে স্ল্যাশ কমান্ডগুলিতে প্রতিক্রিয়া দেখুন।
লিঙ্ক পূর্বরূপ	ঐচ্ছিক। ইউআরএল নিদর্শনগুলি যা চ্যাট অ্যাপটি স্বীকৃতি দেয় এবং ব্যবহারকারীরা যখন লিঙ্কগুলি প্রেরণ করে তার জন্য অতিরিক্ত সামগ্রী সরবরাহ করে। আরও তথ্যের জন্য, পূর্বরূপ লিঙ্কগুলি দেখুন।
দৃশ্যমানতা	ঐচ্ছিক। পাঁচ জন ব্যক্তি, বা এক বা একাধিক গুগল গ্রুপ যা আপনার চ্যাট অ্যাপটি দেখতে এবং ইনস্টল করতে পারে। আপনার চ্যাট অ্যাপ্লিকেশনটি পরীক্ষা করতে বা আপনার দলের সাথে চ্যাট অ্যাপটি ভাগ করতে এই ক্ষেত্রটি ব্যবহার করুন। আরও তথ্যের জন্য, পরীক্ষার ইন্টারেক্টিভ বৈশিষ্ট্যগুলি দেখুন।

Save এ ক্লিক করুন। আপনি যখন চ্যাট অ্যাপ্লিকেশন কনফিগারেশন সংরক্ষণ করেন, আপনার চ্যাট অ্যাপ্লিকেশনটি আপনার গুগল ওয়ার্কস্পেস সংস্থার নির্দিষ্ট ব্যবহারকারীদের কাছে উপলব্ধ।

আপনার চ্যাট অ্যাপটি এখন গুগল চ্যাট থেকে ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে কনফিগার করা হয়েছে।

আপনার পরিষেবাটিতে HTTP কলটি পুনরায় চেষ্টা করুন

যদি আপনার পরিষেবাতে কোনও এইচটিটিপিএস অনুরোধ ব্যর্থ হয় (যেমন একটি টাইমআউট, অস্থায়ী নেটওয়ার্ক ব্যর্থতা, বা নন -2xx এইচটিটিপিএস স্ট্যাটাস কোড), গুগল চ্যাট কয়েক মিনিটের মধ্যে কয়েকবার বিতরণ পুনরায় চেষ্টা করতে পারে (তবে এটি গ্যারান্টিযুক্ত নয়)। ফলস্বরূপ, একটি চ্যাট অ্যাপ্লিকেশন নির্দিষ্ট পরিস্থিতিতে কয়েকবার একই বার্তা পেতে পারে। যদি অনুরোধটি সফলভাবে শেষ হয় তবে একটি অবৈধ বার্তা পে -লোড দেয়, গুগল চ্যাট অনুরোধটি পুনরায় চেষ্টা করে না।

প্রক্রিয়া বা ইন্টারঅ্যাকশন ইভেন্টগুলিতে প্রতিক্রিয়া

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

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

সুসংগতভাবে প্রতিক্রিয়া জানাতে, একটি চ্যাট অ্যাপ অবশ্যই 30 সেকেন্ডের মধ্যে প্রতিক্রিয়া জানাতে হবে এবং প্রতিক্রিয়াটি অবশ্যই সেই জায়গাতে পোস্ট করতে হবে যেখানে মিথস্ক্রিয়াটি ঘটেছে। অন্যথায়, চ্যাট অ্যাপটি অসাধারণভাবে প্রতিক্রিয়া জানাতে পারে।

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

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

গুগল চ্যাট অ্যাপ্লিকেশনগুলি কীভাবে ইন্টারঅ্যাকশন ইভেন্টগুলি প্রক্রিয়া করে তার আর্কিটেকচার।

রিয়েল টাইমে প্রতিক্রিয়া

ইন্টারঅ্যাকশন ইভেন্টগুলি চ্যাট অ্যাপ্লিকেশনগুলিকে রিয়েল টাইমে বা সিঙ্ক্রোনালিভাবে প্রতিক্রিয়া জানাতে দেয়। সিঙ্ক্রোনাস প্রতিক্রিয়াগুলির জন্য প্রমাণীকরণের প্রয়োজন হয় না।

রিয়েল টাইমে প্রতিক্রিয়া জানাতে, চ্যাট অ্যাপটিকে অবশ্যই একটি Message অবজেক্টটি ফিরিয়ে দিতে হবে। স্পেসে কোনও বার্তার সাথে জবাব দেওয়ার জন্য, Message অবজেক্টে text , cardsV2 এবং accessoryWidgets অবজেক্ট থাকতে পারে। অন্যান্য ধরণের প্রতিক্রিয়াগুলির সাথে ব্যবহার করতে, নিম্নলিখিত গাইডগুলি দেখুন:

একটি বার্তা দিয়ে উত্তর দিন

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

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

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The event object from Chat API.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

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

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

কোড নমুনা নিম্নলিখিত পাঠ্য বার্তা প্রদান করে:

উদাহরণস্বরূপ অনবোর্ডিং বার্তা।

ব্যবহারকারীর মিথস্ক্রিয়া গ্রহণ এবং প্রতিক্রিয়া

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

পূর্বশর্ত

মিথস্ক্রিয়া ইভেন্টের প্রকার

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

রিয়েল টাইমে সাড়া দিন

একটি বার্তা দিয়ে উত্তর দিন

Node.js

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

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

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

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

পূর্বশর্ত

মিথস্ক্রিয়া ইভেন্টের প্রকার

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

রিয়েল টাইমে সাড়া দিন

একটি বার্তা দিয়ে উত্তর দিন

Node.js

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

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

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

Google Workspace অ্যাড-অন হিসেবে একটি ইন্টারেক্টিভ Chat অ্যাপ তৈরি করুন

পূর্বশর্ত

মিথস্ক্রিয়া ইভেন্টের প্রকার

ডায়ালগ থেকে মিথস্ক্রিয়া ঘটনা

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপ কনফিগার করুন

আপনার পরিষেবাতে HTTP কল পুনঃপ্রচারগুলি পরিচালনা করুন৷

মিথস্ক্রিয়া ঘটনা প্রক্রিয়া বা প্রতিক্রিয়া

রিয়েল টাইমে সাড়া দিন

একটি বার্তা দিয়ে উত্তর দিন

Node.js

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

অ্যাসিঙ্ক্রোনাসভাবে সাড়া দিন

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

গুগল ওয়ার্কস্পেস অ্যাড-অন হিসাবে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ্লিকেশন তৈরি করুন

পূর্বশর্ত

ইন্টারঅ্যাকশন ইভেন্টের প্রকার

ডায়ালগগুলি থেকে ইন্টারঅ্যাকশন ইভেন্টগুলি

চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্টগুলি পান

ইন্টারঅ্যাকশন ইভেন্টগুলি পেতে আপনার চ্যাট অ্যাপটি কনফিগার করুন

আপনার পরিষেবাটিতে HTTP কলটি পুনরায় চেষ্টা করুন

প্রক্রিয়া বা ইন্টারঅ্যাকশন ইভেন্টগুলিতে প্রতিক্রিয়া

রিয়েল টাইমে প্রতিক্রিয়া

একটি বার্তা দিয়ে উত্তর দিন

Node.js

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

অ্যাসিঙ্ক্রোনালি প্রতিক্রিয়া

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