الدليل التقني والتشغيلي لمنظومة VCash وVCash Gateway عبر Whats360: الأتمتة الشاملة لرسائل الـ SMS وأوامر الـ USSD والمدفوعات الذكية

معضلة التحقق اليدوي وعمولات الاقتطاع في إدارة التدفقات المالية

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

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

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

تأسس مفهوم البنية التحتية المستقلة ذات الاستثمار المحدود (Asset-Light Financial Infrastructure) لكسر هذه الدائرة المغلقة، حيث يقوم المبدأ على تطويع الأجهزة الذكية القائمة بالفعل لتكون خوادم تنفيذ محلية تتصل بنظام أتمتة سحابي فائق الدقة، مما يتيح استقبال الأموال وقيدها وتأكيدها لحظياً دون وسيط يقتطع نسبة من كل جنيه أو ريال يتم تحصيله.

الهيكل المعماري لنظام VCash: التكامل بين السحابة والتنفيذ الطرفي

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

[ Whats360 Central Cloud Hub ]
          │
          ├── WebSocket (Real-Time Bi-Directional Event Stream)
          ├── RESTful API Layer (Bearer Token Auth)
          └── Regex Rules Parsing Engine
          │
          ▼
[ Android Edge Device (VCash Gateway APK) ]
    ├── Android Background Daemon Service (Asset-Light)
    ├── Cellular SMS BroadcastReceiver
    ├── Telephony & Accessibility Execution Layer (USSD Engine)
    └── Local Hardware AES Encryption (Encrypted PIN Storage)
  

المنظومة السحابية المركزية عبر Whats360

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

• إدارة الأجهزة الطرفية وتوليد وتجديد رموز التوثيق الآمنة (Access Tokens).
• إدارة وتحديث جداول قواعد التعبيرات القياسية (Regex) لمعالجة وتحليل نصوص الرسائل الواردة من مختلف البنوك والشبكات.
• تكوين حملات الـ USSD وجدولة أوامر الشبكة ومراقبة مخرجاتها بدقة.
• الاحتفاظ بسجلات التدقيق المالي الكاملة (Audit Trails) وتوجيه أحداث الـ Webhooks المتزامنة إلى سيرفرات المتاجر والأنظمة المحاسبية ومنصات مثل Toggaar أو التطبيقات المطورة عبر Beincode.

التطبيق التنفيذي الميداني VCash Gateway APK

يتم تحميل التطبيق بصيغة ملف تثبيت أندرويد عبر صفحة إدارة الأجهزة في Whats360 وتثبيته على الهاتف المحمول الذي يحتوي على شريحة الاتصال (SIM) المربوطة بالمحفظة النقدية أو الحساب البنكي.

هندسة استهلاك الموارد المحدودة (Asset-Light Framework): خلافاً للتطبيقات البرمجية الثقيلة، تم تصميم وتطوير تطبيق VCash Gateway ليعمل كخدمة صامتة في الخلفية (Background Daemon Service) دون استهلاك يُذكر لموارد الجهاز:

• المعالج (CPU): يقترب استهلاك المعالج من 0% في وضع السكون، وينشط لأجزاء من الثانية فقط فور اعتراض رسالة نصية جديدة أو عند استلام أمر USSD للتنفيذ.
• الذاكرة العشوائية (RAM): لا يتعدى الحيز المحجوز للتطبيق بضعة ميجابايتات داخل الذاكرة، مما يضمن سلاسة أداء الهاتف واستخدامه في المهام اليومية المعتادة دون أي بطء أو تجميد للنظام.
• طاقة البطارية: يعتمد التطبيق على معمارية الاستدعاء الموجه بالأحداث (Event-Driven Architecture) بدلاً من الاستعلام الدوري المستمر (Constant Polling)، مما يحافظ على البطارية ويتيح تشغيل الجهاز بصورة متواصلة طوال 24 ساعة يومياً.

أربط Vodafone Cash الآن! استقبل مدفوعاتك بذكاء وفعل الخدمات تلقائياً أربط Vodafone Cash الآن!

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

