Whats360 وVCash: الدليل التقني الكامل لربط أجهزة المحافظ وإرسال SMS وتنفيذ USSD وأتمتة المعاملات عبر API

Whats360 هي منصة متكاملة لإدارة واجهات برمجة التطبيقات (API) الخاصة بالأجهزة المحمولة، وإرسال الرسائل، والأتمتة التشغيلية، وخدمات المحافظ الإلكترونية VCash. تُتيح المنصة ربط أجهزة Android الحقيقية وتوزيعها كبوابات لإرسال واستقبال رسائل SMS، تنفيذ أوامر USSD، تشغيل الحملات الجماعية، بناء سيناريوهات تفاعلية متعددة الخطوات، تحليل رسائل المحافظ باستخدام أنماط Regex، وتحويل البيانات المستخرجة تلقائيًا إلى معاملات مالية داخل سجل الحسابات، مع توفير بوابة API شاملة لإتاحة التحكم البرمجي الكامل من الأنظمة والتطبيقات الخارجية.

تبدأ دورة العمل الفعالة بتجهيز هاتف Android وتثبيت تطبيق VCash Gateway ومنحه الصلاحيات المطلوبة، ثم ربط الجهاز بالمنصة عبر تقنية رمز الاستجابة السريعة (QR Code). وبعد استقرار الاتصال، تتم إدارة عمليات SMS وUSSD وتصفية الرسائل من لوحة التحكم مباشرة، أو إسناد هذه المهام للأنظمة البرمجية الخارجية عبر واجهات API التابعة للمنصة.

الملخص التنفيذي للهندسة التشغيلية

تُمثل منصة Whats360 طبقة برمجية وسيطة (Middleware) تهدف إلى سد الفجوة بين الأجهزة الفعلية (Hardware/Smartphones) والأنظمة السحابية (Cloud Systems). بدلاً من الاعتماد على بوابات SMS تقليدية مكلفة أو معقدة، تُحول المنصة أي هاتف يعمل بنظام Android يحمل شريحة SIM إلى بوابة إرسال واستقبال وأتمتة مالية لخدمات VCash.

الهيكلية التقنية لمنظومة الربط والأتمتة

تتكون المنظومة التقنية المعمارية من ثلاث طبقات رئيسية تعمل بتكامل آلي متواصل لضمان تدفق البيانات دون انقطاع:

طبقة الجهاز والاتصال

تطبيق VCash Gateway الذي يعمل كبوابة محلية على نظام Android ويتولى تشغيل الخدمات في الخلفية، وإدارة شريحة SIM، واستقبال الرسائل، وتنفيذ أوامر USSD عبر الشريحة.

طبقة المعالجة والأتمتة

محرك Whats360 السحابي ولوحة التحكم التي تتولى تصفية الرسائل، تحليل النصوص باستخدام Regex، إدارة الأجهزة، بناء سيناريوهات USSD، وتسجيل المعاملات في الحسابات.

طبقة التكامل والربط

مجموعة واجهات RESTful API تُتيح للمطورين إجراء كافة العمليات برمجياً بأسلوب موحد وآمن لربط الأنظمة الخارجية والمتاجر الإلكترونية.

دورة حياة المعاملة من الشريحة إلى النظام المالي

لتفهم المنظومة ككتلة واحدة متكاملة، يتطلب الأمر تتبع رحلة البيانات منذ وصول رسالة SMS نصية من شركة الاتصالات (مثل VodafoneCA) على شريحة الهاتف، وحتى قيدها كمعاملة مالية في قاعدة البيانات وتمريرها عبر الـ Webhook/API الخاصة بالمنصة:

1. وصول الرسالة النصية: تتلقى شريحة SIM في هاتف Android رسالة إشعار بتحويل مالي من المزود.

2. الالتقاط الآلي: يلتقط تطبيق VCash Gateway الرسالة فوراً في الخلفية بفضل صلاحية الوصول للرسائل النصية.

3. التمرير لفلتر المُرِسل: يتم التحقق مما إذا كان مُرسل الرسالة يطابق النص المحدد في الإعدادات (مثل VodafoneCA أو vf-cash). إذا طابق الفلتر، تُمرر الرسالة، وإذا لم يطابق يُتم إهمالها.

