المستلمون والتوجيه

تدير المستلمين في «Wallet Center ← المراقب ← قنوات الإشعارات». لكل مستلم اسم وقناة وحالة: «مفعّل» أو «غير مختبر» أو «التحقق معلّق» أو «يتعذر الوصول إليه» أو «متوقف». يمكنك إضافة ما يصل إلى 20 مستلمًا. يفتح «إضافة مستلم» مربع حوار بجميع القنوات؛ ولـ Discord زر خاص به هو «ربط Discord».

جرس الإشعارات على ftso.app موجود دائمًا. ويحدد المفتاح «التنبيهات في جرس الإشعارات» ما إذا كانت تنبيهات الإشارات تظهر هناك أيضًا؛ أما رسائل الحساب والنظام فتظهر دائمًا.

Telegram (محادثة خاصة)

1. اختر «إضافة مستلم»، ثم Telegram، وأدخل اسمًا.
2. اضغط «إنشاء رابط». الرابط صالح لمدة 10 دقائق ويعمل مرة واحدة.
3. افتح الرابط بنفسك، أو أرسله إلى الشخص الذي يجب أن يتلقى التنبيهات.
4. يفتح Telegram بوت FTSOBest Watchdog. اضغط Start.
5. عند العودة إلى Watchdog، يظهر المستلم بحالة «متصل». أرسل اختبارًا.

إذا انتهت صلاحية الرابط، فأنشئ رابطًا جديدًا ببساطة. وإذا حظرت البوت لاحقًا، تصبح حالة المستلم «يتعذر الوصول إليه».

مجموعة Telegram

1. اختر «إضافة مستلم»، ثم «مجموعة Telegram»، واضغط «إنشاء رابط».
2. افتح الرابط في Telegram واختر المجموعة.
3. أضف البوت كعضو. لا يحتاج إلى صلاحيات مشرف، لكن يجب أن يكون الشخص الذي يربطه مشرفًا في المجموعة.
4. تظهر المجموعة كمستلم. أرسل اختبارًا؛ يراه كل أعضاء المجموعة.

لا تُؤجَّل تنبيهات المجموعات خلال ساعات الهدوء. وهذا يجعل المجموعة مكانًا مناسبًا للتنبيهات التي يجب أن يراها فريقك كله.

Discord (رسالة مباشرة)

1. اضغط «ربط Discord». يُفتح Discord ويطلب منك تفويض تطبيق FTSOBest Watchdog.
2. تُضاف إلى خادم Discord الخاص بـ FTSOBest ثم تعود إلى Watchdog.
3. أكمل التحقق على الخادم. وحتى ذلك الحين يعرض المستلم «التحقق معلّق».
4. اضغط «تحقق مجددًا». عند العثور على التحقق، تصبح التنبيهات مفعّلة.

يوجد مستلم Discord واحد لكل محفظة. وإذا لم نتمكن من إضافتك إلى الخادم، فانضم إليه يدويًا ثم اربط مجددًا.

البريد الإلكتروني

1. اختر «إضافة مستلم»، ثم «البريد الإلكتروني»، وأدخل العنوان.
2. نرسل إليك رسالة تأكيد. افتحها واضغط Confirm address. الرابط صالح لمدة 48 ساعة.
3. يعرض المستلم «تم تأكيد البريد الإلكتروني — التنبيهات مفعّلة.»

إذا لم تصل الرسالة، فتحقق من مجلد البريد العشوائي واستخدم «إعادة إرسال الرسالة». ولحماية العناوين من إساءة الاستخدام، يمكن للمحفظة إطلاق 10 رسائل تأكيد في اليوم على الأكثر، ويتلقى كل عنوان 3 رسائل في اليوم على الأكثر. وإذا انتهت صلاحية رابط، فاحفظ العنوان مجددًا لتحصل على رابط جديد.

Webhook

لنظامك الخاص أو البوت أو التكامل الخاص بك. يرسل Watchdog كل تنبيه كطلب JSON POST موقّع.

1. اختر «إضافة مستلم»، ثم Webhook، وأدخل عنوان URL لنقطة النهاية الخاصة بك.
2. احفظ. يُعرض سر التوقيع مرة واحدة، مباشرة بعد الحفظ. احفظه في مكان آمن؛ إذ لا يمكن عرضه مرة أخرى.
3. اضغط «إرسال اختبار». يصبح المستلم نشطًا بعد اختبار ناجح.

يجب أن يستخدم عنوان URL بروتوكول HTTPS عامًا على المنفذ 443 أو على منفذ من 1024 فما فوق. تُرفض العناوين الخاصة والداخلية.

يحمل كل طلب الترويسات X-Watchdog-Signature وX-Watchdog-Timestamp وX-Watchdog-Payload-Version. التوقيع هو sha256=‎ متبوعًا بـ HMAC-SHA256 للطابع الزمني ونقطة والجسم الخام، ومفتاحه هو سرّك. قارنه في زمن ثابت وارفض الطوابع الزمنية القديمة لمنع إعادة إرسال الطلبات. تجد قائمة الحقول في مخطط Webhook، وأمثلة الشيفرة في توثيق API.

ويب هوك Discord

ينشر التنبيهات في قناة على خادم Discord الخاص بك. تحتاج إلى صلاحية إدارة Webhooks على ذلك الخادم.

