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

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

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

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

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

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

  1. في Google Cloud Console، انقر على القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد

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

  2. ضمن حالة التطبيق، تأكَّد من اختيار تم نشر التطبيق - متاح للمستخدمين.

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

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

  4. إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، راجِع إعدادات Google Workspace Marketplace.

  5. انقر على حفظ.

  6. يُرجى محاولة إرسال رسالة إلى التطبيق مرة أخرى.

لا تتوفّر 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 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، قد يرجع السبب إلى أنّ المؤسسة منحَت إذن الوصول إلى وحدة تنظيمية فرعية بدون تفعيله للوحدة التنظيمية الرئيسية.

للاطّلاع على معلومات عن كيفية حلّ هذه المشكلة، يُرجى الاطّلاع على مقالة السماح للمستخدمين بتثبيت تطبيقات 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 ولم يعمل، تساعد الأقسام التالية في تحديد المشكلة وحلّها.

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

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

  1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":

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

  2. لفتح السجلات، ابحث عن ميزة Cloud Function في تطبيق Chat، ثم انقر على عرض الإجراءات > عرض السجلات.

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

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

التحقق من أخطاء دوال السحابة

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

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Cloud Functions:

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

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

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

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

إصلاح الأخطاء الشائعة في Cloud Functions

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

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

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

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

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

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

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