4. تطبيق نمط التحليل (Regex Pattern): تقوم المنصة بتمشيط نص الرسالة باستخدام أنماط التعبير النمطي المحددة مسبقاً لاستخراج (المبلغ، رقم الهاتف، معرف العملية، اسم المُرِسل/المُستلم).

5. إنشاء المعاملة المالية: فور استخراج البيانات بنجاح، يُنشئ النظام معاملة مالية تلقائية (إيراد/مصروف) وتُسجل مباشرة في دفتر الحسابات مرتبط بالجهاز والوقت.

6. التكامل البرمجي: يصبح بمقدور أي نظام خارجي مرتبط استعلام المعاملة أو استلام بياناتها بصيغة JSON لمعالجتها في متجر إلكتروني أو نظام إدارة علاقات العملاء CRM.

تحليل خطط وباقات خدمة فودافون كاش على المنصة

تتيح صفحة إدارة باقات خدمة فودافون كاش على منصة Whats360 أربع باقات رئيسية مخصصة للربط والاستخدام، بالإضافة إلى تبويب أعلى الصفحة يحمل اسم مدى الحياة ورقم القيمة الخاصة به هو صفر. تتيح هذه الصفحة التحكم الكامل في الباقات وتحديد الخصائص والمميزات لكل مستوى استخدام.

اسم الباقة	الرمز البرمجي	السعر الشهري	السعر السنوي	سعة الأجهزة	حد الرسائل	الميزات الرئيسية
فودافون كاش – مجاني	VCash Free	0 جنيه	غير متوفر	1 جهاز (خصائص) / 5 أجهزة (حدود)	11 رسالة (خصائص) / 5 رسائل (حدود)	مخصصة للتجربة واختبار النظام
فودافون كاش – مبتدئ	VCash Starter	250 جنيه	2500 جنيه	جهاز واحد	500 رسالة شهرياً	دعم USSD، الحملات، وواجهة API
فودافون كاش – احترافي	VCash Pro	350 جنيه	3500 جنيه	5 أجهزة	10,000 رسالة شهرياً	سيناريوهات USSD متقدمة، ودعم API كامل
فودافون كاش – مؤسسات	VCash Enterprise	500 جنيه	5000 جنيه	20 جهازاً	100,000 رسالة شهرياً	USSD غير محدود، ودعم أولوية مخصص

تنويه تقني حول بيانات باقة VCash Free

تتضمن البيانات التوثيقية للباقة المجانية تفاصيلاً ظاهرة يجب الانتباه لها عند إعداد النظام؛ حيث يشير وصف خصائص الباقة إلى تقديم جهاز واحد و11 رسالة في الشهر تكلفة 0 جنيه، بينما تظهر بيانات الحدود الخاصة بالباقة إكانية ربط أجهزة حتى 5 أجهزة وبمعدل إرسال قدره 1 رسالة نصية في الشهر لكل جهاز وحد إجمالي يبلغ 5 رسائل. كما تظهر بيانات الحدود للباقات الثلاث الأخرى (Starter, Pro, Enterprise) معدل إرسال قدره 1 رسالة نصية في الشهر لكل جهاز ضمن تفاصيل البيانات الإدارية.

الخيارات التشغيلية للباقات وسيناريوهات الاستخدام

تُستخدم هذه الباقات في سيناريوهات مختلفة لتلبية احتياجات كافة أحجام المشاريع التجارية والتقنية وفق البنية التالية:

باقة التجربة (VCash Free): تناسب عمليات الاختبار والتأكد من توافق النظام قبل الاستثمار الفعلي.

الباقة المبتدئة (VCash Starter): تناسب المشاريع الناشئة التي تحتاج للربط البرمجي وإطلاق الحملات المحدودة.

الباقة الاحترافية (VCash Pro): تناسب الشركات المتوسطة التي تعتمد على سيناريوهات USSD معقدة مع أجهزة متعددة.

باقة المؤسسات (VCash Enterprise): تناسب الشركات الكبرى التي تتطلب كفاءة عالية وحجم رسائل ضخم يصل إلى 100,000 رسالة مع 20 جهازاً وأولوية في الدعم الفني.