1. في Discord، افتح Server Settings ← Integrations ← Webhooks واختر New Webhook.
2. اختر القناة واضغط Copy Webhook URL.
3. في Watchdog، اختر «إضافة مستلم»، ثم «ويب هوك Discord»، والصق الرابط.
4. احفظ واضغط «إرسال اختبار».

إذا حذف أحدٌ الـ Webhook في Discord، تصبح حالة المستلم «يتعذر الوصول إليه». أنشئ Webhook جديدًا والصق الرابط الجديد.

Webhook لـ Slack

1. افتح api.slack.com/apps واختر Create New App، ثم From scratch. أدخل اسمًا واختر مساحة العمل (workspace) الخاصة بك.
2. افتح Incoming Webhooks وفعّلها.
3. اختر Add New Webhook to Workspace، ثم اختر القناة واسمح بالوصول.
4. انسخ الرابط. يبدأ بـ https://hooks.slack.com/services/‎.
5. في Watchdog، اختر «إضافة مستلم»، ثم «Webhook لـ Slack»، والصق الرابط، واحفظ واضغط «إرسال اختبار».

لا تُدعم Webhooks الخاصة بـ Workflow، التي يحتوي عنوانها على /triggers/. استخدم Incoming Webhook.

المستلم المُعلَّم بـ «المستلم الافتراضي» يتلقى تنبيهات جميع المراقبات التي تستخدم الإعداد الافتراضي. يصبح أول مستلم Telegram أو Discord أو بريد إلكتروني لديك مستلمًا افتراضيًا تلقائيًا؛ أما Webhooks والمجموعات فلا.

في القسم «4. المستلمون» من محرر المراقبة تختار:

• «استخدام المستلمين الافتراضيين»: تصل المراقبة إلى الجرس وإلى جميع المستلمين الافتراضيين.
• اختيارك الخاص: ألغِ تحديد «استخدام المستلمين الافتراضيين» وحدّد المستلمين لهذه المراقبة. لا يمكن تحديد إلا المستلمين النشطين.
• «مستلمون مختلفون لمجموعات الإشارات»: أرسل مجموعات منفردة إلى جهة أخرى، مثل تنبيهات FDC إلى مجموعة Telegram الخاصة بفريقك فقط. يظهر هذا الخيار لأنواع المراقبة التي لها عدة مجموعات إشارات، مثل مراقبة المزوّد.

مثال: لديك مستلم بريد إلكتروني كمستلم افتراضي ومجموعة Telegram لفريقك. في مراقبة المزوّد تُبقي الإعداد الافتراضي وتوجّه المجموعتين FDC و«المخالفات» إلى مجموعة Telegram. تصل الآن تنبيهات FDC والمخالفات إلى الفريق، ويواصل كل ما عداها الوصول إلى بريدك الإلكتروني.

إذا كانت مراقبة لا تصل إلى أحد، يعرض المحرر «لا تصل هذه المراقبة إلى أي شخص حاليًا.»

تصبح حالة المستلم «يتعذر الوصول إليه» عندما يرفض الهدف التسليم بشكل دائم. ومن الأمثلة بوت محظور، أو مجموعة أُزيلت، أو Webhook محذوف في Discord أو Slack. عندئذ تفشل التنبيهات الموجهة إلى هذا المستلم، ويعرض «سجل التنبيهات» الخطأ.

1. افتح «سجل التنبيهات»، وصفِّ على «الفاشلة فقط»، وافتح أحدث تنبيه. يعرض سطر التسليم الخاص بهذا المستلم الخطأ.
2. عالج السبب: ألغِ حظر البوت، أو أضفه إلى المجموعة مجددًا، أو أنشئ عنوان Webhook جديدًا.
3. اضغط «إرسال اختبار». الاختبار الناجح يزيل هذه الحالة.
4. إذا اختفى الهدف نهائيًا، فأزل المستلم. يعرض مربع الحوار عدد المراقبات المتأثرة.

• إشعارات داخل التطبيق: يظهر كل تنبيه في جرس الإشعارات على ftso.app. يستمر التسليم خلال ساعات الهدوء.
• Webhook: طلب JSON POST موقّع بـ HMAC إلى نقطة https الخاصة بك — للبوتات والتكاملات. يستمر التسليم خلال ساعات الهدوء.
• Telegram: التنبيهات كرسالة مباشرة من بوت FTSOBest Watchdog. تُؤجَّل خلال ساعات الهدوء.
• مجموعة Telegram: تنبيهات يراها جميع أعضاء مجموعة Telegram. يستمر التسليم خلال ساعات الهدوء.
• Discord: التنبيهات كرسالة مباشرة من بوت FTSOBest Watchdog على Discord الخاص بنا. تُؤجَّل خلال ساعات الهدوء.
• البريد الإلكتروني: تنبيهات عبر البريد الإلكتروني إلى عنوان تؤكده مرة واحدة. تُؤجَّل خلال ساعات الهدوء.
• ويب هوك Discord: ينشر التنبيهات في قناة على خادم Discord الخاص بك عبر رابط الويب هوك. يستمر التسليم خلال ساعات الهدوء.
• Webhook لـ Slack: يرسل التنبيهات إلى قناة في مساحة عمل Slack عبر رابط Webhook وارد. يستمر التسليم خلال ساعات الهدوء.