অন্যান্য পরিষেবা এবং সরঞ্জামগুলির সাথে একটি চ্যাট অ্যাপ সংযুক্ত করুন৷

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

পূর্বশর্ত

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

একজন ব্যবহারকারীর কাছ থেকে চ্যাট অ্যাপ কনফিগারেশনের অনুরোধ করুন

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

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

এটি গুগল চ্যাটকে ব্যবহারকারীকে একটি ব্যক্তিগত প্রম্পট দেখাতে নির্দেশ দেয়, যেখানে CONFIGURATION_URL হলো একটি লিঙ্ক যা ব্যবহারকারীকে অতিরিক্ত প্রমাণীকরণ, অনুমোদন বা কনফিগারেশনের জন্য ভিজিট করতে হয়। একটি REQUEST_CONFIG প্রতিক্রিয়া একটি সাধারণ প্রতিক্রিয়া বার্তার সাথে পারস্পরিকভাবে স্বতন্ত্র। যেকোনো টেক্সট, কার্ড বা অন্যান্য অ্যাট্রিবিউট উপেক্ষা করা হয়।

কনফিগারেশন অনুরোধটি সম্পূর্ণ করুন

আপনার চ্যাট অ্যাপ যে প্রতিটি MESSAGE , ADDED_TO_SPACE , এবং APP_COMMAND ইন্টারঅ্যাকশন ইভেন্ট গ্রহণ করে, সেগুলোতে configCompleteRedirectUrl ফিল্ডটিও অন্তর্ভুক্ত থাকে। প্রক্রিয়াটি সম্পন্ন হওয়ার পর ব্যবহারের জন্য আপনাকে অবশ্যই এই URL-টি আপনার কনফিগারেশন URL-এ এনকোড করতে হবে। এই URL-এ রিডাইরেক্ট করা হলে গুগল চ্যাট বুঝতে পারে যে কনফিগারেশন অনুরোধটি পূরণ হয়েছে।

আপনার চ্যাট অ্যাপ যখন চালু হয়, তখন এর কার্যপ্রবাহ প্রাপ্ত নির্দিষ্ট বার্তার ওপর নির্ভর করে। @app help মতো কোনো বার্তার জবাবে, চ্যাট অ্যাপটির অতিরিক্ত কনফিগারেশনের প্রয়োজন ছাড়াই একটি বার্তা পাঠানো উচিত।

যখন কোনো ব্যবহারকারীকে মূল বার্তায় দেওয়া configCompleteRedirectUrl এ সফলভাবে পুনঃনির্দেশিত করা হয়, তখন গুগল চ্যাট নিম্নলিখিত ধাপগুলো সম্পাদন করে:

  1. সূচনাকারী ব্যবহারকারীকে দেখানো প্রম্পটটি মুছে ফেলুন।
  2. মূল বার্তাটিকে সর্বজনীন করুন, যাতে এটি স্পেসের অন্যান্য সদস্যরা দেখতে পায়।
  3. মূল বার্তাটি একই চ্যাট অ্যাপে দ্বিতীয়বার পাঠান।

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

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

চ্যাটের বাইরে চ্যাট ব্যবহারকারীকে প্রমাণীকরণ করুন।

কিছু ক্ষেত্রে, যেমন কোনো API-এর জন্য OAuth অনুমোদনের অনুরোধ করার সময়, ব্যবহারকারীর পরিচয় বজায় রেখে আপনার অ্যাপকে চ্যাটের বাইরের কোনো URL-এর সাথে লিঙ্ক করতে হয়। এই ধরনের ক্ষেত্রে ব্যবহারকারীকে শনাক্ত করার সেরা উপায় হলো Google Sign-in দিয়ে গন্তব্য অ্যাপটিকে সুরক্ষিত করা।

সাইন-ইন করার সময় ইস্যু করা আইডেন্টিটি টোকেন ব্যবহার করে ইউজার আইডি পান। sub ক্লেইমটিতে ব্যবহারকারীর ইউনিক আইডি থাকে এবং এটিকে গুগল চ্যাট থেকে প্রাপ্ত ইউজার আইডির সাথে মেলানো যায়।

যদিও আইডি দুটি হুবহু এক নয়, তবুও এদেরকে রূপান্তর করা যায়। sub ক্লেমের মানকে Google Chat-এর users/{user} -এ রূপান্তর করতে, মানটির শুরুতে users/ যোগ করুন। উদাহরণস্বরূপ, 123 ক্লেম মানটি আপনার চ্যাট অ্যাপে পাঠানো মেসেজের ইউজারনেম users/123 এর সমতুল্য।