عناصر التحكم والتفاعل في لوحة إدارة الباقات

تتضمن كل بطاقة من بطاقات الباقات الأربع ثلاثة أزرار تحكم تفاعلية متواجدة في أعلى اليمين وأعلى اليسار لضمان السيطرة الكاملة على الإعدادات البرمجية والمالية:

أيقونة سلة المهملات: تقع في زاوية البطاقة وتُستخدم لحذف الباقة نهائياً من النظام في حال الرغبة في إعادة إيكال الإعدادات.

أيقونة القلم: تُستخدم لتعديل اسم الباقة، أسعارها الشهرية والسنوية، حدود الأجهزة، حد الرسائل، والإعدادات البرمجية الخاصة بها.

أيقونة مقبض السحب والإفلات: المكونة من نقاط مصفوفة والمخصصة لإعادة ترتيب عرض الباقات داخل لوحة التحكم حسب الأولوية التشغيلية.

إعداد وتثبيت تطبيق VCash Gateway على هواتف Android

تعتمد الموثوقية التشغيلية للخدمة على إعداد التطبيق الميداني بالشكل الصحيح. يتطلب تطبيق VCash Gateway إتباع خطوات دقيقة لضمان استمرار الاتصال بالخادم دون انقطاع:

خطوات التثبيت والتأهيل التشغيلي

1. تحميل التطبيق بصيغة APK على هاتف يعمل بنظام Android وتثبيته مباشرة.

2. منح التطبيق كافة الصلاحيات المطلوبة والتي تشمل: صلاحية قراءة وإرسال الرسائل SMS، صلاحية إمكانية الوصول (Accessibility) لتنفيذ أوامر USSD، وصلاحية الإشعارات.

3. إنجاز عملية التسجيل باستخدام حساب المنصة ليعمل التطبيق في الخلفية تلقائياً ويستمر بالعمل حتى بعد إغلاقه أو إعادة تشغيل الهاتف.

خطوات ربط جهاز VCash بالمنصة والتأكد من الحالة

بعد تجهيز الهاتف، يتم الربط مع لوحة التحكم عبر الخطوات الترتيبية التالية:

الخطوة الأولى: الانتقال إلى تبويب أجهزة VCash داخل لوحة التحكم والنقر على خيار إضافة جهاز.

الخطوة الثانية: كتابة اسم مخصص للجهاز (مثل Device-Store-01) ثم النقر على زر إنشاء.

الخطوة الثالثة: فتح تطبيق VCash Gateway على الهاتف والضغط على ربط جهاز جديد ثم توجيه الكاميرا لمسح رمز QR الظاهر على شاشة لوحة التحكم.

الخطوة الرابعة: الانتظار لثوانٍ معدودة حتى تتحول حالة الجهاز في اللوحة إلى متصل. يجب التأكد من وجود الهاتف والمنصة على نفس الشبكة أو إتاحة الخادم عبر الإنترنت.

تتيح شاشة إدارة أجهزة VCash عرض معلومات تفصيلية تشمل: اسم الجهاز، الحالة التشغيلية (متصل/غير متصل)، معلومات شريحة SIM، رقم الشريحة، وتاريخ آخر ظهور للجهاز على الشبكة، مع توفير خيارات لتعطيل نسخ بيانات الربط أو إضافة جهاز جديد.

فلترة الرسائل واستخراج البيانات المالية بواسطة Regex

تتم عملية معالجة الرسائل النصية وتحويلها إلى معاملات مالية محددة عبر مسار معالجة يتضمن فلتر المُرِسل وأنماط الرسائل:

تكوين فلتر المُرِسل (Sender Filter)

لتجنب معالجة الرسائل الشخصية أو الإعلانات العامة، يُمكن الانتقال إلى إعدادات الجهاز واختيار فلتر المُرِسل، ثم إدخال اسم المُرِسل جزئياً مثل VodafoneCA أو vf-cash. عند ضبط هذا النص، سيقوم التطبيق بمعالجة وتمرير الرسائل التي تحتوي على هذا الاسم فقط. وفي حال ترك هذا الخيار فارغاً، سيتولى النظام معالجة كل الرسائل الواردة بدون تصفية.

