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

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

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

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

পূর্বশর্ত

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

মিথস্ক্রিয়া ঘটনা কিভাবে কাজ করে

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ইন্টারঅ্যাকশন ইভেন্টগুলিতে সিঙ্ক্রোনাস প্রতিক্রিয়া তৈরি করতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

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

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

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

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