Google Chat অ্যাপে হওয়া সমস্যার সমাধান করা

এই বিভাগে, Chat অ্যাপ তৈরি ও পরীক্ষা করার সময় আপনি যেসব সাধারণ সমস্যার সম্মুখীন হতে পারেন, সেগুলি বর্ণনা করা হয়েছে।

কার্ড মেসেজ, ডায়ালগ বা লিঙ্ক প্রিভিউ প্রত্যাশা অনুযায়ী রেন্ডার বা কাজ করে না

কার্ড সংক্রান্ত সমস্যার সমাধান করার ব্যাপারে সাহায্য পেতে, কার্ড সংক্রান্ত সমস্যার সমাধান করা ও তা ঠিক করা দেখুন।

অ্যাপ উত্তর দিচ্ছে না

আপনি Chat অ্যাপে মেসেজ করলে এবং সেটি উত্তর দেয়, "অ্যাপ উত্তর দিচ্ছে না," Chat অ্যাপের কনফিগারেশন যাচাই করুন:

  1. Google API Console-এ, মেনু > API ও পরিষেবা > চালু API ও পরিষেবা > Google Chat API > কনফিগারেশন বিকল্পে ক্লিক করুন।

    Chat API কনফিগারেশনে যান

  2. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের মধ্যে, আপনার অ্যাপের কার্যকারিতার জন্য উপযুক্ত সেটিংস আছে কিনা তা নিশ্চিত করুন। আপনার চ্যাট অ্যাপ ব্যবহারকারীদের সাথে ইন্টার‍্যাক্ট করলে, ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প চালু করতে ভুলবেন না:

    1. ডিফল্ট হিসেবে, অ্যাপ ব্যবহারকারীর পাঠানো সরাসরি মেসেজের উত্তর দিতে পারে।
    2. আপনার অ্যাপ যদি স্পেস ও গ্রুপ চ্যাটে মেসেজের উত্তর দেয়, তাহলে স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
    3. কানেকশন সেটিংস-এর অধীনে, আপনার আর্কিটেকচার ও ট্রিগার (যেমন, HTTP এন্ডপয়েন্ট URL, Apps Script প্রজেক্ট ডেপ্লয়মেন্ট আইডি ও ফাংশনের নাম, Cloud Pub/Sub বিষয়সূচির নাম অথবা Dialogflow এজেন্ট) সঠিকভাবে সেট করা আছে কিনা এবং আপনার অ্যাপ ডেপ্লয় করা হয়েছে কিনা তা নিশ্চিত করুন।
    4. দৃশ্যমানতা বিকল্পের অধীনে, উপযুক্ত ব্যবহারকারীদের Google Workspace ডোমেনে ইমেল আইডি বা গ্রুপের মাধ্যমে অ্যাপ অ্যাক্সেস আছে কিনা তা নিশ্চিত করুন। Google Workspace Marketplace SDK-এর মাধ্যমে অ্যাপটি ডেপ্লয় করা হলে, দৃশ্যমানতা সেটিংসের প্রয়োজন নেই কারণ Google Workspace Marketplace সেটিংসকে অগ্রাধিকার দেওয়া হয়।

  3. Google Workspace Marketplace SDK-এর মাধ্যমে অ্যাপ প্রকাশ করা হলে, Google Workspace Marketplace সেটিংস পর্যালোচনা করুন।

  4. সেভ করুন বিকল্পে ক্লিক করুন।

  5. অ্যাপে আবার মেসেজ পাঠানোর চেষ্টা করুন।

Google Chat API শুধুমাত্র Google Workspace ব্যবহারকারীদের জন্য উপলভ্য

Chat অ্যাপ কনফিগার করার সময়, আপনি Google Chat API is only available to Google Workspace users 'সমস্যা' মেসেজ পেতে পারেন। এই মেসেজটি জানায় যে আপনি যে Google অ্যাকাউন্ট ব্যবহার করে Chat API কনফিগার করেছেন সেটি Google Workspace প্রতিষ্ঠানের অংশ নয়। Chat অ্যাপ তৈরি করতে বা Chat API ব্যবহার করতে, আপনাকে অবশ্যই Google Workspace অ্যাকাউন্ট ব্যবহার করতে হবে।