بناء أنماط تحليل الرسائل (Regex Patterns)

تُستخدم التعابير النمطية لاستخراج البيانات الهيكلية من الرسائل النصية المتغيرة. يُمكن إضافة نمط جديد أو تعديل الأنماط الحالية من تبويب أنماط الرسائل. يستخرج كل نمط الحقول التالية تلقائياً:

المبلغ المالي المذكور في التحويل.
رقم هاتف الطرف الآخر (المُرسِل أو المُستلِم).
معرف العملية المرجعي (Transaction ID).
الاسم المسجل في إشعار التحويل.

يُطبق النمط تلقائياً على كل رسالة SMS واردة لإنشاء معاملة مالية دقيقة، وتوفر لوحة التحكم خياراً تفاعلياً لاختبار النمط على رسائل حقيقية قبل حفظه وتفعيله على النظام.

إدارة رسائل SMS والتحكم اليدوي والآلي

يُوفر تبويب رسائل SMS في قائمة VCash عرضاً شاملاً لكل الرسائل الواردة مع تفاصيل المبلغ، المُرِسل، وتاريخ الاستلام. كما يتيح التبويب إرسال رسالة SMS يدوية باستخدام زر الإرسال المباشر وتحديد الجهاز المُنفذ.

بينما تُستخدم اللوحة التشغيلية للتحكم اليدوي والمراقبة، فإن التطبيقات الخارجية تعتمد على الربط البرمجي الكامل لتمرير الأوامر واستقبال البيانات لحظياً.

توثيق واجهات برمجة التطبيقات API المتاحة للمطورين

تعتمد المنصة الرابط الرئيسي (Base URL) التالي لكافة العمليات البرمجية:
https://whats360.live/api/v1

تتم المصادقة على جميع الطلبات باستخدام مفتاح التوثيق API Token، وتصدر جميع الاستجابات بصيغة JSON الموحدة.

أكواد الأخطاء البرمجية المتوقعة:

400 Bad Request: يوجد خطأ في المعلمات المدخلة في الطلب.
401 Unauthorized: رمز التوثيق Token غير صحيح أو مفقود.
403 Forbidden: الحساب لا يملك الصلاحيات الكافية أو تجاوز الحدود المسموحة.
404 Not Found: الجهاز أو العنصر المطلوب غير موجود في النظام.
500 Internal Server Error: حدث خطأ غير متوقع داخل الخادم.

روابط إدارة الأجهزة عبر API:

1. عرض قائمة الأجهزة وحالتها:
الرابط (GET): https://whats360.live/api/v1/instances?token=[TOKEN_ID]
المعلمات: معامل التوكن الإجباري token.

2. إنشاء جهاز جديد:
الرابط (GET): https://whats360.live/api/v1/instances/create?token=[TOKEN_ID]&id=my-device&name=My+Device
المعلمات: token، معرف الجهاز الفريد id، واسم الجهاز name.

3. تشغيل / توصيل جهاز:
الرابط (GET): https://whats360.live/api/v1/instances/connect?token=[TOKEN_ID]&instance_id=[DEVICE_ID]
المعلمات: token، ومعرف الجهاز instance_id.

4. إيقاف جهاز:
الرابط (GET): https://whats360.live/api/v1/instances/disconnect?token=[TOKEN_ID]&instance_id=[DEVICE_ID]
المعلمات: token، ومعرف الجهاز instance_id.

5. الاستعلام عن حالة الجهاز:
الرابط (GET): https://whats360.live/api/v1/instances/status?token=[TOKEN_ID]&instance_id=[DEVICE_ID]
المعلمات: token، ومعرف الجهاز instance_id.

6. الحصول على رمز QR بصيغة JSON:
الرابط (GET): https://whats360.live/api/v1/instances/qr?token=[TOKEN_ID]&instance_id=[DEVICE_ID]
المعلمات: token، ومعرف الجهاز instance_id.

7. عرض صفحة QR التفاعلية:
الرابط (GET): https://whats360.live/api/v1/instances/qr-page?token=[TOKEN_ID]&instance_id=[DEVICE_ID]
المعلمات: token، ومعرف الجهاز instance_id.

