عن المشروع

SMS Gateway for Android هو تطبيق أندرويد يحوّل الهاتف الذكي إلى بوابة رسائل نصية، مما يتيح للتطبيقات والخدمات إرسال واستقبال رسائل SMS برمجياً عبر واجهة برمجة تطبيقات أو أداة سطر أوامر. يُوزَّع التطبيق بموجب ترخيص Apache-2.0 وهو مبني باستخدام Kotlin وKtor وRoom وFirebase. القدرات الأساسية - إرسال واستقبال SMS عبر واجهة برمجة التطبيقات؛ لا يلزم التسجيل، ولا يتطلب الوضع المحلي أي حساب على الإطلاق. - يدعم أندرويد 5.0 والإصدارات الأحدث. - رسائل متعددة الأجزاء مع تقسيم تلقائي، بالإضافة إلى تتبع حالة الرسائل. - عارض الرسائل الواردة لـ SMS وData SMS وMMS مع تبويبات وإحصائيات. - إشعارات فورية للرسائل النصية ورسائل الوسائط الواردة عبر خطافات الويب، بما في ذلك قراءة الرسائل المستلمة سابقاً. - دعم MMS: إشعارات التنزيل مع النص والمرفقات، وإرسال MMS مع صور أو صوت أو فيديو أو ملفات، مع موضوع ونص اختياريين. - أحداث خطاف ويب مجمعة عند وصول رسائل متعددة دفعة واحدة. - إلغاء الرسائل المعلقة، وتصفية الرسائل حسب الحالة والنوع، وتطبيق حد لمعدل الإرسال لكل فترة. - دعم Data SMS للحمولات الثنائية (أوامر إنترنت الأشياء، الرسائل المشفرة). - جدولة ساعات العمل التي توقف قائمة الانتظار خارج النوافذ المحددة. - شاشة تشخيص قائمة انتظار خطافات الويب تعرض عمليات التسليم المعلقة وإعادة المحاولة. الأمان والخصوصية - تشفير شامل لمحتوى الرسائل وأرقام هواتف المستلمين قبل وصولها إلى واجهة برمجة التطبيقات، مع فك التشفير على الجهاز. - دعم خادم خاص بحيث يمكن تشغيل الواجهة الخلفية في بنيتك التحتية الخاصة. الميزات المتقدمة - دعم شرائح SIM متعددة ودعم أجهزة متعددة: الأجهزة المتصلة بنفس الحساب عبر خادم سحابي أو خاص تستقبل الرسائل موزعة فيما بينها. التكامل - خطافات ويب لأحداث مثل sms:received وsms:batch:received وsms:sent وsms:delivered وsms:failed وsms:cancelled وsms:data-received وmms:received وmms:downloaded وapp:started وsystem:ping. - تُرسل خطافات الويب مباشرة من الجهاز، لذا يحتاج الجهاز إلى اتصال إنترنت صادر. أوضاع التشغيل - الخادم المحلي: يشغّل التطبيق خادم HTTP على الجهاز، يمكن الوصول إليه على الشبكة المحلية، مع بيانات اعتماد مصادقة أساسية ووثائق Swagger تفاعلية على /docs. تتوفر أمثلة أوامر curl وأوامر سطر الأوامر لإرسال رسائل نصية ورسائل MMS. - الخادم السحابي: يتصل بـ api.sms-gate.app للأجهزة ذات عناوين IP الديناميكية أو المشتركة؛ تُرفع الرسائل المستلمة للوصول المركزي. يمكن نشر خادم خاص بدلاً من ذلك. التثبيت - تتوفر حزم APK مبنية مسبقاً من صفحة الإصدارات على GitHub، في إصدار إصدار آمن وإصدار تطوير غير آمن (يسمح بحركة المرور غير المشفرة، وليس للبيئات العامة). - الإذن المطلوب: SEND_SMS. الأذونات الاختيارية: READ_PHONE_STATE (اختيار شريحة SIM)، READ_SMS (قراءة الرسائل السابقة)، RECEIVE_SMS، RECEIVE_MMS وRECEIVE_WAP_PUSH (خطافات ويب للرسائل النصية ورسائل الوسائط الواردة). تشمل حالات الاستخدام المقصودة المصادقة الثنائية القائمة على الرسائل النصية، والرسائل المعاملاتية، والتذكيرات، والإشعارات، وملاحظات المستخدمين. يشير ملف README إلى أن الإرسال الجماعي غير موصى به بسبب القيود المحتملة من مشغلي شبكات المحمول.