ইন্টার‍্যাকশন ইভেন্ট পাওয়া ও উত্তর দেওয়া

এই পৃষ্ঠায় বর্ণনা করা হয়েছে যে কীভাবে আপনার Google Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশন পেতে ও উত্তর দিতে পারে, এগুলিকে Google Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্টও বলা হয়।

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

• ইন্টার‍্যাকশন ইভেন্ট পেতে আপনার Chat অ্যাপ কনফিগার করুন।
• আপনার ইনফ্রাস্ট্রাকচারে ইন্ট্যার‍্যাকশন ইভেন্ট প্রসেস করুন।
• উপযুক্ত হলে, ইন্ট্যার‍্যাকশন ইভেন্টে উত্তর দিন।

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

পূর্বশর্ত

• Business বা Enterprise Google Workspace অ্যাকাউন্ট, যার Google Chat-এ অ্যাক্সেস আছে।
• Google Cloud প্রোজেক্ট তৈরি করুন।
• OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন।
• Google Chat API চালু করুন।

ইন্টার‍্যাকশন ইভেন্টের ধরন

Google Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্ট হল এমন কোনও অ্যাকশন যা কোনও ব্যবহারকারী Chat অ্যাপকে ইনভোক বা সেটির সাথে ইন্টার‍্যাক্ট করার জন্য নেন, যেমন Chat অ্যাপকে @উল্লেখ করা বা কোনও স্পেসে সেটি যোগ করা।

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

ব্যবহারকারীর ইন্টার‍্যাকশনের প্রতিটি ধরনের জন্য, Google Chat আলাদা ধরনের ইন্টার‍্যাকশন ইভেন্ট পাঠায় যা আপনার Chat অ্যাপকে প্রতিটি ইভেন্টের ধরন সেই অনুযায়ী ম্যানেজ করতে সাহায্য করে। ইন্টার‍্যাকশন ইভেন্টের ধরনটি eventType অবজেক্ট ব্যবহার করে দেখানো হয়।

যেমন, কোনও ইন্টার‍্যাকশনের জন্য Google Chat ইভেন্টের ধরন ADDED_TO_SPACE ব্যবহার করে, যেখানে কোনও ব্যবহারকারী স্পেসে Chat অ্যাপ যোগ করেন, যাতে Chat অ্যাপ অবিলম্বে স্পেসে স্বাগত জানানোর মেসেজ দিয়ে উত্তর দিতে পারে।

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

নিচে দেওয়া সারণীতে সাধারণ ব্যবহারকারীর ইন্টার‍্যাকশন, Chat অ্যাপ যে ধরনের ইন্টার‍্যাকশন ইভেন্ট পায় এবং Chat অ্যাপ সাধারণত কীভাবে উত্তর দেয় তা দেখানো হয়েছে:

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

কাজ করে এমন সব ইন্টার‍্যাকশন ইভেন্ট দেখতে, EventTypeরেফারেন্স ডকুমেন্টেশন দেখুন।

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

আপনার Chat অ্যাপে ডায়ালগ খুললে, ইন্ট্যার‍্যাকশন ইভেন্টে নিম্নলিখিত অতিরিক্ত তথ্য থাকে যা আপনি উত্তর প্রসেস করার জন্য ব্যবহার করতে পারেন:

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

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

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

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

Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্ট পাওয়া

এই বিভাগে আপনার চ্যাট অ্যাপের জন্য কীভাবে ইন্ট্যার‍্যাকশন ইভেন্ট পাবেন ও প্রসেস করবেন তা বর্ণনা করা হয়েছে।

ইন্টার‍্যাকশন ইভেন্ট পেতে আপনার Chat অ্যাপ কনফিগার করা

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

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

1. Google Cloud কনসোলে, Chat API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:

   Chat API কনফিগারেশন পৃষ্ঠায় যান

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

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

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

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

স্টার্টার প্রম্পট কনফিগার করা

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস দেয়।

আপনার অ্যাপের সাথে ১:১ সরাসরি মেসেজ খুললে, স্টার্টার প্রম্পট ব্যবহারকারীদের আপনার Chat অ্যাপের কার্যকারিতা ডিসকভার করতে সাহায্য করে। আপনি সর্বাধিক তিনটি স্টার্টার প্রম্পট কনফিগার করতে পারবেন।

স্টার্টার প্রম্পট যোগ ও কনফিগার করতে:

1. Google Cloud Console-এ, Chat API-এর কনফিগারেশন পৃষ্ঠায় যান:

   Chat API কনফিগারেশন পৃষ্ঠায় যান

2. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের মধ্যে, স্টার্টার প্রম্পট খুঁজে নিয়ে প্রম্পট যোগ করুন বিকল্পে ক্লিক করুন।

3. র‍্যাঙ্ক (১-৩) ফিল্ডে, ডিসপ্লে অর্ডার নির্দিষ্ট করতে 1 থেকে 3-এর মধ্যে কোনও সংখ্যা লিখুন।