8. حذف الجهاز:
تتوفر إمكانية خيار GET لحذف الجهاز من النظام نهائياً عبر المعلمات المحددة.

تُستخدم هذه الواجهات إضافة إلى واجهات إرسال الرسائل النصية، إرسال الوسائط، تنفيذ أوامر USSD، الاستعلام عن حالة الرسائل، استدعاء المحفظة، وقراءة رصيد الحساب.

تنفيذ أوامر USSD الفردية والجماعية وبناء السيناريوهات

تُوفر المنصة ثلاثة مستويات مختلفة للتفاعل مع شبكة الاتصالات عبر خدمات USSD:

1. تنفيذ أوامر USSD الفردية

من تبويب أوامر USSD، يتم كتابة الأمر (مثل *9*7#)، تحديد الجهاز ورقم شريحة SIM، ثم الضغط على تنفيذ. يُرسل الأمر للهاتف مباشرة وتُعرض استجابة الشبكة على الشاشة. وإذا أظهرت الشبكة حوار تأكيد، يُدخل النظام رمز PIN المخصص تلقائياً إذا تم تحديده مسبقاً في إعدادات الجهاز.

2. تشغيل حملات USSD الجماعية

لتنفيذ العمليات المكررة، يُوفر تبويب حملات USSD إمكانية إنشاء حملة جديدة عبر استخدام قالب الأمر ولصق قائمة الأرقام والمبالغ. يتم إدخال البيانات بصيغة رقم,مبلغ على أن يحتوي كل سطر على رقم واحد فقط. بعد الضغط على تشغيل، يُنفذ النظام الأوامر تتابعياً أوتوماتيكياً مع إمكانية إيقاف الحملة مؤقتاً واستئنافها لاحقاً.

3. بناء السيناريوهات متعددة الخطوات

يُتيح تبويب السيناريوهات إنشاء سيناريو أتمتة متعدد الخطوات. يمكن أن تكون كل خطوة عبارة عن أمر USSD أو أمر انتظار لعدد محدد من الثواني، مع إمكانية تعريف متغيرات واستخدامها ديناميكياً ضمن الخطوات مثل متغير رقم الهاتف ومتغير المبلغ.

دفتر الحسابات وتسجيل المعاملات المالية تلقائياً

يُسجل تبويب الحسابات جميع المعاملات المالية الواردة والصادرة بشكل آلي. يتم قيد المعاملة تلقائياً بمجرد وصول رسالة SMS ومطابقة نمط التحليل المحدد.

تتيح شاشة الحسابات إمكانيات تصفية متقدمة تشمل:

التصفية حسب الجهاز المُنَفِذ.
التصفية حسب نوع المعاملة (دخل أو مصروف).
التصفية حسب النطاق الزمني والتاريخ.

معايير الأمان وخصوصية البيانات والتعامل مع الطوارئ

نظرًا لطبيعة التعامل مع خدمات المحافظ الإلكترونية، تُطبق المنصة القواعد الأمنية التالية:

إرشادات الأمان والحماية الحاكمة

رمز التوثيق API Token: يُعتبر رمزاً خاصاً بكل جهاز وحساب، وتجب حمايته وعدم مشاركته مع أي طرف غير موثوق.

رمز USSD PIN: يتم حفظ رمز PIN وتشفيره داخل النظام ولا يُرسل إطلاقاً عبر رسائل SMS.

التعطيل الفوري عند الطوارئ: في حال فقدان الهاتف أو الشك في اختراقه، يجب الدخول إلى لوحة التحكم وتعطيل الجهاز فوراً. يُوقف التعطيل كافة العمليات الواردة والصادرة دون الحاجة لحذف بيانات الجهاز من النظام.

مقارنة بين الإدارة اليدوية والتكامل عبر API

وجه المقارنة	الإدارة من لوحة التحكم (يدوي)	التكامل البرمجي (API)
طريقة التنفيذ	عن طريق النقر والتفاعل مع الشاشات	عبر استدعاء الطلبات برمجياً من الخادم
حجم العمليات	مناسب للعمليات الفردية والمتابعة	مخصص للعمليات الضخمة والأتمتة الفورية
السرعة والتزامن	تتطلب وقتاً بشرياً لكل إجراء	تنفيذ لحظي بملي الثانية فور حدوث الحدث
معالجة الأخطاء	ملاحظة التنبيهات على الواجهة	معالجة أكواد الاستجابة (400, 401, 500…)

تحليل أسباب الفشل والخطوات العلاجية الميدانية

توضح النقاط التالية أبرز الحالات التشغيلية التي قد يواجه فيها النظام توقفاً وطريقة معالجتها بناءً على إعدادات المنظومة:

توقف استقبال الرسائل: يحدث عادةً بسبب فقدان تطبيق VCash Gateway للصلاحيات على الهاتف. العلاج: إعادة فتح التطبيق وتفقد منح صلاحية SMS وصلاحية العمل في الخلفية.

عدم تحول حالة الجهاز إلى متصل: يعود لعدم وجود إنترنت على الهاتف أو حجب الاتصال بالخادم. العلاج: التأكد من وجود الهاتف والمنصة على نفس الشبكة أو إتاحة الخادم عبر الإنترنت، وإعادة مسح رمز QR.

عدم تسجيل المعاملة الماليّة رغم وصول الرسالة: يحدث بسبب عدم تطابق اسم المُرِسل مع فلتر المُرِسل أو خطأ في نمط Regex. العلاج: مراجعة النص في فلتر المُرِسل واختبار نمط Regex في تبويب أنماط الرسائل على نص الرسالة الواردة.

فشل تنفيذ أوامر USSD التلقائية: يعود لتوقف صلاحية إمكانية الوصول (Accessibility) أو إدخال رمز PIN خاطئ. العلاج: إعادة تفعيل صلاحية الوصول للتطبيق في إعدادات Android وتعديل رمز PIN في إعدادات الجهاز داخل اللوحة.

ظهور خطأ 401 عند طلب API: يعود لتمرير توكن خاطئ أو منتهي. العلاج: التحقق من قيمة TOKEN_ID المستخدمة في الرابط وتحديثها من بوابة المطورين.

أسئلة شائعة حول منصة Whats360 وخدمة VCash

ما هي منصة Whats360؟

منصة متكاملة لإدارة واجهات برمجة التطبيقات API للأجهزة، إرسال الرسائل، الأتمتة، إدارة المحادثات والحملات، وخدمات المحافظ الإلكترونية VCash.

ما هو تطبيق VCash Gateway وكيف يُثبت؟

هو تطبيق بصيغة APK يُثبت على هواتف Android لربط الهاتف بالمنصة وقراءة الرسائل وتنفيذ أوامر USSD في الخلفية تلقائياً.

كيف يعمل فلتر المُرِسل في خدمة VCash؟

يسمح بحدد اسم المُرِسل (مثل VodafoneCA) لمعالجة الرسائل التي تحتوي على هذا الاسم فقط وإهمال ما سواه، أو تركه فارغاً لمعالجة كافة الرسائل الواردة.

كيف تحول المنصة رسالة SMS إلى معاملة مالية؟

باستخدام أنماط Regex المحددة في لوحة التحكم، والتي تستخرج المبلغ، الرقم، معرف العملية، والاسم، ثم تقيدها آلياً في تبويب الحسابات.

ما الفرق بين حملات USSD وسيناريوهات USSD؟

حملات USSD تُنفذ أمراً واحداً لقائمة من الأرقام تتابعياً، بينما السيناريوهات تُنفذ خطوات متعددة متتالية تشمل أوامر وانتظار ومتغيرات لنفس العملية.

ما هو Base URL المعتمد لاستدعاءات API؟

الرابط الرئيسي لجميع العمليات البرمجية هو https://whats360.live/api/v1 وتستلزم الموثوقية إرسال معامل token إجباري.

ماذا أفعل في حال فقدان الهاتف المرتبط بالنظام؟

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

ابدأ بتنفيذ نظام الربط والأتمتة لمشروعك اليوم

سواء كنت تبحث عن تجربة باقة VCash المجانية أو تحتاج لتكامل مؤسسي مع أجهزة متعددة وواجهات API، يتوفر فريقنا لدعمك في كافة مراحل الإعداد والتشغيل.

تحدث مع مهندس التكامل عبر واتساب

الوسوم

محمد فارس

0 720 10 دقائق