মনে রাখবেন, Google Chat ব্যবহারকারীরা Google Workspace অ্যাকাউন্ট ছাড়াই Chat অ্যাপ ব্যবহার করতে পারবেন। ব্যবহারকারীরা কীভাবে Chat অ্যাপ খুঁজে পান ও ইনস্টল করেন সেই সম্পর্কে আরও জানতে, ইন্টারেক্টিভ Google Chat অ্যাপ তৈরি করুন দেখুন।

ব্যবহারকারীদের স্পেস থেকে বাদ দেওয়া যেতে পারে

Google Workspace অ্যাডমিনিস্ট্রেটর যদি ব্যবহারকারীদের চ্যাট ইতিহাস চালু বা বন্ধ করার অনুমতি না দেন, তাহলে এমন সময় আসতে পারে যখন ব্যবহারকারীরা কোনও স্পেসে যোগ দিতে বা থাকতে পারবেন না। এর কারণ হল, ব্যবহারকারী-লেভেলের এমন একটি সেটিং যা চ্যাট ইতিহাস চালু বা বন্ধ করতে বাধ্য করে এবং এমন একটি স্পেস যা সংস্থা-লেভেলের বাধ্যবাধকতা সেটিং ইনহেরিট করে, এই দুটির মধ্যে বিরোধ।

যেমন, কোনও ব্যবহারকারীর চ্যাট ইতিহাস সেটিং যদি জোর করে "চালু" করা থাকে এবং কোনও স্পেসের চ্যাট ইতিহাস সেটিং যদি জোর করে "বন্ধ" করা থাকে, তাহলে সেই ব্যবহারকারী স্পেসে যোগ দিতে নাও পারেন। এছাড়াও, সেই ব্যবহারকারী যদি বিরোধের আগে যোগ দিয়ে থাকেন এবং বিরোধের পরে স্পেসে মেসেজ পোস্ট করেন, তাহলে তাকে স্পেস থেকে সরিয়ে দেওয়া হতে পারে।

এই পরিস্থিতি এবং অন্যান্য পরিস্থিতিতে যেখানে ইতিহাস সেটিংসের মধ্যে বিরোধ থাকে, সেখানে Chat API মেম্বারশিপ তৈরি করতে নাও পারে অথবা ব্যবহারকারীর যাচাইকরণ সহ মেসেজ তৈরি করলে, বিরোধপূর্ণ Chat ইতিহাস সেটিংস সহ যাচাই করা ব্যবহারকারীকে স্পেস থেকে সরিয়ে দেওয়া হতে পারে।

আরও জানতে, Google Workspace অ্যাডমিন সহায়তা কেন্দ্রে ব্যবহারকারীদের স্পেস থেকে বাদ দেওয়া যেতে পারে দেখুন।

Google Apps Script-এ উন্নত চ্যাট পরিষেবা সংক্রান্ত সমস্যার সমাধান করা

উন্নত চ্যাট পরিষেবা সম্পর্কে Apps Script পৃষ্ঠা দেখুন।

ব্যবহারকারীরা স্পেসে Chat অ্যাপ যোগ করতে পারছেন না

ব্যবহারকারীরা কোনও স্পেসে Chat অ্যাপ যোগ করার চেষ্টা করার সময় This organization's administrator must allow users to install this Chat app সমস্যার মেসেজ দেখতে পেলে, এই সমস্যা নিচে উল্লেখ করা কারণগুলির মধ্যে কোনও একটির জন্য হতে পারে:

  • সংস্থা Chat অ্যাপ বন্ধ করে দিয়েছে।
  • সংস্থাটি এই নির্দিষ্ট Chat অ্যাপকে সংস্থার অনুমোদিত তালিকায় যোগ করেনি।

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

এই সমস্যার সমাধান কীভাবে করবেন সেই সম্পর্কে তথ্য পেতে, ব্যবহারকারীদের Chat অ্যাপ ইনস্টল করার অনুমতি দিন দেখুন।

এই অ্যাকশনের জন্য অ্যাডমিনিস্ট্রেটরকে অ্যাপকে প্রয়োজনীয় OAuth অনুমোদন স্কোপ দিতে হবে

Chat অ্যাপ হিসেবে যাচাই করার সময়, আপনি নিম্নলিখিত সমস্যা সংক্রান্ত মেসেজ পেতে পারেন:

