এই অংশে চ্যাট অ্যাপ তৈরি ও পরীক্ষা করার সময় আপনি যে সাধারণ সমস্যাগুলোর সম্মুখীন হতে পারেন, সেগুলো বর্ণনা করা হয়েছে।
একটি কার্ড বার্তা, ডায়ালগ বা লিঙ্ক প্রিভিউ প্রত্যাশিতভাবে রেন্ডার হয় না বা কাজ করে না।
কার্ডের ত্রুটি নির্ণয় ও সমাধানের জন্য, “কার্ডের সমস্যা সমাধান ও মেরামত” দেখুন।
অ্যাপটি সাড়া দিচ্ছে না
আপনি যদি চ্যাট অ্যাপে মেসেজ পাঠান এবং উত্তরে "অ্যাপটি সাড়া দিচ্ছে না" লেখা আসে, তাহলে চ্যাট অ্যাপটির কনফিগারেশন যাচাই করুন:
Google API কনসোলে, মেনু এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা > গুগল চ্যাট এপিআই > কনফিগারেশন- এ ক্লিক করুন ।
অ্যাপ স্ট্যাটাস-এর অধীনে, নিশ্চিত করুন যে আপনি ‘লাইভ - ব্যবহারকারীদের জন্য উপলব্ধ’ বিকল্পটি নির্বাচন করেছেন।
ইন্টারেক্টিভ ফিচারস- এর অধীনে, নিশ্চিত করুন যে সেটিংসগুলো আপনার অ্যাপের কার্যকারিতার জন্য উপযুক্ত। যদি আপনার চ্যাট অ্যাপ ব্যবহারকারীদের সাথে যোগাযোগ করে, তাহলে নিশ্চিত করুন যে আপনি ‘এনেবল ইন্টারেক্টিভ ফিচারস’ চালু করেছেন।
- ডিফল্টরূপে, অ্যাপগুলো ব্যবহারকারীদের সরাসরি বার্তার উত্তর দিতে পারে।
- আপনার অ্যাপ যদি স্পেস এবং গ্রুপ চ্যাটের মেসেজের উত্তর দেয়, তাহলে ‘Join spaces and group conversations’ নির্বাচন করুন।
- কানেকশন সেটিংস-এর অধীনে, নিশ্চিত করুন যে HTTP এন্ডপয়েন্ট URL , অ্যাপস স্ক্রিপ্ট প্রজেক্ট ডিপ্লয়মেন্ট আইডি , ক্লাউড পাব/সাব টপিক নেম , অথবা ডায়ালগফ্লো এজেন্ট সঠিকভাবে সেট করা আছে এবং এটি ডিপ্লয় করা হয়েছে।
- ভিজিবিলিটি (Visibility) এর অধীনে, নিশ্চিত করুন যে উপযুক্ত ব্যবহারকারীদের ইমেল ঠিকানা বা গুগল ওয়ার্কস্পেস ডোমেনের কোনো গ্রুপের মাধ্যমে অ্যাপটিতে অ্যাক্সেস আছে। যদি অ্যাপটি গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে (SDK) দিয়ে ডেপ্লয় করা হয়, তাহলে ভিজিবিলিটি সেটিংসের প্রয়োজন নেই, কারণ গুগল ওয়ার্কস্পেস মার্কেটপ্লেসের সেটিংস অগ্রাধিকার পায়।
যদি অ্যাপটি গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে (SDK) দিয়ে প্রকাশ করা হয়ে থাকে, তাহলে গুগল ওয়ার্কস্পেস মার্কেটপ্লেস সেটিংস পর্যালোচনা করুন।
সংরক্ষণ করুন- এ ক্লিক করুন।
অ্যাপটিতে আবার মেসেজ পাঠানোর চেষ্টা করুন।
গুগল চ্যাট এপিআই শুধুমাত্র গুগল ওয়ার্কস্পেস ব্যবহারকারীদের জন্য উপলব্ধ।
চ্যাট অ্যাপ কনফিগার করার সময়, আপনি Google Chat API is only available to Google Workspace users ’ এই ত্রুটি বার্তাটি পেতে পারেন। এই বার্তার অর্থ হলো, চ্যাট এপিআই কনফিগার করার জন্য আপনি যে Google অ্যাকাউন্টটি ব্যবহার করেছেন, সেটি কোনো Google Workspace অর্গানাইজেশনের অংশ নয়। একটি চ্যাট অ্যাপ তৈরি করতে বা চ্যাট এপিআই ব্যবহার করতে, আপনাকে অবশ্যই একটি Google Workspace অ্যাকাউন্ট ব্যবহার করতে হবে।
উল্লেখ্য যে, গুগল চ্যাট ব্যবহারকারীরা গুগল ওয়ার্কস্পেস অ্যাকাউন্ট ছাড়াই চ্যাট অ্যাপ ব্যবহার করতে পারেন। ব্যবহারকারীরা কীভাবে চ্যাট অ্যাপ খুঁজে বের করেন এবং ইনস্টল করেন সে সম্পর্কে আরও জানতে, ‘ইন্টারেক্টিভ গুগল চ্যাট অ্যাপ তৈরি করুন’ দেখুন।
ব্যবহারকারীদের স্থান থেকে বাদ দেওয়া যেতে পারে।
যদি কোনো গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর ব্যবহারকারীদের চ্যাট হিস্ট্রি চালু বা বন্ধ করার অনুমতি না দেন , তাহলে এমন পরিস্থিতি তৈরি হতে পারে যেখানে ব্যবহারকারী-স্তরের একটি সেটিং যা চ্যাট হিস্ট্রি চালু বা বন্ধ করতে বাধ্য করে, এবং সংস্থা-স্তরের সেই বাধ্যতামূলক সেটিংটি গ্রহণকারী স্পেসটির মধ্যে সংঘাতের কারণে ব্যবহারকারীরা কোনো স্পেসে যোগ দিতে বা থাকতে পারবেন না।
উদাহরণস্বরূপ, যদি কোনো ব্যবহারকারীর চ্যাট হিস্ট্রি সেটিং জোর করে 'অন' করা থাকে এবং কোনো স্পেসের চ্যাট হিস্ট্রি সেটিং জোর করে 'অফ' করা থাকে, তাহলে সেই ব্যবহারকারী স্পেসটিতে যোগ দিতে নাও পারতে পারেন। এছাড়াও, যদি সেই ব্যবহারকারী দ্বন্দ্বের আগে যোগ দিয়ে থাকেন এবং দ্বন্দ্বের পরে স্পেসটিতে কোনো বার্তা পোস্ট করেন, তাহলে তাকে স্পেসটি থেকে সরিয়ে দেওয়া হতে পারে।
এই পরিস্থিতিতে, এবং অন্যান্য পরিস্থিতিতে যেখানে হিস্ট্রি সেটিংসের মধ্যে দ্বন্দ্ব থাকে, চ্যাট এপিআই হয়তো কোনো মেম্বারশিপ তৈরি করতে পারবে না, অথবা ইউজার অথেন্টিকেশন সহ একটি মেসেজ তৈরি করলে দ্বন্দ্বপূর্ণ চ্যাট হিস্ট্রি সেটিং থাকা অথেন্টিকেটেড ইউজারকে স্পেসটি থেকে সরিয়ে দেওয়া হতে পারে।
আরও জানতে, গুগল ওয়ার্কস্পেস অ্যাডমিন হেল্প সেন্টারে ‘ব্যবহারকারীদের স্পেস থেকে বাদ দেওয়া যেতে পারে’ দেখুন।
গুগল অ্যাপস স্ক্রিপ্টে অ্যাডভান্সড চ্যাট পরিষেবার সমস্যা সমাধান করুন
অ্যাডভান্সড চ্যাট সার্ভিস সম্পর্কে জানতে অ্যাপস স্ক্রিপ্ট পৃষ্ঠাটি দেখুন।
ব্যবহারকারীরা কোনো স্পেসে চ্যাট অ্যাপ যোগ করতে পারছেন না।
কোনো স্পেসে চ্যাট অ্যাপ যোগ করার চেষ্টা করার সময় ব্যবহারকারীরা যদি This organization's administrator must allow users to install this Chat app এই ত্রুটি বার্তাটির সম্মুখীন হন, তাহলে এই ত্রুটিটি নিম্নলিখিত কারণগুলির মধ্যে একটির জন্য হতে পারে:
- সংস্থাটি চ্যাট অ্যাপগুলো নিষ্ক্রিয় করে দিয়েছে।
- সংস্থাটি এই নির্দিষ্ট চ্যাট অ্যাপটিকে তাদের অনুমোদিত তালিকায় যুক্ত করেনি।
যদি কোনো ব্যবহারকারী চ্যাট অ্যাপ ব্যবহার করার চেষ্টা করার সময় এই ত্রুটি বার্তাটি পান, তবে এর কারণ হতে পারে যে সংস্থাটি মূল সাংগঠনিক ইউনিটের জন্য অ্যাক্সেস সক্ষম না করেই একটি উপ-সাংগঠনিক ইউনিটকে অ্যাক্সেস দিয়েছে।
এই সমস্যাটি কীভাবে সমাধান করা যায় সে সম্পর্কে তথ্যের জন্য, “ব্যবহারকারীদের চ্যাট অ্যাপ ইনস্টল করার অনুমতি দিন” দেখুন।
এই কাজের জন্য প্রশাসককে অবশ্যই অ্যাপটিকে প্রয়োজনীয় OAuth অনুমোদনের পরিধি প্রদান করতে হবে।
চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের সময়, আপনি নিম্নলিখিত ত্রুটিটি পেতে পারেন:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
This error message means that a Google Workspace administrator hasn't yet granted one-time approval to the Chat app to use authorization scopes that begin with the name https://www.googleapis.com/auth/chat.app.* .
ত্রুটি সমাধান করতে:
- আপনার চ্যাট অ্যাপের অনুমোদনের জন্য গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটরকে অনুরোধ করুন। আপনার চ্যাট অ্যাপের লজিকে এই ত্রুটিটি সমাধান করার সময়, একটি বার্তা পাঠানোর কথা বিবেচনা করুন যেখানে জানানো হবে যে অনুরোধ করা কাজটি করার জন্য চ্যাট অ্যাপটির অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন, যেমন:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - যদি চ্যাট এপিআই মেথডটি
https://www.googleapis.com/auth/chat.botঅথরাইজেশন স্কোপ সমর্থন করে, যার জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদনের প্রয়োজন হয় না, তবে এর পরিবর্তে সেটি ব্যবহার করার কথা বিবেচনা করুন। কোনো মেথড কোন কোন অথরাইজেশন স্কোপ সমর্থন করে তা পরীক্ষা করতে, "গুগল চ্যাট অ্যাপ এবং গুগল চ্যাট এপিআই অনুরোধ প্রমাণীকরণ ও অনুমোদন" দেখুন।
ক্লাউড ফাংশনের ত্রুটি সমাধান করুন
যদি চ্যাট অ্যাপটি ক্লাউড ফাংশন দিয়ে তৈরি করা হয়ে থাকে এবং সেটি কাজ না করে, তাহলে নিচের অংশগুলো সমস্যাটি খুঁজে বের করতে ও সমাধান করতে সাহায্য করবে।
ক্লাউড ফাংশন লগগুলি পরীক্ষা করুন
প্রথম পদক্ষেপ হিসেবে, কোনো ত্রুটির জন্য ক্লাউড ফাংশন লগগুলো পরীক্ষা করুন।
Google API Console-এ, Cloud Functions পৃষ্ঠায় যান:
লগগুলো খুলতে, আপনার চ্যাট অ্যাপের ক্লাউড ফাংশনটি খুঁজুন, তারপর 'Show actions' > 'View logs'- ক্লিক করুন।
লগস এক্সপ্লোরারটি খোলে এবং একটি কোয়েরি চালায়, যা ত্রুটিসহ ক্লাউড ফাংশনের লগগুলো প্রদর্শন করে।
আপনার অ্যাপ ডিবাগ করার জন্য ডিফল্টভাবে লগ করা তথ্য যথেষ্ট না হলে, আপনি আপনার ক্লাউড ফাংশন কোড থেকে অতিরিক্ত লগিং যোগ করতে পারেন। ক্লাউড ফাংশন লগ দেখা ও লেখা দেখুন।
ক্লাউড ফাংশনের ত্রুটিগুলি পরীক্ষা করুন
লগ ছাড়াও, ক্লাউড ফাংশন চলার সময় সম্মুখীন হওয়া ত্রুটিগুলোও রিপোর্ট করতে পারে।
Google API Console-এ, Cloud Functions পৃষ্ঠায় যান:
আপনার চ্যাট অ্যাপের ক্লাউড ফাংশনে ক্লিক করুন।
ফাংশন বিবরণ পৃষ্ঠায়, ত্রুটিগুলি 'ত্রুটি' (Errors) শিরোনামের অধীনে তালিকাভুক্ত করা হয়।
কোনো ত্রুটির আরও বিশদ সমাধান করতে, সেটিতে ক্লিক করুন।
ক্লাউড ফাংশনের সাধারণ ত্রুটিগুলি সমাধান করুন
ক্লাউড ফাংশন ব্যবহার করে চ্যাট অ্যাপ তৈরি করার সময় মাঝে মাঝে নিম্নলিখিত ত্রুটিগুলো দেখা যায়।
PROJECT_NAME প্রোজেক্টের REGION_NAME অঞ্চলে ChatApp ফাংশনটি ইতিমধ্যেই বিদ্যমান আছে।
একটি ক্লাউড ফাংশন ডেপ্লয় করার সময়, আপনি Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists " এই ত্রুটিটি পেতে পারেন। এই বার্তার অর্থ হলো, আপনি যে ক্লাউড ফাংশনটি ডেপ্লয় করছেন, অন্য একটি ক্লাউড ফাংশনের নাম একই। নামটি পরিবর্তন করুন এবং ফাংশনটি আবার ডেপ্লয় করুন। যাচাই করে দেখুন যে চ্যাট অ্যাপটি আপনার ক্লাউড ফাংশনের ট্রিগার ইউআরএল ব্যবহার করছে, আগে থেকে বিদ্যমান ক্লাউড ফাংশনের ট্রিগার ইউআরএল নয়।
নীতিমালায় উল্লিখিত এক বা একাধিক ব্যবহারকারী অনুমোদিত গ্রাহকের অন্তর্ভুক্ত নন।
একটি ক্লাউড ফাংশন স্থাপন করার সময়, আপনি এই ত্রুটিটি পেতে পারেন The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." যদি আপনি এই ত্রুটিটি পান এবং তারপর চ্যাট অ্যাপে বার্তা পাঠান, তাহলে আপনি একটি ত্রুটি বার্তা পাবেন যেখানে বলা হবে যে অ্যাপটি সাড়া দিচ্ছে না কারণ গুগল চ্যাট ক্লাউড ফাংশনটি হোস্ট করা সার্ভারে পৌঁছাতে পারছে না। এই বার্তার অর্থ হলো "allUsers" নামের ব্যবহারকারীর ক্লাউড ফাংশনটি কল করার অনুমতি নেই। "allUsers"-কে "ক্লাউড ফাংশনস ইনভোকার" ভূমিকাটি দেওয়ার অর্থ হলো, যে ক্লাউড ফাংশনটি অ্যাপটিকে চালনা করে তা সর্বজনীনভাবে উপলব্ধ এবং প্রমাণীকরণ ছাড়াই অ্যাক্সেসযোগ্য। কীভাবে একটি ভূমিকা নির্ধারণ করতে হয় তা জানতে, "একটি একক ভূমিকা প্রদান করুন" দেখুন।
এই ত্রুটির অর্থ হতে পারে যে গুগল ক্লাউড প্রজেক্টটি ডোমেইন দ্বারা সীমাবদ্ধ। ডোমেইন সীমাবদ্ধতার শর্তাবলী সম্পর্কে আরও তথ্যের জন্য, "ডোমেইন দ্বারা পরিচয় সীমাবদ্ধ করা" দেখুন।
এই সমস্যাটি সমাধান করতে, যাচাই করুন যে আপনার ক্লাউড ফাংশনটি প্রমাণীকরণবিহীন ইনভোকেশনের অনুমতি দেয়। একটি বিদ্যমান ক্লাউড ফাংশনের জন্য কীভাবে প্রমাণীকরণবিহীন ইনভোকেশনের অনুমতি দিতে হয় তা জানতে, "সর্বজনীন (প্রমাণীকরণবিহীন) অ্যাক্সেসের অনুমতি দেওয়া" অংশটি দেখুন।