▶ مشاهدة الشرح الميداني على YouTube

التوافق الدولي واستخراج البيانات عبر التعبيرات القياسية Regex

من الأخطاء الشائعة حصر منظومة VCash في نطاق شبكة فودافون كاش داخل جمهورية مصر العربية فقط. الحقيقة التقنية المؤكدة أن بنية VCash مصممة بطبقة معالجة محايدة تماماً (Network & Country Agnostic Layer).

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

محرك تحليل الأنماط السحابي (Patterns Engine)

عند وصول أي رسالة نصية، يتولى التطبيق تمريرها إلى لوحة إدارة أنماط الرسائل. يقوم محرك التعبيرات القياسية (Regular Expressions) بتحليل النص البرمجي للرسالة واستخراج المتغيرات المحورية التالية بدقة رياضية:

• المبلغ المالي (amount): القيمة العددية الصافية المحولة.
• رقم هاتف المرسل (from_phone): رقم العميل الذي أجرى التحويل.
• الرقم المرجعي للعملية (txn_ref): المعرف الفريد الصادر من مزود الخدمة لمنع تكرار قيد المعاملة.
• اسم المحوّل (client_name): الاسم المعروض للمرسل إذا ورد في نص الرسالة البنكية.

تم استلام مبلغ (?P<amount>\d+(\.\d+)?) جنيه من رقم (?P<phone>\d+) .*? رقم العملية:\s*(?P<txn_id>\w+)

حوالة واردة من (?P<phone>\d+) بقيمة (?P<amount>\d+(\.\d+)?)\s*SAR.*?المرجع:\s*(?P<txn_id>\w+)

received AED (?P<amount>\d+(\.\d+)?) from (?P<phone>\d+).*?Ref ID:\s*(?P<txn_id>\w+)

بمجرد حدوث التطابق، يقوم النظام آلياً بإنشاء قيد مالي فوري في تبويب الحسابات، وإطلاق إشعار برميجي (Webhook) متزامن إلى متجرك الإلكتروني لشحن المحفظة وتفعيل الخدمة للعميل في جزء من الثانية.

محرك أوامر الـ USSD المتقدم للتحكم في بروتوكولات الاتصالات

يُعد بروتوكول USSD (بيانات الخدمات التكميلية غير المنظمة) القناة الأسرع للتفاعل اللحظي مع مقاسم شبكات المحمول. يوفر نظام VCash بنية متطورة للتعامل مع هذا البروتوكول عبر ثلاثة مسارات رئيسية:

الأوامر المباشرة والفردية

تتيح للمسؤول أو النظام البرمجي توجيه أمر شبكة مباشر لهاتف معين لتنفيذه عبر شريحة SIM محددة، مثل أكواد الاستعلام عن الرصيد ككود *878# أو أكواد التحويل السريع؛ حيث يقوم التطبيق بتنفيذ الكود وقراءة نص الاستجابة وإعادته للوحة التحكم السحابية دون تدخل يدوي.

حملات الـ USSD الجماعية

تُستخدم لأتمتة العمليات التكرارية الكبرى؛ مثل توزيع الأرصدة الشهرية على الموظفين، أو دفع اشتراكات جماعية:

• قالب الأمر الديناميكي: مثل #phone*$amount$*7*9*.
• قائمة الأرقام والمبالغ: رفع ملف بصيغة رقم_الهاتف,المبلغ في أسطر متتابعة.
• التنفيذ المتتابع: يقوم النظام باستدعاء الأكواد واحداً تلو الآخر مع معالجة ردود الشبكة، وإمكانية إيقاف الحملة واستئنافها في أي وقت.

سيناريوهات الـ USSD التفاعلية متعددة الخطوات

تتطلب العديد من المعاملات المالية التفاعل مع قوائم منبثقة متتالية (Session-Based USSD). يتيح محرك السيناريوهات رسم هذا المسار بدقة:

