يصف هذا القسم المشاكل الشائعة التي قد تواجهها أثناء إنشاء تطبيقات Chat واختبارها.
لا يتم عرض رسالة البطاقة أو مربّع الحوار أو معاينة الرابط أو لا تعمل على النحو المتوقّع
للحصول على مساعدة في تحديد مشاكل البطاقات وحلّها، اطّلِع على تحديد مشاكل البطاقات وحلّها.
التطبيق لا يستجيب
إذا أرسلت رسالة إلى تطبيق Chat وتلقّيت الرد "التطبيق لا يستجيب"، تحقَّق من إعدادات تطبيق Chat باتّباع الخطوات التالية:
في Google Cloud Console، انقر على القائمة > المزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعدادات.
ضِمن حالة التطبيق، تأكَّد من اختيار مباشر - متاح للمستخدمين.
ضِمن الميزات التفاعلية، تأكَّد من أنّ الإعدادات مناسبة لوظائف تطبيقك. إذا كان تطبيق Chat يتفاعل مع المستخدمين، تأكَّد من تفعيل تفعيل الميزات التفاعلية:
- بشكلٍ تلقائي، يمكن للتطبيقات الردّ على الرسائل المباشرة من المستخدمين.
- إذا كان تطبيقك يردّ على الرسائل في المساحات والمحادثات الجماعية، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
- ضِمن إعدادات الاتصال، تأكَّد من ضبط عنوان URL لنقطة نهاية HTTP أو رقم تعريف النشر لمشروع "برمجة التطبيقات" أو اسم الموضوع في Cloud Pub/Sub أو وكيل Dialogflow بشكلٍ صحيح ومن نشره.
- ضِمن إذن الوصول، تأكَّد من أنّ المستخدمين المناسبين يمكنهم الوصول إلى التطبيق باستخدام عنوان البريد الإلكتروني أو مجموعة في نطاق Google Workspace. إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، لن تكون إعدادات إمكانية الوصول ضرورية لأنّ إعدادات Google Workspace Marketplace لها الأولوية.
إذا تم نشر التطبيق باستخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، راجِع إعدادات Google Workspace Marketplace.
انقر على حفظ.
حاوِل مراسلة التطبيق مرة أخرى.
لا تتوفّر واجهة برمجة التطبيقات 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 من إنشاء اشتراك، أو قد يؤدي إنشاء رسالة باستخدام مصادقة المستخدم إلى إزالة المستخدم الذي تمّت مصادقته والذي لديه إعداد سجلّ محادثات متضارب من المساحة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة يمكن استبعاد المستخدمين من المساحات في مركز مساعدة مشرف 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 Functions وحلّها
إذا تم تنفيذ تطبيق Chat باستخدام Cloud Functions ولم يكن يعمل، ستساعدك الأقسام التالية في تحديد المشكلة وحلّها.
التحقّق من سجلّات Cloud Functions
كخطوة أولى، راجِع سجلّات Cloud Functions بحثًا عن أخطاء.
في Google Cloud Console، انتقِل إلى صفحة Cloud Functions:
لفتح السجلّات، ابحث عن Cloud Function لتطبيق Chat، ثم انقر على عرض الإجراءات > عرض السجلّات.
يفتح "مستكشف السجلات" ويُنفّذ طلب بحث يعرض سجلّات Cloud Functions، بما في ذلك الأخطاء.
إذا لم تكن المعلومات التلقائية التي يتم تسجيلها كافية لتصحيح أخطاء تطبيقك، يمكنك إضافة تسجيل إضافي من رمز Cloud Function. يمكنك الاطّلاع على عرض سجلّات Cloud Functions وكتابتها.
التحقّق من أخطاء "وظيفة السحابة الإلكترونية"
بالإضافة إلى السجلات، قد تُبلغ "دالة السحابة الإلكترونية" أيضًا عن الأخطاء التي حدثت أثناء تشغيلها.
في Google Cloud Console، انتقِل إلى صفحة Cloud Functions:
انقر على دالة Cloud لتطبيق Chat.
في صفحة "تفاصيل الدالة"، يتم إدراج الأخطاء ضمن الأخطاء.
لتحديد المشاكل وحلّها بشكلٍ أفضل، انقر على الخطأ.
حلّ الأخطاء الشائعة في Cloud Functions
تظهر الأخطاء التالية أحيانًا عند إنشاء تطبيق Chat باستخدام 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 حالية، يُرجى الرجوع إلى السماح بالوصول العام (غير المصادَق عليه).