دعم الإضافات الخارجية: تكامل Pushover

يدعم MagicTradeBot التكامل الأصلي مع Pushover — وهي خدمة إشعارات فورية بسيطة وموثوقة. يتيح هذا التكامل لمثيلات البوت إرسال تنبيهات وإشعارات الأحداث الفورية مباشرة إلى أجهزتك المحمولة أو سطح المكتب أو المتصفح.

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

مع انتشار البوتات في مراقبة وتداول مئات أزواج العملات الرقمية، يصبح التتبع اليدوي غير عملي — ويأتي دور Pushover لضمان عدم تفويت أي أحداث مهمة.

🚀 نظرة عامة

يتيح تكامل Pushover لـ MagicTradeBot إرسال رسائل مخصصة لـ:

  • تنفيذ التداولات (شراء / بيع)
  • تشغيل الاستراتيجيات وتحقيق الأرباح
  • الأخطاء والاستثناءات أو تحذيرات النظام
  • إجراءات على مستوى الحساب (مثل: رصيد غير كافٍ، أو تجاوز حدود API)

🔧 الميزات الرئيسية

  • 📲 إشعارات فورية إلى الأجهزة المحمولة أو سطح المكتب
  • 🚨 إمكانية تحديد مستويات الخطورة (معلومة، تحذير، حرجة)
  • 📡 يعمل عبر جميع مثيلات البوت والتوزيعات
  • 🔁 يدعم المستخدمين الأفراد والمجموعات
  • 📊 تسليم رسائل خفيفة وسريعة

🛠️ المتطلبات الأساسية

  • حساب Pushover صالح
  • مفتاح المستخدم الخاص بك (المُستلِم) ورمز API للتطبيق
  • اتصال بالإنترنت من الخادم المستضيف للبوت لإجراء طلبات HTTPS الصادرة

⚙️ خطوات الإعداد

1. احصل على بيانات اعتماد Pushover

سجّل الدخول إلى حساب Pushover الخاص بك وأنشئ تطبيقًا جديدًا للحصول على رمز API. ثم انسخ:

  • مفتاح المستخدم: موجود في لوحة التحكم
  • رمز API: من التطبيق الذي أنشأته

2. تحديث إعدادات البوت

أضف إعدادات Pushover إلى ملف إعدادات MagicTradeBot (مثل config.yaml):

alerting:
  pushover:
    enabled: true
    user_key: "YOUR_PUSHOVER_USER_KEY"
    api_token: "YOUR_PUSHOVER_API_TOKEN"
    device: "mobile"
    priority: "normal"
    sound: "magic"

3. تحديد المشغلات للإشعارات

يمكنك تحديد أنواع الأحداث التي يجب أن تُطلق إشعارات Pushover، مثل:

  • نتائج تنفيذ الصفقات (نجاح أو فشل)
  • نقاط دخول وخروج الاستراتيجية
  • تجاوز العتبات (مثل: معدل خطأ مرتفع أو هامش منخفض)

4. اختبار التكامل

نفّذ إشعارًا تجريبيًا للتحقق من صحة الإعداد: 

curl -s \
  --form-string "token=YOUR_PUSHOVER_API_TOKEN" \
  --form-string "user=YOUR_PUSHOVER_USER_KEY" \
  --form-string "message=MagicTradeBot test notification" \
  https://api.pushover.net/1/messages.json

🧪 نموذج حمولة إشعار

{
  "title": "تنبيه من MagicTradeBot",
  "message": "تم تنفيذ صفقة شراء على ETH/USDT. الربح: +2.45%",
  "priority": 1,
  "sound": "magic",
  "device": "mobile",
  "timestamp": "2025-06-20T12:42:15Z"
}

✅ فوائد تكامل Pushover

  • 📍 تحديثات فورية بدون الحاجة إلى مراجعة السجلات أو لوحات التحكم
  • ⚠️ إشعارات بالتداولات، الأخطاء، والأحداث أثناء التنقل
  • 🧘 لا حاجة إلى أدوات مراقبة ثقيلة أو استعلامات دورية
  • 🔒 آمن ومحدود بمعدل تسليم مع تأكيدات
  • 📱 إشعارات قابلة للتخصيص حسب الجهاز ومستوى الخطورة

📎 Related Topics