حل لمشاكل فشل Webhook في Workspace Studio

لقد أنشأتَ تدفقًا في Google Workspace Studio، وأضفتَ الخطوة إرسال إشعار عبر الويب ولا يصل الطلب إلى وجهته أبدًا. أو ربما كان المسار يعمل بشكل صحيح، ثم حدث خطأ ما. قبل تغيير عنوان URL بشكل عشوائي، يجدر التحقق من الأمر. متى يتوقف التنفيذ؟: الوصول إلى الخطوة، أو الموافقة المعلقة، أو تكوين الطلب، أو الاستجابة من الخدمة الخارجية.

يستخدم Workspace Studio هذه الخطوة لإرسال طلب HTTP إلى عنوان محدديمكن استخدام هذه الخاصية لإشعار أداة داخلية، أو إنشاء سجل في تطبيق آخر، أو إرسال بيانات إلى خدمة لا تملك موصلاً مباشراً. يعتمد الحل على ما إذا كان الحظر يحدث داخل Google Workspace أو على الخادم الذي يستقبل الطلب.

تحقق مما إذا كان المسؤول قد فعّل روابط الويب

Si إرسال إشعار عبر الويب لا يظهر هذا الخيار ضمن الخطوات المتاحة؛ ابدأ بصلاحيات المؤسسة. تشير جوجل إلى أن هذه الميزة... معطلة افتراضيا ويجب على المسؤول تفعيل هذه الميزة للوحدة التنظيمية المعنية. المسار هو: لوحة تحكم المسؤول > التطبيقات > مساحة عمل جوجل > استوديو مساحة العمل > إعدادات Webhook.

تأكد أيضًا من أن حسابك لديه إمكانية الوصول إلى هذه الميزة: لا تزال جوجل تُعرّف تمرير Webhook كميزة في معاينة محدودةإذا لم تكن مسؤولاً، فزوّد مسؤول مساحة العمل باسم الخطوة المفقودة، وحسابك، والوحدة التنظيمية التي تنتمي إليها. سيُمكّنهم ذلك من التحقق من الإعدادات المناسبة دون التأثير على صلاحيات الفرق الأخرى.

راجع قائمة عناوين المواقع الإلكترونية المسموح بها والموافقات

في بعض الإصدارات، يمكن للمسؤول تقييد الوجهات الخارجية باستخدام قائمة النطاقات وعناوين المواقع الإلكترونية المسموح بهاإذا كانت الخطوة موجودة ولكن لا يمكنك الاتصال بنقطة نهاية محددة، فتأكد من أن نطاقك أو عنوان URL الخاص بك موجود في تلك القائمة. تتم إدارة هذا الإعداد من خيارات استيراد واسترجاع عناوين URL في Drive وDocs.

هذا التقييد لا يعمل بنفس الطريقة في جميع الإصداراتتتوفر قائمة السماح الخاصة بخطافات الويب في إصدارات مثل Business Plus وEnterprise Standard وPlus وEducation Standard وPlus. في الإصدارات التي لا توفر هذه الميزة، يسمح تفعيل خطافات الويب بالاتصال بعناوين URL صالحة دون تطبيق قائمة السماح هذه. لذا، يُنصح بالتحقق أولاً من إصدارك وسياسة مؤسستك.

قد يكون التدفق ينتظر أيضًا موافقة المستخدمتعتبر جوجل إرسال البيانات إلى نقطة نهاية خارجية إجراءً حساسًا، وتتطلب مراجعة وتأكيدًا بشكل افتراضي. إذا بدا أن عملية التشغيل الآلي متوقفة، فافتح Studio وتحقق من طلبات الموافقة المعلقة قبل استنتاج أن الخادم قد تعطل.

قم بضبط عنوان URL والطريقة والبيانات المرسلة بشكل صحيح.

افتح التدفق في studio.workspace.google.com وتحقق من خطوة "إرسال رابط ويب". يجب أن يكون العنوان كالتالي: كامل وثابتيقبل هذا الحقل عنوان URL يبدأ بـ http:// o https://لكنها لا تسمح بإدخال المتغيرات في عنوان URL نفسه. يُعدّ بروتوكول HTTPS الخيار الموصى به لتجنب إرسال معلومات غير مشفرة؛ فهذا ليس شرطاً من شروط هذا المجال.