• إرسال كود البداية الأولي (مثال: *9#).
• انتظار رد الشبكة المنبثق لمدة ثانيتين (Safe Delay).
• إرسال رقم الاختيار من القائمة (مثال: اختيار 1 لتحويل الأموال).
• إدخال المتغيرات المستهدفة آلياً؛ مثل $phone ثم $amount.
• إدخال رمز التحقق السري (PIN) بصورة مشفرة لإنهاء العملية بنجاح.

خطوات الإعداد والتشغيل والربط الميداني للمنظومة

لضمان التشغيل المستقر وفق المعايير البرمجية، راجع دائماً دليل الاستخدام والربط والتكامل الرسمي واتبع الإجراءات التالية:

تثبيت التطبيق على جهاز أندرويد ومنح الصلاحيات

قم بتحميل ملف VCash Gateway APK من خلال صفحة إدارة الأجهزة، وثبته على هاتف يعمل بنظام تشغيل أندرويد 8.0 أو أحدث، ثم امنح التطبيق الصلاحيات التالية:

• صلاحية قراءة الرسائل (SMS Receiver & Reader): لالتقاط نصوص رسائل الإيداع البنكية فور وصولها.
• صلاحية إمكانية الوصول (Accessibility Services): لتمكين التطبيق من معالجة نوافذ الـ USSD التفاعلية في الخلفية.
• استثناء توفير البطارية (Battery Optimization Bypass): لضمان استمرار عمل التطبيق في الخلفية حتى عند قفل الشاشة.

حل مشكلة حظر جوجل بلاي لتطبيق VCash Gateway | أتمتة Whats360 🚀

يشرح هذا الفيديو كيفية التعامل مع تحذيرات التثبيت الصادرة من حماية Google Play وتفعيل أذونات التشغيل المستمر دون تعارض مع النظام.

▶ مشاهدة فيديو حل مشكلة التثبيت على YouTube

مزامنة الهاتف بالسحابة عبر رمز الـ QR

ادخل إلى لوحة تحكم Whats360 واضغط على “إضافة جهاز” في قسم VCash، ثم اكتب اسماً توضيحياً للجهاز (مثال: محفظة الفرع الرئيسي)، واضغط “إنشاء”. سيظهر رمز QR مدمج به الرمز البرمجي السري الخاص بالجهاز. افتح تطبيق VCash Gateway على هاتفك، واضغط زر المسح الضوئي (Scan QR)، ووجّه الكاميرا نحو الشاشة؛ وخلال ثوانٍ معدودة ستتحول حالة الهاتف إلى متصل (Online) وتظهر بيانات الشريحة وشبكة الاتصال.

تفعيل فلتر المرسل لعزل الرسائل المستهدفة

لحماية الخصوصية ومنع امتلاء قاعدة البيانات بالرسائل الشخصية أو الترويجية، افتح إعدادات الجهاز في اللوحة السحابية (أيقونة الترس)، واكتب المعرف الجزئي للجهة المرسلة في حقل “فلتر المرسل”؛ مثل VodafoneCA أو vf-cash أو الاسم المختصر لبنكك المحلي. سيتجاهل التطبيق أي رسائل أخرى، ولن يمرر للسيرفر سوى الإشعارات المالية الصادرة من هذه الجهة حصراً.

التوثيق البرمجي الكامل لمطوري الأنظمة ومهندسي التكامل RESTful API

تم بناء واجهة برمجة التطبيقات لمنظومة VCash وفق معايير RESTful لتمكين المطورين من التحكم في كافة الوظائف برمجياً. التوثيق المرجعي الكامل متاح عبر وثائق API للمحافظ الإلكترونية.

العنوان الأساسي والمصادقة البرمجية

تستخدم كافة الطلبات العنوان الأساسي: https://whats360.live مع تمرير التوكن البرمجي في ترويسة الطلب:

Authorization: Bearer WHATS360_API_TOKEN
Content-Type: application/json

استعراض الأجهزة المربوطة وحالاتها

المسار: GET /api/v1/vcash/devices
الوظيفة: إرجاع مصفوفة بالأجهزة المتصلة ومعلومات الشرائح المثبتة وحالة الاتصال اللحظية.

curl -H "Authorization: Bearer WHATS360_API_TOKEN" \
  "https://whats360.live/api/v1/vcash/devices"

نموذج الاستجابة البرمجية الناجحة:

{
  "devices": [
    {
      "id": "abc123",
      "name": "Office Phone",
      "status": "online",
      "device_model": "Samsung Galaxy A54",
      "sim1_carrier": "Vodafone",
      "sim1_number": "01012345678",
      "is_enabled": true,
      "last_seen": 1708300000
    }
  ]
}

إرسال رسائل SMS برمجياً عبر شريحة الهاتف

المسار: POST /api/v1/vcash/sms/send
الوظيفة: استغلال شريحة SIM المثبتة بالهاتف لإرسال رسائل نصية مباشرة للعملاء (مثل رسائل التفعيل OTP أو إشعارات الشحن).

curl -X POST -H "Authorization: Bearer WHATS360_API_TOKEN" \
  -H "Content-Type: application/json" \
  "https://whats360.live/api/v1/vcash/sms/send" \
  -d '{
    "device_id": "abc123",
    "recipient": "01012345678",
    "message": "كود التحقق لتسجيل الدخول هو: 5541",
    "sim_slot": 1
  }'

