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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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