تحديد وحلّ مشاكل تطبيق Google Chat

يوضّح هذا القسم المشاكل الشائعة التي يمكن أن تواجهها أثناء إنشاء تطبيقات Chat واختبارها.

لا يتم عرض رسالة بطاقة أو مربّع حوار أو معاينة رابط أو لا تعمل على النحو المتوقّع

للحصول على مساعدة في تحديد المشاكل في البطاقات وحلّها، اطّلِع على تحديد المشاكل في البطاقات وحلّها.

التطبيق لا يستجيب

إذا أرسلت رسالة إلى تطبيق Chat وظهرت لك الرسالة "التطبيق لا يستجيب"، تحقَّق من إعدادات تطبيق Chat باتّباع الخطوات التالية:

1. في Google API Console، انقر على القائمة menu > واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة > Google Chat API > الإعدادات.

   الانتقال إلى إعدادات Chat API

2. ضِمن الميزات التفاعلية، تأكَّد من أنّ الإعدادات مناسبة لوظائف تطبيقك. إذا كان تطبيق Chat يتفاعل مع المستخدمين، تأكَّد من تفعيل تفعيل الميزات التفاعلية:

   1. بشكلٍ تلقائي، يمكن للتطبيقات الردّ على الرسائل المباشرة من المستخدمين.
   2. إذا كان تطبيقك يردّ على الرسائل في المساحات والمحادثات الجماعية، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
   3. ضِمن إعدادات الاتصال، تأكَّد من ضبط بنية تطبيقك والمشغّلات (مثل عنوان URL لنقطة نهاية HTTP أو معرّف النشر واسم الدالة في مشروع Apps Script أو اسم الموضوع في Cloud Pub/Sub أو وكيل Dialogflow) بشكلٍ صحيح ومن نشر تطبيقك.
   4. ضِمن إمكانية الوصول، تأكَّد من أنّ المستخدمين المناسبين يمكنهم الوصول إلى التطبيق باستخدام عنوان البريد الإلكتروني أو مجموعة في نطاق Google Workspace. إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، لن تكون إعدادات مستوى الظهور ضرورية لأنّ إعدادات Google Workspace Marketplace لها الأولوية.

3. إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، راجِع إعدادات 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 استخدام تطبيقات Chat بدون حساب على Google Workspace. لمزيد من المعلومات حول كيفية عثور المستخدمين على تطبيقات Chat وتثبيتها، يُرجى الاطّلاع على مقالة إنشاء تطبيقات تفاعلية في Google Chat.

يمكن استبعاد المستخدمين من المساحات

إذا لم يسمح مشرف Google Workspace للمستخدمين بتفعيل سجلّ المحادثات أو إيقافه، قد لا يتمكّن المستخدمون أحيانًا من الانضمام إلى مساحة أو البقاء فيها بسبب تعارض بين إعداد على مستوى المستخدم يفرض تفعيل سجلّ المحادثات أو إيقافه ومساحة تكتسب الإعداد المفروض على مستوى المؤسسة.

على سبيل المثال، إذا كان لدى المستخدم إعداد سجلّ محادثات في Chat مفروض "تفعيله"، وكان لدى المساحة إعداد سجلّ محادثات في Chat مفروض "إيقافه"، قد لا يتمكّن المستخدم من الانضمام إلى المساحة. بالإضافة إلى ذلك، قد تتم إزالة هذا المستخدم من المساحة إذا انضم إليها قبل حدوث التعارض ثم نشر رسالة فيها بعد حدوث التعارض.

في هذا السيناريو وسيناريوهات أخرى تحدث فيها تعارضات بين إعدادات السجلّ، قد يتعذّر على Chat API إنشاء اشتراك، أو قد تؤدي عملية إنشاء رسالة باستخدام مصادقة المستخدم إلى إزالة المستخدم الذي تمّت مصادقته والذي لديه إعداد سجلّ محادثات متعارض من المساحة.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة يمكن استبعاد المستخدمين من المساحات في "مركز مساعدة مشرف Google Workspace".

تحديد المشاكل في خدمة Advanced Chat في Google Apps Script وحلّها