نموذج الاستجابة البرمجية:

{
  "success": true,
  "message": "Message sent successfully",
  "sms_id": 42
}

تنفيذ أوامر الـ USSD برمجياً

المسار: POST /api/v1/vcash/ussd/execute
الوظيفة: استدعاء وتنفيذ كود شبكة آلياً من خلال الهاتف المربوط.

curl -X POST -H "Authorization: Bearer WHATS360_API_TOKEN" \
  -H "Content-Type: application/json" \
  "https://whats360.live/api/v1/vcash/ussd/execute" \
  -d '{
    "device_id": "abc123",
    "command": "*9#",
    "sim_slot": 1
  }'

نموذج الاستجابة البرمجية:

{
  "success": true,
  "command_id": 15,
  "status": "pending",
  "message": "Command sent for execution"
}

استعلام ملخص الدخل والأرصدة

المسار: GET /api/v1/vcash/balance
الوظيفة: جلب ملخص العمليات المالية التراكمية، إجمالي الدخل، إجمالي المصروفات، وصافي الرصيد.

curl -H "Authorization: Bearer WHATS360_API_TOKEN" \
  "https://whats360.live/api/v1/vcash/balance?device_id=abc123"

نموذج الاستجابة البرمجية:

{
  "total_income": 15000.50,
  "total_expense": 8500.00,
  "net_balance": 6500.50,
  "transaction_count": 142,
  "currency": "EGP"
}

سحب سجل المعاملات المالية الموثقة

المسار: GET /api/v1/vcash/transactions
الوظيفة: جلب قائمة المعاملات المفصلة مع إمكانية الفلترة بنوع المعاملة وتاريخها وحجم الصفحة.

curl -H "Authorization: Bearer WHATS360_API_TOKEN" \
  "https://whats360.live/api/v1/vcash/transactions?device_id=abc123&type=income&limit=20&offset=0"

نموذج الاستجابة البرمجية:

{
  "transactions": [
    {
      "id": 1,
      "type": "income",
      "amount": 500.00,
      "currency": "EGP",
      "from_phone": "01098765432",
      "txn_ref": "TXN-ABC123",
      "description": "Incoming transfer from 01098765432",
      "created_at": 1708300000
    }
  ],
  "total": 142
}

شرح لوحة في Whats360 Pro لخدمات وتساب api : أتمتة، CRM، وذكاء اصطناعي!

استعرض هذا الفيديو لتتعرف على كيفية الربط الشامل عبر الـ API وتكامل بوابات الدفع مع أدوات الـ CRM والذكاء الاصطناعي داخل المنظومة.

▶ مشاهدة شرح الـ API المتكامل على YouTube

