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

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

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

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

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

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

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

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

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

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

    1. في حال ردّ تطبيقك على الرسائل، تأكَّد من اختيار تلقّي رسائل بين شخصين.
    2. ضمن إعدادات الاتصال، تأكَّد من ضبط عنوان URL للتطبيق أو رقم تعريف النشر لمشروع "برمجة التطبيقات" أو اسم الموضوع لخدمة 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" وحلّها

اطّلِع على صفحة "برمجة تطبيقات Google" عن خدمة الدردشة المتقدّمة.

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

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

  • أوقفت المؤسسة تطبيقات Chat.
  • لم تضف المؤسسة تطبيق Chat المحدد هذا إلى القائمة المسموح بها للمؤسسة.

إذا ظهرت رسالة الخطأ هذه لأحد المستخدمين عند محاولة التفاعل مع تطبيق في Chat، قد يرجع ذلك إلى أنّ المؤسسة تمنح إذن الوصول إلى وحدة تنظيمية فرعية، بدون تفعيل هذه الرسالة للوحدة التنظيمية الرئيسية.

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

تحديد مشاكل وظائف Cloud وحلّها

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

التحقّق من سجلات دالة Cloud

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

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

    الانتقال إلى دوال Cloud

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

يفتح "مستكشف السجلات" ويشغِّل استعلامًا يعرض سجلات دالة Cloud، بما في ذلك الأخطاء.

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

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

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

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

    الانتقال إلى دوال Cloud

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

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

  4. لمزيد من المعلومات حول تحديد مشاكل الخطأ وحلّها، انقر عليه.

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

تحدث أحيانًا الأخطاء التالية عند إنشاء تطبيق Chat باستخدام دوال السحابة.

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

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

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

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

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

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