اطّلِع على صفحة Apps Script حول خدمة Chat المتقدّمة.

لا يمكن للمستخدمين إضافة تطبيق Chat إلى مساحة

إذا ظهرت للمستخدمين رسالة الخطأ This organization's administrator must allow users to install this Chat app عند محاولة إضافة تطبيق Chat إلى مساحة، قد يكون سبب هذا الخطأ أحد الأسباب التالية:

• أوقفت المؤسسة تطبيقات 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 Functions وحلّها

إذا تم تنفيذ تطبيق Chat باستخدام Cloud Functions ولم يكن يعمل، ستساعدك الأقسام التالية في تحديد المشكلة وحلّها.

التحقّق من سجلّات Cloud Function

كخطوة أولى، راجِع سجلّات Cloud Functions بحثًا عن الأخطاء.

1. في Google API Console، انتقِل إلى صفحة Cloud Functions:

   الانتقال إلى Cloud Functions

2. لفتح السجلّات، ابحث عن "وظيفة السحابة الإلكترونية" (Cloud Function) لتطبيق Chat، ثم انقر على عرض الإجراءات more_vert > عرض السجلّات.

يفتح "مستكشف السجلات" وينفّذ طلب بحث يعرض سجلّات Cloud Functions، بما في ذلك الأخطاء.

إذا لم تكن المعلومات التلقائية التي يتم تسجيلها كافية لتصحيح أخطاء تطبيقك، يمكنك إضافة تسجيل إضافي من رمز Cloud Function. يمكنك الاطّلاع على عرض سجلّات Cloud Functions وكتابتها.

التحقّق من أخطاء Cloud Functions

بالإضافة إلى السجلات، قد تُبلغ "دالة Cloud" أيضًا عن الأخطاء التي حدثت أثناء التشغيل.

1. في Google API Console، انتقِل إلى صفحة Cloud Functions:

   الانتقال إلى Cloud Functions

2. انقر على دالة Cloud لتطبيق Chat.

3. في صفحة "تفاصيل الدالة"، يتم إدراج الأخطاء ضمن الأخطاء.

4. لتحديد المشاكل وحلّها بشكلٍ أفضل، انقر على الخطأ.

حلّ أخطاء Cloud Functions الشائعة

تظهر الأخطاء التالية أحيانًا عند إنشاء تطبيق محادثات باستخدام Cloud Functions.

الدالة ChatApp في المنطقة REGION_NAME في المشروع PROJECT_NAME متوفّرة حاليًا

عند نشر إحدى دوال Cloud Functions، قد تظهر لك رسالة الخطأ Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists. تعني هذه الرسالة أنّ هناك دالة Cloud Function أخرى تحمل الاسم نفسه الذي تحمله الدالة التي تحاول نشرها. غيِّر الاسم، ثم أعِد نشر الدالة. تأكَّد من أنّ تطبيق Chat يستخدم عنوان URL الخاص بالمشغّل لوظيفة Cloud Function، وليس عنوان URL الخاص بالمشغّل لوظيفة Cloud Function الحالية.

هناك مستخدم واحد أو أكثر من المستخدمين المذكورين في السياسة لا ينتمون إلى عميل مسموح به

عند نشر 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. منح دور "منفّذ Cloud Functions" إلى "allUsers" يعني أنّ Cloud Function التي تشغّل التطبيق متاحة للجميع ويمكن الوصول إليها بدون مصادقة. لمعرفة كيفية إسناد دور، اطّلِع على منح دور واحد.

قد يعني هذا الخطأ أنّ مشروع Google Cloud مقيَّد حسب النطاق. لمزيد من المعلومات حول قيود حصر الهويات بالنطاق، يُرجى الاطّلاع على حصر الهويات بالنطاق.

لحلّ هذه المشكلة، تأكَّد من أنّ Cloud Function تتيح عمليات استدعاء غير مصادَق عليها. لمعرفة كيفية السماح بعمليات استدعاء غير مصادَق عليها لدالة Cloud Function حالية، يُرجى الرجوع إلى السماح بالوصول العام (غير المصادَق عليه).