<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.">

এই সমস্যার মেসেজের অর্থ হল, Google Workspace অ্যাডমিনিস্ট্রেটর এখনও Chat অ্যাপকে একবারের জন্য অনুমোদন দেননি যাতে সেটি https://www.googleapis.com/auth/chat.app.* নামের সাথে শুরু হওয়া অনুমোদনের স্কোপ ব্যবহার করতে পারে।

সমস্যার সমাধান করতে:

  • Google Workspace অ্যাডমিনিস্ট্রেটরকে আপনার Chat অ্যাপকে অনুমোদন দিতে বলুন। আপনার Chat অ্যাপ লজিকে এই সমস্যাটি সমাধান করার সময়, একটি মেসেজ পাঠানোর কথা বিবেচনা করুন যাতে ঘোষণা করা হয় যে অনুরোধ করা অ্যাকশন পারফর্ম করার জন্য Chat অ্যাপের অ্যাডমিনিস্ট্রেটর অনুমোদন প্রয়োজন, যেমন: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • Chat API পদ্ধতিতে https://www.googleapis.com/auth/chat.bot যাচাইকরণের স্কোপ কাজ করলে, যা অ্যাডমিনিস্ট্রেটরের অনুমোদনের প্রয়োজন হয় না, এটি ব্যবহার করার কথা বিবেচনা করুন। কোনও পদ্ধতিতে কোন অনুমোদন স্কোপ কাজ করে তা চেক করতে, Google Chat অ্যাপ ও Google Chat API অনুরোধ যাচাই ও অনুমোদন করুন দেখুন।

Cloud Function সংক্রান্ত সমস্যার সমাধান করা

Chat অ্যাপ Cloud Functions-এর সাথে প্রয়োগ করা হলে এবং সেটি কাজ না করলে, নিম্নলিখিত বিভাগগুলি সমস্যা সমাধান করতে এবং সমস্যার সমাধান করতে সাহায্য করে।

Cloud Function লগ চেক করা

প্রথম ধাপ হিসেবে, Cloud Functions লগে কোনও সমস্যা আছে কিনা তা চেক করুন।

  1. Google API Console-এ, Cloud Functions পৃষ্ঠায় যান:

    Cloud Functions-এ যান

  2. লগ খুলতে, আপনার Chat অ্যাপের Cloud ফাংশন খুঁজুন, তারপর অ্যাকশন দেখুন > লগ দেখুন বিকল্পে ক্লিক করুন।

Logs Explorer খুলে যায় এবং Cloud Function লগ দেখানোর জন্য কোয়েরি রান করে, এর মধ্যে সমস্যাও অন্তর্ভুক্ত।

আপনার অ্যাপ ডিবাগ করার জন্য ডিফল্ট হিসেবে লগ করা তথ্য যথেষ্ট না হলে, আপনার Cloud Function কোড থেকে অতিরিক্ত লগিং যোগ করতে পারবেন। Cloud Function লগ দেখা ও লেখা দেখুন।

Cloud Function সংক্রান্ত সমস্যা চেক করা

লগ ছাড়াও, Cloud Function রান করার সময় হওয়া সমস্যার ব্যাপারে রিপোর্ট করতে পারে।

  1. Google API Console-এ, Cloud Functions পৃষ্ঠায় যান:

    Cloud Functions-এ যান

  2. আপনার Chat অ্যাপের ক্লাউড ফাংশনে ক্লিক করুন।

  3. ফাংশনের বিবরণ পৃষ্ঠায়, সমস্যা বিকল্পের অধীনে সমস্যার তালিকা দেওয়া আছে।

  4. কোনও সমস্যার আরও সমাধান করতে, সেটিতে ক্লিক করুন।

Cloud Function সংক্রান্ত সাধারণ সমস্যার সমাধান করা

Cloud Functions-এর মাধ্যমে Chat অ্যাপ তৈরি করার সময় নিম্নলিখিত সমস্যাগুলি কখনও কখনও দেখা যায়।

প্রোজেক্ট PROJECT_NAME-এর REGION_NAME অঞ্চলে ChatApp ফাংশন আগে থেকেই আছে

