মিথস্ক্রিয়া ঘটনা গ্রহণ করুন এবং প্রতিক্রিয়া

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

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

• ইন্টার‍্যাকশন ইভেন্ট গ্রহণ করার জন্য আপনার Chat অ্যাপটি কনফিগার করুন।
• আপনার পরিকাঠামোতে ইন্টারঅ্যাকশন ইভেন্টটি প্রক্রিয়া করুন।
• যদি প্রয়োজনীয় হয়, তাহলে মিথস্ক্রিয়ার ঘটনায় সাড়া দিন।

দ্রষ্টব্য: এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Chat API ইন্টারঅ্যাকশন ইভেন্ট ব্যবহার করে একটি ইন্টারেক্টিভ চ্যাট অ্যাপ তৈরি করবেন। আপনি আপনার চ্যাট অ্যাপটিকে Google Workspace অ্যাড-অন হিসেবেও তৈরি করতে পারেন। কোন ফ্রেমওয়ার্ক ব্যবহার করবেন তা জানতে, একটি ইন্টারেক্টিভ Google চ্যাট অ্যাপ তৈরি করুন দেখুন।

পূর্বশর্ত

• Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
• একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
• OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
• গুগল চ্যাট এপিআই সক্ষম করুন ।

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

একটি Google Chat অ্যাপ ইন্টারঅ্যাকশন ইভেন্ট হল একজন ব্যবহারকারীর দ্বারা চ্যাট অ্যাপ চালু করার বা ইন্টারঅ্যাক্ট করার জন্য নেওয়া যেকোনো পদক্ষেপ, যেমন একটি চ্যাট অ্যাপ @mention করা বা একটি স্পেসে যোগ করা।

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

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

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

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

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

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

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

সংলাপ থেকে ইন্টারঅ্যাকশন ইভেন্ট

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

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

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

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

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

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

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

ইন্টার‍্যাকশন ইভেন্ট গ্রহণের জন্য আপনার Chat অ্যাপ কনফিগার করুন

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

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

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

   চ্যাট এপিআই কনফিগারেশন পৃষ্ঠায় যান

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

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

3. সংরক্ষণ করুন এ ক্লিক করুন। যখন আপনি চ্যাট অ্যাপ কনফিগারেশন সংরক্ষণ করেন, তখন আপনার চ্যাট অ্যাপটি আপনার Google Workspace প্রতিষ্ঠানের নির্দিষ্ট ব্যবহারকারীদের জন্য উপলব্ধ হয়।

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

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

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

মিথস্ক্রিয়া ইভেন্টগুলি প্রক্রিয়া করুন বা প্রতিক্রিয়া জানান

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

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

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

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

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

রিয়েল টাইমে উত্তর দিন

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

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

• ইন্টারেক্টিভ ডায়ালগ খুলুন
• লিঙ্কগুলির পূর্বরূপ দেখুন
• ব্যবহারকারীদের দ্বারা জমা দেওয়া তথ্য প্রক্রিয়াকরণ

দ্রষ্টব্য: REMOVED_FROM_SPACE ইন্টারঅ্যাকশন ইভেন্টের জন্য, চ্যাট অ্যাপগুলি Message অবজেক্ট দিয়ে প্রতিক্রিয়া জানাতে পারে না কারণ তারা আর স্পেসে নেই।

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

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

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

নোড.জেএস

/**
 * 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.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  // 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`.'
    });
  }
};

পাইথন

from flask import Flask, request, json
app = Flask(__name__)

@app.route('/', methods=['POST'])
def cymbal_app():
  """Sends an onboarding message when the Chat app is added to a space.

  Returns:
    Mapping[str, Any]: The response object from the Chat app.
  """
  event = request.get_json()
  if event['type'] == 'ADDED_TO_SPACE':
    return json.jsonify({
      '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`.'
    })
  return json.jsonify({})

জাভা

@SpringBootApplication
@RestController
public class App {
  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }

  /*
   * Sends an onboarding message when the Chat app is added to a space.
   *
   * @return The response object from the Chat app.
   */
  @PostMapping("/")
  @ResponseBody
  public Message onEvent(@RequestBody JsonNode event) {
    switch (event.get("type").asText()) {
      case "ADDED_TO_SPACE":
        return new Message().setText(
          "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`.");
      default:
        return new Message();
    }
  }
}

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

/**
 * 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.
 */
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 Chat API-তে কল করে অ্যাসিঙ্ক্রোনাসভাবে প্রতিক্রিয়া জানাতে পারে।

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

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

• একটি বার্তা পাঠান
• ইন্টারেক্টিভ ডায়ালগ খুলুন
• লিঙ্কগুলির পূর্বরূপ দেখুন
• কার্ডে ব্যবহারকারীদের দ্বারা ইনপুট করা ফর্ম ডেটা পড়ুন
• কমান্ডের উত্তর দিন
• চ্যাট অ্যাপের জন্য একটি হোমপেজ তৈরি করুন
• Chat থেকে আসা অনুরোধগুলি যাচাই করুন
• Google Chat অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্য পরীক্ষা করুন