تُشفَّر بيانات الاعتماد وعناوين webhook قبل تخزينها. اجعل بيانات اعتماد القنوات مقصورة على إرسال الإشعارات، وبدّلها إذا انكشفت.
إضافة وجهة
1
أنشئها
افتح الإعدادات ← الإشعارات، واختر إضافة وجهة، وأدخل اسمًا، واختر قناة واحدة أو أكثر. أضف تفاصيل الوجهة وأي إشارات.
2
اختبر كل قناة
اختر إرسال اختبار لكل قناة، ثم أنشئ الوجهات بعد نجاح كل الاختبارات.
3
احفظ سر التوقيع
يحصل الـ webhook المخصص على سر توقيع عند إنشائه. انسخه من مربع الحوار الذي يُفتح؛ فهو يُعرض مرة واحدة فقط.
POST /v1/notifications/destinations، واختبرها باستخدام POST /v1/notifications/destinations/{id}/test، ثم اختر التنبيهات التي تتلقاها باستخدام PUT /v1/notifications/routes/{eventKind}، مع مفتاح إدارة.
استخدم الإشارات باعتدال: أرسل التنبيهات الكثيرة إلى قناة مراقَبة بدلًا من استدعاء مجموعة واسعة.
تفعيل تنبيهات المنتج
تسرد صفحة الإشعارات أنواع التنبيهات المتاحة لمساحة عملك. تتلقى الوجهات التنبيه إضافةً إلى أي مستلمين مدمجين يظهرون في لوحة التحكم. تُرسل تنبيهات إيقاف النماذج إشعارًا قبل إيقاف نموذج تستخدمه مساحة العمل. تُرسل إشعارات النموذج البديل عندما يكون توجيه النماذج المتوقفة مفعّلًا ويجيب نموذج بديل عن طلبات مساحة العمل لنموذج لم يعد أي مزوّد يقدّمه. يُرسل إشعار واحد لكل نموذج وبديله، في المرة الأولى التي يجيب فيها بديل بنجاح. يتلقى مالك مساحة العمل رسالة بريد إلكتروني دائمًا؛ اختر وجهات لإرسال الإشعار إلى فريقك أيضًا.تقارير الإنفاق
يتلقى مالكو مساحة العمل كل يوم اثنين الساعة 09:00، وفق المنطقة الزمنية للفوترة في مساحة العمل، بريدًا إلكترونيًا بتقرير الإنفاق يغطي الأسبوع السابق من الاثنين إلى الأحد. غيّر ذلك من تنبيهات الإنفاق ← إعدادات إنفاق مساحة العمل في صفحة الإشعارات: يومي (الساعة 09:00، عن اليوم السابق)، أو أسبوعي، أو شهري (في اليوم الأول، عن الشهر السابق)، أو إيقاف، وما إذا كان المسؤولون يتلقونه أيضًا. تُتخطّى الفترات التي لا إنفاق فيها. يعرض كل تقرير الإنفاق والتغيّر مقارنةً بالفترة السابقة، وأعلى المفاتيح والنماذج والأعضاء والأقسام، وتوقّع هذا الشهر، والمدة المتبقية للرصيد، وتنبيهات الإنفاق وحالات الحظر خلال الفترة. يمكن لكل من يتلقاه إلغاء الاشتراك من الرابط الموجود في البريد؛ وهذا يوقف نسخته فقط من تقرير مساحة العمل تلك. تتلقى الوجهات الموجّهة إلى تقارير الإنفاق ملخصًا واحدًا لكل تقرير. الإعدادات نفسها هيspend.report_cadence وspend.report_include_admins في API إعدادات الإشعارات.
للحصول على تنبيهات بشأن الإنفاق والميزانيات والتوقعات والارتفاعات المفاجئة وانخفاض الرصيد، ولحظر الطلبات بعد تجاوز الإنفاق حدًا معيّنًا، راجع تنبيهات الإنفاق.
يجري طرح رسائل تقارير الإنفاق تدريجيًا. وإلى أن تُفعَّل، يُحفظ اختيارك لكن لا يُرسَل أي تقرير.
إبقاء الوجهات تعمل
استخدم إرسال اختبار بجانب وجهة موجودة بعد تدوير بيانات الاعتماد أو تغيير قناتها. أزِل الوجهات التي لا يراقبها أحد، حتى لا تبدو التنبيهات مُسلَّمة وهي تصل إلى قناة مهجورة. يجب على مستقبِل الـ webhook المخصص التحقق من كل طلب قبل معالجته، وإرجاع استجابة نجاح بسرعة، ونقل العمل الأبطأ إلى مهمة في الخلفية.التحقق من توقيعات webhook
يوقّع Phaseo كل عملية تسليم لـ webhook مخصص، بما فيها الاختبارات المرسلة من وجهة محفوظة، بالمخطط نفسه المستخدم في webhooks الفيديو والدفعات. يحمل كل طلب هذه الترويسات:x-phaseo-signature هو HMAC-SHA256 بالصيغة الست عشرية لقيمة x-phaseo-timestamp، ثم نقطة حرفية (.)، ثم نص الطلب دون تعديل، باستخدام سر توقيع الوجهة (whsec_…) مفتاحًا. وx-phaseo-timestamp بثواني Unix.
للتحقق من عملية تسليم:
- اقرأ نص الطلب الخام قبل تحليله بصفته JSON.
- أعد حساب التوقيع وقارنه في زمن ثابت.
- ارفض الطوابع الزمنية التي تبعد أكثر من خمس دقائق عن ساعتك.
- أزل التكرار بناءً على
x-phaseo-event-id. تُعاد محاولة عمليات التسليم الفاشلة، وتُوقَّع كل محاولة مجددًا بطابع زمني جديد.
إنشاء سر أو تدويره
يُعرض السر مرة واحدة، عند إنشاء الوجهة. لاستبداله، اختر تدوير السر بجانب الوجهة في الإعدادات ← الإشعارات، أو استدعِPOST /v1/notifications/destinations/{id}/rotate-secret. تُوقَّع عملية التسليم التالية بالسر الجديد ويتوقف السر القديم عن العمل، لذا حدّث المستقبِل فورًا.
الـ webhooks المخصصة التي أُنشئت قبل توفر التوقيع ليس لها سر وما زالت تُسلَّم دون توقيع. تظهر في الإعدادات بعلامة غير موقّع. اختر إنشاء سر، وأضف السر إلى المستقبِل، ثم أرسل اختبارًا للتحقق من التحقق. الاختبارات المرسلة من لوحة إضافة وجهة، قبل حفظ الوجهة، غير موقّعة لأنه لا يوجد سر بعد.
لا تُوقَّع وجهات البريد الإلكتروني وSlack وDiscord وMicrosoft Teams: فهذه الخدمات تصادق على عنوان webhook أو رمز bot بنفسها.