انتقل إلى المحتوى
ميلانو · كومو · منذ عام 2010SIM + SMPP / HTTP
FoxBox
القائمة

البنية التحتية لتكنولوجيا المعلومات

تكامل تم التحقق منه

Synology DSM
إشعارات الرسائل النصية القصيرة.

تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.

كيفية اتصالها

Synology DSMإشعار صحي من NAS
{}جسر خارجيالتحقق · الترجمة · إزالة التكرارات
▣FoxBoxواجهة HTTP موثقة
▤تم تكوين مسار الرسائل النصية القصيرةشريحة SIM أو خدمة خارجية عبر Kannel

01 / حالة الاستخدام

إشعار مفيد،
من حدث قائم.

يُصدر نظام إدارة التخزين (DSM) إشعارًا يتعلق بالتخزين أو الخدمة. يقوم موفر خدمة الويب هوك المخصص بإرساله إلى الجسر؛ ويقوم FoxBox بإرساله عبر مسار الرسائل النصية القصيرة المُكوّن.

تُضيف هذه الميزة مسارًا منفصلاً لإشعارات الرسائل النصية القصيرة. وهي لا تُحدد مدى توفر الخدمة ولا تُستبدل عملية الاستجابة للحوادث وتصعيدها الحالية.

02 / المتطلبات

قبل أن تبدأ.

  • موفر ويب هوك مخصص لنظام Synology DSM؛ الإصدار المراد التحقق منه
  • مضيف منفصل لجسر التكامل. لا يوجد أي شيء مثبت على برنامج FoxBox الثابت.
  • تم استخدام بايثون 3 للجسر وبيئة معزولة للاختبار الأول.
  • واجهة FoxBox HTTP متوافقة مع الوثائق app=ws, op=pv يجب تأكيد إصدار الجهاز والبرنامج الثابت.
  • لأي اختبار مباشر لاحق: يلزم وجود مستلم معتمد، وبيانات اعتماد صحيحة، ومسار رسائل نصية قصيرة مُفعّل. تتطلب مسارات شريحة SIM تغطية شبكة؛ وتتطلب الخدمات الخارجية الوصول إلى الإنترنت وإعدادات مزود الخدمة.
التوافق هو فحص للنشر.

تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.

أي جهاز FoxBox يناسب هذا التكامل؟

اختر التنسيق وعدد المودمات والشبكة التي تحتاجها. احتفظ بنظام Synology DSM كسياق للمشروع.

ابحث عن جهاز FoxBox المناسب لهذا التكامل →

03 / التركيب

ابدأ بالعزلة.

  1. جهز الجسر.

    قم بتنزيل حزمة المصدر. اتبع التعليمات الموجودة في ملف README الرئيسي لتكوين الجسر الخارجي في وضع التشغيل التجريبي، باستخدام عناصر نائبة ووجهة اختبار محلية.

  2. الخطوة الثانية

    راجع خيارات موفر إشعارات الويب هوك المخصصة في إصدار DSM الخاص بك.

  3. الخطوة 3

    استخدم حقول موفر الويب هوك المخصص من DSM من التكوين المقدم، مع وجود السر في رأس Authorization.

  4. الخطوة الرابعة

    اختبار تنسيق الموفر مقابل جسر التشغيل التجريبي قبل استخدام المستلمين الفعليين.

افتح ملف Synology DSM README الكامل ↗

04 / مراجعة الكود

لا شيء مخفي
خلف المثال.

الملفات أدناه مأخوذة من حزمة مصادر التكامل القابلة للتنزيل. يُرجى مراجعة دليل الجسر والتكامل بالكامل قبل استخدام المثال.

config.json
Loading source…

05 / التحقق من صحة المسار

اختبر المثال.
ثم اختبر عملية النشر.

اضبط إعدادات التكامل.

اختبارات طرفية معزولة
python3 -m unittest discover -s tests -v

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

ملاحظات الإعداد

تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.

06 / استكشاف الأخطاء وإصلاحها

اجعل الإخفاقات مرئية.

يرفض الجسر الحمولة.

تحقق من مطابقة حقول التكامل مع الإعدادات المُقدمة. استخدم الأمثلة الاصطناعية أولاً. لا تنسخ محتويات أحداث الإنتاج أو بيانات الاعتماد إلى سجلات الدعم.

انتهت مهلة الطلب.

تأكد من إمكانية الوصول، وبروتوكول TLS، وتنسيق الطلب المتوقع. لا تقم بإعادة إرسال طلب SMS غامض تلقائيًا: فقد يكون الطلب الأول قد تم قبوله بالفعل.

قبلت واجهة برمجة التطبيقات الطلب، لكن لم تصل أي رسالة نصية قصيرة.

قبول الطلب لا يُعدّ تأكيدًا للتسليم. يُرجى التحقق من حالة رسالة FoxBox الموثقة وظروف شبكة الجوال على الجهاز الحقيقي. تكامل تم التحقق منه.

تم إرسال حدث مكرر.

راجع إعدادات مفتاح حدث الجسر وإزالة التكرار. تحقق من صحة أحداث التجميع والاسترداد في البرنامج المستهدف قبل تفعيل الإشعارات المباشرة.

من التكامل إلى الأجهزة

اختر التنسيق.
تأكد من ملاءمة المنتج.

ابدأ بـ S1 لجهاز مودم واحد، أو S2 لجهازين، أو SR لتركيب جهاز مودم في رف. لا يحدد التكامل وحده سعة المودم أو متطلبات المرونة.

صورة من كتالوج FoxBox S2FoxBox S2 · جهاز صغير الحجم مزود بمودمين

التكوين والتحقق

الإعداد التقني: Synology DSM

الاتصال عبر جسر خارجي

في إشعارات DSM، أضف رابط ويب مخصص، واختر قاعدة الإشعار المطلوبة، واستخدم طلب POST مع application/x-www-form-urlencoded. أضف رأس Authorization وحقل رسالة يحتوي على @@TEXT@@. عنوان الجسر خارجي عن DSM وFoxBox. هذا تكوين رابط ويب مخصص لـ DSM، وليس برنامج تشغيل بديل لمزود خدمة الرسائل النصية القصيرة.

يستمد هذا الإعداد هوية مكررة من نص الإشعار ضمن نطاق زمني محدد. وبالتالي، يمكن دمج التنبيهات المتكررة المتطابقة؛ بينما قد يؤدي تغيير النص إلى إنشاء حدث جديد. وافق على هذا السلوك لإشعارات التخزين والنسخ الاحتياطي والطاقة قبل تفعيل القاعدة. احتفظ بتحديد الوجهة على الجسر.

مثال على التكوين · استبدل العناصر النائبة قبل الاستخدام

URL: https://bridge.example.invalid/webhooks/synology
Method: POST
Content-Type: application/x-www-form-urlencoded
Header Authorization: Bearer <PRIVATE_BRIDGE_TOKEN>
Form field message: @@TEXT@@

تحقق من صحة البيانات قبل تفعيل النقل

  • اختبر حدثًا اصطناعيًا واحدًا مرتين، وحدثًا متغيرًا ونصًا يحتوي على & و + وأحرف غير ASCII؛ تأكد من ترميز النموذج وسياسة التكرار.

مراجع: Synology DSM webhooks

واجهة برمجة تطبيقات FoxBox: المعلمات والأخطاء والحالة · مصادقة المحول ومعالجة التكرارات

↑

Contact US