4. টাইপ বেছে নেওয়া বিকল্পের মধ্যে, প্রম্পট কীভাবে আচরণ করবে তা বেছে নিন:

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

5. আপনার বেছে নেওয়া ধরনের উপর ভিত্তি করে প্রম্পট কনফিগার করুন:

   • আপনি টেক্সট প্রম্পট বেছে নিলে:

     1. শীর্ষক-এ, চিপে দেখানো প্রম্পটের শীর্ষক লিখুন (সর্বাধিক ৩০ অক্ষর)।
     2. প্রম্পট টেক্সটে, কম্পোজ বারে অটো-ফিল করা টেক্সট লিখুন (সর্বাধিক ৬০টি অক্ষর)।
     3. ঐচ্ছিক: অন্যান্য ভাষার ব্যবহারকারীদের জন্য স্থানীয় ভাষায় শীর্ষক ও টেক্সট যোগ করুন:
     4. স্থানীয় ভাষায় প্রম্পট বিকল্পের মধ্যে, একটি ভাষা যোগ করুন বিকল্পে ক্লিক করুন।
     5. ভাষা বিকল্পে গিয়ে ড্রপ-ডাউন থেকে একটি মানানসই ভাষা বেছে নিন।
     6. স্থানীয়কৃত শীর্ষক-এ, স্থানীয়কৃত শীর্ষক লিখুন (সর্বাধিক ৩০ অক্ষর)।
     7. স্থানীয়করণ করা প্রম্পট টেক্সটে, স্থানীয়করণ করা প্রম্পট টেক্সট (সর্বাধিক ৬০টি অক্ষর) লিখুন।
     8. প্রয়োজন অনুযায়ী আরও ভাষা যোগ করতে এই ধাপগুলি আবার অনুসরণ করুন।

   • আপনি Command prompt বেছে নিলে:

     1. স্ল্যাশ কমান্ড / কুইক কমান্ড বিকল্পে গিয়ে, ড্রপ-ডাউন থেকে কমান্ড বেছে নিন।

6. হয়ে গেছে বিকল্পে ক্লিক করুন এবং তারপর পৃষ্ঠার নিচে সেভ করুন বিকল্পে ক্লিক করুন।

আপনার পরিষেবায় HTTP কল আবার করার বিষয়টি ম্যানেজ করা

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

ইন্টার‍্যাকশন ইভেন্ট প্রসেস করা বা উত্তর দেওয়া

এই বিভাগে Google Chat অ্যাপ কীভাবে ইন্ট্যার‍্যাকশন ইভেন্ট প্রসেস করে এবং তার উত্তর দেয় তা ব্যাখ্যা করা হয়েছে।

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

সিঙ্ক্রোনাস পদ্ধতিতে উত্তর দিতে, Chat অ্যাপকে ৩০ সেকেন্ডের মধ্যে উত্তর দিতে হবে এবং ইন্ট্যার‍্যাকশন যেখানে হয়েছে সেই স্পেসে উত্তরটি পোস্ট করতে হবে। অন্যথায়, Chat অ্যাপ অ্যাসিঙ্ক্রোনাসভাবে উত্তর দিতে পারে।

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

নিচের ডায়াগ্রাম থেকে বোঝা যায় যে কীভাবে Google Chat অ্যাপ সাধারণত বিভিন্ন ধরনের ইন্টার‍্যাকশন ইভেন্ট প্রসেস করে বা সেগুলির উত্তর দেয়:

রিয়েল টাইমে উত্তর দেওয়া হবে

ইন্টার‍্যাকশন ইভেন্ট, Chat অ্যাপকে রিয়েল-টাইমে অথবা সিঙ্ক্রোনাস উত্তর দিতে দেয়। সিঙ্ক্রোনাস উত্তরের জন্য যাচাইকরণ প্রয়োজন হয় না।

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

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

মনে রাখবেন: REMOVED_FROM_SPACE ইন্ট্যার‍্যাকশন ইভেন্টের জন্য, Chat অ্যাপ Message অবজেক্টের মাধ্যমে উত্তর দিতে পারে না কারণ সেগুলি আর স্পেসে নেই।

মেসেজ পাঠানোর মাধ্যমে উত্তর দিন

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

কোনও ব্যবহারকারী স্পেসে আপনার Chat অ্যাপ যোগ করলে, টেক্সট মেসেজ পাঠানোর জন্য, আপনার 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.
 */
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`.'
    });
  }
};

Python

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({})

Java

@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();
    }
  }
}

Apps Script

/**
 * 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`.'
  }
}

কোড স্যাম্পেল থেকে নিম্নলিখিত টেক্সট মেসেজ পাওয়া যায়:

অ্যাসিঙ্ক্রোনাস পদ্ধতিতে উত্তর দেওয়া

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

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

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

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