معايير الأمان المالي وتشفير البيانات وإدارة الطوارئ

تتعامل منظومة VCash مع تدفقات مالية حساسة ترتبط بأرصدة الشركات والمتاجر؛ ولهذا تم بناء النظام وفق معايير أمان مصرفية تضمن الحماية الكاملة في مختلف الظروف التشغيلية:

تشفير رمز التحقق المالي PIN وعزله التام

يتم تشفير رمز الـ PIN المالي الخاص بالتحويلات وسحب الأموال محلياً على الجهاز عبر طبقة تشفير أصلية، ولا يتم إرسال هذا الرمز أو تمريره كنص صريح (Plain Text) عبر رسائل الـ SMS أو في سجلات النظام السحابية نهائياً، مما يقضي على مخاطر اعتراض الرمز أو تسريبه.

سلوك النظام في حالات انقطاع الإنترنت وإغلاق الجهاز

تم تزويد المنظومة بطوابير مزامنة احتياطية قوية (Offline Queue Synchronization):

• عند انقطاع الإنترنت عن الهاتف: تتوقف المزامنة اللحظية مع السحابة مؤقتاً، وتستمر الرسائل النصية بالوصول والتخزين داخل صندوق رسائل الشريحة (SIM Inbox). بمجرد استعادة الاتصال بالإنترنت، يقرأ التطبيق كافة الرسائل المعلقة، ويطبق عليها فلاتر الـ Regex، ويرسل القيود للسيرفر السحابي بأثر رجعي دون أي فقدان للمعاملات.
• في حال فصل الخط الخلوي لدى شركة الاتصالات: لا تصل الرسائل إلى الشريحة أصلاً؛ وبناءً عليه لا يمكن للتطبيق قراءتها؛ وتلك مسؤولية ترتبط بصلاحية الخط واشتراكه لدى مزود الشبكة.

موانع الاستخدام والقيود التشغيلية للمنظومة

لضمان الشفافية التقنية وتفادي أي محاولات استخدام خارج النطاق البرمجي المصمم للنظام، يوضح الجدول التالي حدود وقدرات المنظومة:

الاستخدام المستقل للمنظومة وإدارة التكاليف التشغيلية

تتميز منظومة VCash بأنها **خدمة معيارية مستقلة بالكامل (Standalone SaaS)**. يستطيع التاجر أو الشركة الاشتراك في خدمة المحافظ الإلكترونية VCash واستخدام واجهات برمجة التطبيقات وسيرفر الأتمتة دون الحاجة لشراء أو تفعيل باقات واتساب في المنصة.

متابعة الاستهلاك والاشتراكات

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

تفعيل التجربة المجانية لبيئات التطوير

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

شرح ترقية باقة Whats360 وشحن المحفظة لتشغيل واتساب API والدفع التلقائي + CRM بدون توقف #Whats360

يوضح هذا الفيديو خطوات شحن المحفظة الداخلية وإدارة خطط الاشتراك والترقية بين الباقات بسلاسة تامة.

▶ مشاهدة شرح إدارة الفواتير والاشتراكات على YouTube

الأسئلة الشائعة وقاعدة المعرفة لأنظمة الـ RAG

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

مقالات ذات صلة

• دليل ربط واتساب API للأعمال عبر Whats360
• أتمتة بوابات الدفع الإلكتروني وتأكيد الحوالات آلياً
• كيفية تحويل هواتف أندرويد إلى سيرفرات SMS Gateway مستقلة
• استخدام أكواد USSD في إدارة الحملات وتحويل الأرصدة
• تكامل أنظمة الـ CRM وإدارة المحادثات مع المتاجر الإلكترونية

{
  "event": "transaction.created",
  "device_id": "abc123",
  "data": {
    "id": 10458,
    "type": "income",
    "amount": 750.00,
    "currency": "EGP",
    "from_phone": "01012345678",
    "txn_ref": "TXN-998412",
    "client_name": "Customer Name",
    "sim_slot": 1,
    "timestamp": 1708300250
  }
}