• طريقة HTTP: اختر الأمر الذي تتوقعه واجهة برمجة التطبيقات المستهدفة. يوفر Studio أوامر GET و POST و PUT و PATCH و DELETE؛ و POST هو الأمر الافتراضي.
• نص الطلب: هو اختياري ويتم إرساله كنص. بالنسبة للعديد من واجهات برمجة التطبيقات، يُنصح باستخدام JSON، مع مراعاة علامات الاقتباس والأقواس المعقوفة وأسماء الحقول المطلوبة من قِبل الخدمة.
• المتغيرات: يمكنك تضمين البيانات من الخطوات السابقة في نص الطلب. تحقق من النتيجة عندما يحتوي متغير ما على علامات اقتباس أو فواصل أسطر أو أحرف أخرى قد تُخلّ بتنسيق JSON.
• طلبات GET: يتجاهل الاستوديو نص الطلب عند استخدام هذه الطريقة. إذا كانت الخدمة تتطلب بيانات في نص الطلب، فتحقق من الطريقة التي تدعمها وثائقها.

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

استخدم علامة التبويب "النشاط" لتحديد موقع المشكلة

بعد كل عملية تنفيذ، افتح نشاط في Workspace Studio. إذا نجح الطلب، يمكنك مراجعة البيانات المرسلة والاستجابة المستلمة. أما إذا فشل، فسيعرض Studio رمز الخطأ وعنوان URL الوجهةتتيح لنا هذه المعلومات التمييز بين مشكلة في تكوين التدفق ورفض ناتج عن الخدمة الخارجية.

Un 400 يشير هذا عادةً إلى أن المُستقبِل لا يقبل الطلب كما هو مكتوب؛ بل يراجع طريقة الإرسال ومحتوى الرسالة. في حالة حدوث ذلك 401 أو 403تحقق من متطلبات الوصول إلى الخدمة والقيود المفروضة على مؤسستك. 404 يطلب منك التحقق من مسار نقطة النهاية. إذا كان 429تحقق من حدود طلبك؛ الأخطاء 5xx تشير هذه الرسائل عادةً إلى وجود مشكلة في الخدمة المستقبلة. ويكون الرد المحدد من نقطة النهاية أكثر فائدة من تفسير الرقم بمعزل عن غيره.

يمكن للمسؤولين أيضًا استشارة سجلات أحداث Workspace Studio لفحص طلبات الويب هوك. الوصول إلى بيانات معينة، مثل عنوان URL المطلوب، مقيد لأنها قد تحتوي على معلومات حساسة.

لا تخلط بين رابط الويب الخاص بـ Studio ورابط الويب الوارد من Google Chat.

الخطوة إرسال إشعار عبر الويب يقوم برنامج Workspace Studio بإرسال طلب إلى عنوان URL خارجي. رابط ويب وارد من Google Chatعلى النقيض من ذلك، فهو رابط URL مُنشأ ضمن مساحة مخصصة لنظام آخر لنشر الرسائل فيها. وهما عنصران منفصلان، على الرغم من إمكانية استخدام رابط الدردشة كوجهة لتدفق Studio.

إذا كان هدفك هو نشر إعلان على Google Chat، فتحقق أولاً مما إذا كانت الخطوة 1 كافية. انشر في مساحة من Studio. إذا كنت بحاجة إلى استخدام webhook وارد، فيجب عليك إنشاؤه من التطبيقات والتكاملات تُتيح هذه الروابط الإلكترونية الوصول إلى المساحة مع الحفاظ على خصوصية عنوان URL الخاص بها، والذي يتضمن مفتاحًا ورمزًا مميزًا. تُستخدم هذه الروابط لإرسال الرسائل إلى المساحة، ولكنها لا تسمح بالتواصل مع المستخدمين.

يطبق برنامج Google Chat حصة مشتركة على روابط الويب الواردة إليه. طلب واحد في الثانية ولكل مساحةينطبق هذا الحد على الدردشة؛ وهو ليس حدًا عامًا لخطوة إرسال إشعار ويب في Workspace Studio. إذا حدث خطأ عند نشر عدة إعلانات متتالية في نفس المساحة، فتحقق من هذا الحد مع استجابة الطلب.

تحقق من حصص التدفق إذا كانت الأخطاء متقطعة.

يتيح لك برنامج Workspace Studio إنشاء ما يصل إلى 25 تدفقًا لكل مستخدم، يخدع un máximo de 20 خطوة لكل تدفقبالإضافة إلى ذلك، يفرض النظام حدًا إجماليًا على عدد عمليات التنفيذ خلال كل فترة 24 ساعة. إذا وصلت إلى هذا الحد، ستفشل عمليات التنفيذ اللاحقة حتى تتم إعادة ضبط العداد.

عندما يفشل رابط الويب بعد عدة عمليات تنشيط، تحقق من نشاط تحقق من حدود كلٍ من Studio والخدمة المستهدفة. يمكن تحسين المُشغِّل - على سبيل المثال، حصره على مُرسِلين أو أحداث مُحدَّدة - لمنع الطلبات غير الضرورية. إذا حدث الخطأ عند التشغيل الأول، فابدأ بالتحقق من الأذونات والموافقات المُعلَّقة واستجابة نقطة النهاية.