Cloud Function ডিপ্লয় করার সময়, আপনি হয়ত Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists সমস্যার মেসেজ পাবেন। এই মেসেজের অর্থ হল, আপনি যে Cloud Function ডেপ্লয় করছেন, অন্য একটি Cloud Function-এর নামও একই। নাম পরিবর্তন করে, ফাংশনটি আবার ডেপ্লয় করুন। Chat অ্যাপ আপনার Cloud Function-এর জন্য ট্রিগার URL ব্যবহার করে কিনা তা যাচাই করুন, আগে থেকে থাকা Cloud Function-এর ট্রিগার URL নয়।

নীতিতে উল্লেখ করা এক বা একাধিক ব্যবহারকারী অনুমোদিত গ্রাহকের সাথে যুক্ত নন

Cloud Function ডেপ্লয় করার সময়, আপনি The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." এই সমস্যার মেসেজ পেতে পারেন। আপনি এই সমস্যার মেসেজ পেলে এবং Chat অ্যাপে মেসেজ করলে, আপনি এই সমস্যার মেসেজ পাবেন যে অ্যাপটি উত্তর দিচ্ছে না কারণ Google Chat, Cloud Function হোস্ট করা সার্ভারে পৌঁছাতে পারছে না। এই মেসেজের অর্থ হল যে "allUsers" নামের ব্যবহারকারীর Cloud Function কল করার অনুমতি নেই। "allUsers"-কে "Cloud Functions Invoker" ভূমিকা দেওয়ার অর্থ হল, অ্যাপকে পাওয়ার প্রদানকারী Cloud Function সর্বজনীনভাবে উপলভ্য এবং যাচাইকরণ ছাড়াই অ্যাক্সেস করা যায়। কীভাবে কোনও ভূমিকা অ্যাসাইন করতে হয় তা জানতে, একটি ভূমিকা প্রদান করুন দেখুন।

এই সমস্যার অর্থ হতে পারে যে Google Cloud প্রোজেক্টে ডোমেন সংক্রান্ত বিধিনিষেধ আছে। ডোমেন বিধিনিষেধ সংক্রান্ত সীমাবদ্ধতা সম্পর্কে আরও জানতে, ডোমেন অনুসারে পরিচয় সীমাবদ্ধ করা লিঙ্কে দেখুন।

এই সমস্যার সমাধান করতে, আপনার Cloud Function যাচাই করুন যাতে যাচাই না করা ইনভোকেশন অনুমোদিত হয়। আগে থেকে থাকা Cloud Function-এর জন্য কীভাবে যাচাই না করা ইনভোকেশন অনুমোদন করতে হয় তা জানতে, সর্বজনীন (যাচাই না করা) অ্যাক্সেস অনুমোদন করা দেখুন।

অ্যাড-অন নয় এমন চ্যাট অ্যাপ: Google Chat অ্যাপ সংক্রান্ত সমস্যার সমাধান করা

Google Workspace অ্যাড-অন নয় এমন Chat অ্যাপের ক্ষেত্রে নিম্নলিখিত ডকুমেন্টেশন প্রযোজ্য। অ্যাড-অন নয় এমন কোনও Chat অ্যাপ মাইগ্রেট করতে, Chat অ্যাপকে Google Workspace অ্যাড-অনে কনভার্ট করুন লিঙ্ক দেখুন।

অ্যাড-অন নয় এমন কোনও Chat অ্যাপ যদি "অ্যাপ উত্তর দিচ্ছে না" বলে উত্তর দেয়, তাহলে Google API Console-এ Chat API-এর কনফিগারেশন ট্যাবে গিয়ে এইসব সেটিংস চেক করুন:

  • অ্যাপ স্ট্যাটাস বিকল্পের মধ্যে, আপনি লাইভ - ব্যবহারকারীদের জন্য উপলভ্য বিকল্প বেছে নিয়েছেন কিনা তা নিশ্চিত করুন।
  • ইন্ট্যার‍্যাক্টিভ ফিচার > কানেকশন সেটিংস বিকল্পের মধ্যে, এগুলি কনফিগার করা আছে কিনা দেখুন: আপনার HTTP এন্ডপয়েন্ট URL, Apps Script Deployment ID, Cloud Pub/Sub Topic Name অথবা Dialogflow এজেন্ট কনফিগার করা আছে কিনা এবং ডেপ্লয় করা আছে কিনা।