بوابات الدفع الالكتروني

أتمتة فودافون كاش عبر Whats360 VCash: تحويل إشعارات SMS إلى معاملات API وأوامر USSD بدون مراجعة يدوية

أتمتة فودافون كاش عبر Whats360 VCash

💳 الدليل التشغيلي والتقني الشامل لخدمة VCash في واتس360 (Whats360): إعداد Gateway وهندسة Regex وأتمتة USSD والتكامل عبر API

تواجه معظم المتاجر الإلكترونية وشركات التحصيل ومنصات الخدمات الرقمية في مصر والعالم العربي مأزقًا تشغيليًا متكررًا عند الاعتماد على المحافظ الإلكترونية مثل فودافون كاش (Vodafone Cash) في تحصيل المدفوعات أو صرف المستحقات. فمع غياب واجهة برمجية (API) عامة ومفتوحة للأفراد وصغار التجار تتيح التحقق التلقائي من التحويلات الواردة دون المرور عبر بوابات دفع تقتطع عمولات نسبية أو تشترط إجراءات سجل تجاري معقدة، يضطر أصحاب المشاريع إلى توظيف فريق يراجع رسائل الهاتف النصية (SMS) يدويًا ويطابقها مع لقطات الشاشة (Screenshots) التي يرسلها العملاء؛ وهي عملية بطيئة ومكلفة وعرضة للأخطاء البشرية أو التلاعب بالصور المعدلة.

وعندما يحاول المطورون كسر هذا القيد ببناء حلول يدوية عبر تطبيقات أتمتة الهاتف العامة مثل Tasker أو MacroDroid وربطها بمنصات مثل n8n، يصطدمون سريعًا بجدار من العقبات الميدانية القاسية: تعطل تقسيم النصوص عند تغير سطر واحد في رسالة البنك، وإغلاق أنظمة أندرويد الحديثة لتطبيقات الأتمتة في الخلفية لترشيد البطارية، وقيود متجر Google Play الصارمة على صلاحيات قراءة الرسائل، وصعوبة إدارة أوامر USSD التفاعلية أو منع تكرار قيد المعاملة الواحدة في قاعدة البيانات.

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

🚀 حل مؤسسي لأتمتة المحافظ الإلكترونية

حوّل إشعارات فودافون كاش إلى معاملات مالية مؤتمتة بالكامل مع واتس360 (Whats360)

ودّع المراجعة اليدوية للتحويلات ولقطات الشاشة المزيفة. اربط هاتفك بالمنصة عبر مسح رمز QR في ثوانٍ، واستخرج المبالغ ومعرفات العمليات بدقة Regex، وادمج السجل المالي مباشرة في متجرك أو نظامك عبر REST API موثق.

  • التقاط آلي لرسائل التحويل وتصنيف الدخل والمصروف في تبويب الحسابات.
  • أتمتة أوامر وحملات وسيناريوهات USSD متعددة الخطوات مع تشفير كامل لرمز PIN.
  • تجربة مجانية متاحة دون بطاقة ائتمان، مع دعم الدفع المحلي عبر Paymob.

📋 ملخص تنفيذي سريع

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

  • فهم البنية المعمارية: كيف يعمل VCash كمنظومة متكاملة مستقلة تضم تطبيق أندرويد وسيط، ومحرك تحليل نصوص حتمي، ولوحة حسابات، وواجهة API موثقة، وكيف يتفوق معماريًا على حلول الأتمتة المجزأة.
  • تأمين بيئة الهاتف (Android Gateway): خطوات تثبيت ملف APK، وفهم سبب توزيعه خارج متجر Google Play، وضبط الصلاحيات الثلاث الحساسة، ومنع إغلاق النظام للتطبيق في الخلفية، والربط عبر رمز الاستجابة السريعة (QR Code) خلال أربع ثوانٍ.
  • فلترة الرسائل وهندسة Regex: كيفية عزل الرسائل المالية عن الرسائل الشخصية عبر Sender Filter، وبناء أنماط تعبيرات نمطية (Message Patterns) تستخرج المبلغ ورقم الهاتف ومعرف العملية واسم الراسل بدقة دون الاعتماد الهش على تقسيم الأسطر أو التقدير العشوائي لنماذج اللغة.
  • تشغيل أوامر وحملات وسيناريوهات USSD: آلية تنفيذ الأكواد الفردية، وإطلاق حملات الدفع أو الاستعلام من قوائم نصية، وتجنب فخ اتجاه النص (RTL/LTR Bidi) في قالب التحويل، وبناء سيناريوهات متعددة الخطوات مع التشفير الكامل لرمز PIN.
  • التكامل البرمجي ومنع التكرار: التوظيف الكامل لمسارات VCash API الخمسة، وإدارة شرائح الاتصال، وتطبيق مبدأ عدم التكرار (Idempotency) عبر معرف المعاملة txn_ref، ومعالجة أكواد أخطاء HTTP، واحترام الحدود القانونية للمحافظ الإلكترونية في مصر.

⚡ الإجابة المباشرة: كيف يعمل نظام VCash في واتس360 (Whats360)؟

يعمل نظام VCash في منصة واتس360 (Whats360) عبر مسار مؤتمت من أربع مراحل متصلة تحوّل إشعار التحويل النصي على شريحة هاتفك إلى سجل مالي رقمي قابل للمعالجة والربط الفوري:

  1. الالتقاط المحلي عبر الهاتف: يلتقط تطبيق VCash Gateway المثبت على هاتف أندرويد إشعارات رسائل SMS الواردة أو ينفذ أوامر USSD المطلوبة مباشرة عبر شريحة الهاتف، ويعمل في الخلفية باستمرار مع جدولة العمليات عند انقطاع الإنترنت.
  2. الفلترة والتحليل الحتمي (Filtering & Regex Parsing): يطبق النظام فلتر المُرسِل (Sender Filter) لاستبعاد الرسائل غير المالية، ثم يمرر الرسالة المطابقة على محرك Message Patterns لاستخراج أربعة حقول محددة عبر Regex: المبلغ، رقم الهاتف، معرف العملية، واسم الراسل.
  3. التسجيل المالي والتفاعل: تُسجَّل المعاملة تلقائيًا في تبويب الحسابات مصنفة كدخل أو مصروف مع ربطها بالجهاز والتاريخ، كما تتيح اللوحة تنفيذ أوامر USSD فردية أو جماعية أو متعددة الخطوات.
  4. التكامل البرمجي عبر API: توفر بوابة المطورين واجهات REST API مؤمنة برمز مصادقة (Bearer Token) تتيح لمتجرك الإلكتروني أو نظام ERP/CRM قراءة سجل المعاملات والأرصدة، ومراقبة حالة الأجهزة، وإرسال SMS أو تنفيذ USSD برمجيًا.

🏗️ ما هي منظومة VCash في واتس360 (Whats360)؟ وكيف تختلف عن الحلول اليدوية وأدوات الأتمتة العامة؟

قبل الخوض في الخطوات التنفيذية، يحتاج المطور ومدير التشغيل إلى استيعاب الصورة المعمارية الكاملة للنظام. كثيرون يظنون خطأً أن VCash مجرد إضافة ثانوية داخل أداة تسويق عبر واتساب، بينما الواقع الهندسي يضعه كوحدة أتمتة مالية قائمة بذاتها داخل منظومة واتس360 (Whats360) متعددة الخدمات.

المكونات الأساسية الأربعة للمنظومة

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

📱 تطبيق الهاتف الوسيط (VCash Gateway)

تطبيق أندرويد (APK) يُثبَّت على الهاتف الذي يحمل شريحة المحفظة الإلكترونية، ويتولى قراءة رسائل التحويل الواردة، ومراقبة حالة الشبكة، وإرسال الرسائل النصية، وتنفيذ أوامر USSD المحلية وإرجاع ردود الشبكة إلى السحابة.

🖥️ لوحة الإدارة السحابية

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

🧩 محرك التحليل الذكي (Regex Parsing Engine)

الطبقة البرمجية المسؤولة عن تحويل النص البشري غير المهيكل في رسالة شركة الاتصالات إلى كائن بيانات منظم (Structured Data) يغذي السجل المالي.

🔌 بوابة المطورين (VCash REST API)

واجهة برمجية قياسية تعتمد بروتوكول HTTPS وصيغة JSON لإدارة الأجهزة، واسترجاع الأرصدة وسجلات المعاملات، وتمرير أوامر USSD ورسائل SMS من الأنظمة الخارجية.

استقلالية خدمة VCash عن باقات واتساب

من النقاط الجوهرية التي يجب توضيحها للمؤسسات والمطورين أن منصة واتس360 (Whats360) تعمل بمنهجية خدمات معيارية مستقلة؛ فإلى جانب إدارة واتساب الأعمال، توفر المنصة خدمات منفصلة مثل البريد الإلكتروني، وبوابة الرسائل النصية، والمحافظ الرقمية (VCash). وبناءً على هذا الفصل المعماري، يمكنك اعتماد وحدة VCash وإدارتها وربطها بمتجرك أو نظام المحاسبة الخاص بك مباشرة عبر واجهتها وتوثيقها المستقل دون أن تكون مجبرًا على تشغيل حملات تسويقية على واتساب أو ربط رقم واتساب إذا لم يكن ذلك ضمن متطلبات مشروعك، كما تتيح المنصة تجربة مجانية تبدأ دون اشتراط بطاقة ائتمان، وتدعم طرق الدفع المحلية الشائعة في مصر عبر Paymob (البطاقات البنكية، فودافون كاش، فوري، وإنستاباي).

🎯 ميزة تشغيلية حاسمة: ابدأ بالمحافظ الإلكترونية فقط وتوسع عند الحاجة

لست بحاجة إلى استبدال نظام المراسلات الحالي أو دفع اشتراكات لخدمات لا تستخدمها. ركز على أتمتة تحصيل فودافون كاش وأوامر USSD الآن عبر واتس360 (Whats360)، واستفد من التجربة المجانية لاختبار الربط في بيئتك التشغيلية.

استفسر عن الباقات المناسبة لنشاطك

مقارنة معمارية: المراجعة اليدوية مقابل الحلول المجمّعة مقابل واتس360 (Whats360) VCash

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

معيار المقارنة المراجعة اليدوية (لقطات الشاشة) حلول الهواة المجمّعة (Tasker / MacroDroid + n8n) منظومة VCash في واتس360 (Whats360)
آلية التقاط الرسائل قراءة بشرية لهاتف المحفظة ومطابقة يدوية مع رقم الطلب. إعداد قواعد محلية يدوية لالتقاط نص الرسالة وإرساله إلى Webhook خارجي. تطبيق VCash Gateway مخصص يربط الجهاز بالسحابة عبر مسح QR في ثوانٍ.
استخراج البيانات المالية نسخ يدوي للمبلغ ورقم المرسل واحتمال كبير للأخطاء الإملائية. يعتمد غالبًا على تقسيم النص بالأسطر (Split) أو تعبيرات يكتبها المستخدم ويصعب اختبارها مركزيًا. محرك Message Patterns مركزي يعتمد على Regex مع اختبار حي على رسائل حقيقية قبل الحفظ.
أتمتة أوامر USSD كتابة الأكواد يدويًا على لوحة الاتصال لكل عملية تحويل أو استعلام. معقد للغاية ويتطلب محاكاة نقر شاشة هشة تتعطل مع أي تغيير في نافذة النظام. دعم أصلي لأوامر USSD الفردية، والحملات الجماعية بقوائم، والسيناريوهات متعددة الخطوات، وتشفير PIN.
فلترة الرسائل وحماية الخصوصية يرى الموظف جميع رسائل الهاتف الخاصة وأكواد البنوك (OTP). يعتمد على شروط يبرمجها المستخدم داخل الهاتف؛ وأي خطأ يسرب رسائل خاصة إلى السيرفر. Sender Filter مدمج في إعدادات كل جهاز يقتصر على تمرير رسائل المرسل المحدد فقط.
مقاومة انقطاع الإنترنت تتوقف العملية تمامًا إذا لم يكن المشرف متصلاً بمراجعة الهاتف. إذا فشل إرسال Webhook وقت انقطاع الشبكة، تسقط المعاملة ما لم تبرمج طابور إعادة محاولة محلي. مراقبة مستمرة لحالة الجهاز وجدولة العمليات تلقائيًا عند فقدان الاتصال لحين عودته (Offline Resilience).
سجل الحسابات والتصفية جداول إكسل يدوية معرضة للنسيان أو التعديل غير الموثق. تحتاج إلى بناء قاعدة بيانات ولوحة تحكم مستقلة (مثل Google Sheets أو Postgres) من الصفر. تبويب الحسابات يسجل الدخل والمصروف تلقائيًا مع التصفية حسب الجهاز والنوع والتاريخ.
تعدد الأجهزة والشرائح فوضى تشغيلية عند وجود أكثر من شريحة أو أكثر من فرع. صعوبة بالغة في مزامنة الإعدادات وتحديث قواعد Regex عبر عدة هواتف. إدارة مركزية لأجهزة وشرائح متعددة (sim_slot) من لوحة واحدة مع عزل التوكنات.
تكلفة الصيانة الهندسية مرتفعة تشغيليًا في رواتب المتابعة ووقت انتظار العميل. مرتفعة برمجيًا عند كل تحديث لنظام أندرويد أو تغير في صيغة رسائل الشبكة. بنية جاهزة موثقة بواجهات REST API، بينما يركز مطورك على منطق عملك الأساسي فقط.

📱 تثبيت تطبيق VCash Gateway وإعداد هاتف أندرويد للعمل المستمر في الخلفية

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

خطوات تثبيت التطبيق ومنح الصلاحيات الثلاث المطلوبة

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

  1. تثبيت الحزمة (APK): ثبّت تطبيق VCash Gateway على هاتف أندرويد بعد السماح بتثبيت التطبيقات من هذا المصدر (المتصفح أو مدير الملفات).
  2. منح الصلاحيات الثلاث الجوهرية: عند فتح التطبيق للمرة الأولى، سيطلب منك منح ثلاث صلاحيات أساسية لا يعمل التكامل التلقائي دونها:
    • صلاحية الرسائل (SMS Permissions): لقراءة إشعارات المعاملات المالية الواردة وإرسال رسائل SMS عند استدعائها من اللوحة أو الـ API.
    • صلاحية إمكانية الوصول (Accessibility Service): ضرورية لقراءة نوافذ حوارات USSD التفاعلية والتعامل مع قوائم الشبكة وإدخال الاستجابات في السيناريوهات متعددة الخطوات وإتمام العمليات تلقائيًا.
    • صلاحية الإشعارات (Notifications Access): تضمن بقاء خدمة النظام حية في المقدمة (Foreground/Background Persistence) ومتابعة التنبيهات الفورية دون تأخير.
  3. تسجيل الدخول بحساب المنصة: أدخل اسم المستخدم وكلمة المرور الخاصين بحسابك على منصة واتس360 (Whats360).
  4. التشغيل المستمر في الخلفية: بمجرد إتمام الإعداد، يُصمَّم التطبيق ليعمل في الخلفية تلقائيًا حتى بعد إغلاق نافذته من قائمة التطبيقات المفتوحة.

لماذا يُوزَّع التطبيق كملف APK خارج Google Play؟ وكيف تتجاوز الإعدادات المقيدة بأمان؟

يتساءل كثير من المستخدمين وأصحاب الشركات بقلق مشروع: لماذا لا أحمل تطبيق VCash Gateway من متجر Google Play مباشرة؟ وهل يعني تحميل ملف APK وجود خلل أمني؟

الإجابة التقنية الموثقة في سياسات مطوري Google Play واضحة تمامًا: تفرض جوجل منذ سنوات قيودًا صارمة للغاية على صلاحيتي READ_SMS وSEND_SMS وخدمة AccessibilityService، ولا تسمح بنشر التطبيقات التي تطلب هذه الصلاحيات على المتجر العام إلا لفئات محدودة جدًا من التطبيقات (مثل أن يكون التطبيق هو تطبيق الرسائل الافتراضي الكامل على الهاتف)، وترفض جوجل طلبات الاستثناء للتطبيقات المؤسسية الخاصة بأتمتة المدفوعات أو ربط بوابات SMS الشخصية بالأنظمة السحابية. لهذا السبب تعتمد جميع أدوات بوابات الرسائل الجادة في هذا المجال على التوزيع المباشر بملف APK موقع ومخصص.

وعند التثبيت على إصدارات أندرويد الحديثة (Android 13 فما فوق)، قد تصادف رسالة نظام تفيد بأن “الإعداد مقيد” (Restricted Setting) عند محاولة تفعيل صلاحية Accessibility أو Notification Access لتطبيق مثبت من خارج المتجر. لتجاوز هذه الحماية المدمجة في أندرويد بصورة صحيحة دون تعطيل أمان الجهاز:

  • افتح الإعدادات (Settings) ثم التطبيقات (Apps).
  • ابحث عن تطبيق VCash Gateway وافتح صفحة معلومات التطبيق (App Info).
  • اضغط على أيقونة النقاط الثلاث في الزاوية العلوية للشاشة واختر السماح بالإعدادات المقيدة (Allow restricted settings)، ثم أكد عبر بصمة الإصبع أو رمز قفل الهاتف.
  • بعد هذه الخطوة، عُد إلى إعدادات إمكانية الوصول والإشعارات وستتمكن من تفعيل الصلاحيتين للتطبيق بسلاسة.

ربط الجهاز بالمنصة عبر رمز QR خلال أربع ثوانٍ وشروط الشبكة

بعد تثبيت التطبيق ومنح الصلاحيات وتسجيل الدخول، تأتي مرحلة ربط الجهاز بحسابك داخل لوحة واتس360 (Whats360) عبر الخطوات التالية:

  1. من لوحة التحكم الرئيسية في المنصة، انتقل إلى قسم أجهزة VCash، ثم انقر على زر إضافة جهاز.
  2. أدخل اسمًا وصفيًا واضحًا للجهاز يعبر عن هويته التشغيلية في عملك (مثل: Office Phone أو Vodafone-Cash-Main-01)، ثم اضغط على إنشاء.
  3. سيظهر لك على شاشة الحاسوب رمز استجابة سريعة (QR Code). افتح تطبيق VCash Gateway على الهاتف ووجه الكاميرا لمسح الرمز.
  4. بمجرد المسح، تتبادل المنصة والتطبيق رمز التوثيق وتتحول حالة الجهاز في اللوحة إلى “متصل” (online) خلال أربع ثوانٍ تقريبًا.

شرط الشبكة الحرج: ينبّه دليل الاستخدام الرسمي على ضرورة التأكد من أن الهاتف والمنصة متصلان على نفس الشبكة في حال الاستضافة المحلية، أو أن الخادم السحابي للمنصة متاح عبر الإنترنت بصورة مستقرة للهاتف. وفي حالة استخدام المنصة السحابية الرسمية على عنوانها العام، تأكد فقط من أن الهاتف متصل بشبكة Wi-Fi موثوقة أو بيانات هاتف نشطة ولا يقع خلف جدار ناري (Firewall) يحجب اتصالات HTTPS الصادرة.

▶️ YouTube
شرح طريقة عمل خدمة VCash

تعرّف بصريًا على واجهة النظام وخطوات ربط تطبيق الهاتف ولوحة المحافظ الإلكترونية من خلال الشرح المرئي الرسمي للخدمة.

اضغط هنا للمشاهدة

بروتوكول منع إغلاق التطبيق في خلفية أندرويد واستمرارية العمل عند انقطاع الإنترنت

تشتهر بعض واجهات أندرويد المعدلة من الشركات المصنعة — خصوصًا هواتف Xiaomi (MIUI/HyperOS) وHuawei (EMUI) وSamsung (OneUI) وOppo/Realme — بعدوانيتها الشديدة في قتل العمليات الخلفية لتوفير البطارية، مما يؤدي إلى توقف صامت لالتقاط رسائل التحويل بعد ساعات من ترك الهاتف دون لمسه. لتفادي هذا العطل التشغيلي المزعج، طبّق قائمة التحقق الهندسية التالية على جهاز العمل:

  • تخصيص هاتف للعمل فقط: تجنب تثبيت التطبيق على هاتفك الشخصي اليومي؛ استخدم هاتف أندرويد مخصصًا وموصولًا بمصدر طاقة مستقر ومؤمنًا برمز قفل، مع إيقاف التحديثات التلقائية التي تعيد تشغيل الجهاز فجأة دون تدخل.
  • إلغاء تحسين البطارية (Disable Battery Optimization): انتقل إلى إعدادات البطارية الخاصة بتطبيق VCash Gateway واختر غير مقيد (Unrestricted) أو لا تحسّن (Don’t optimize)، وعطّل أي وضع لتوفير الطاقة التكيفي (Adaptive Battery) أو وضع النوم العميق للتطبيقات (Deep Sleeping Apps) في هواتف سامسونج.
  • قفل التطبيق في الذاكرة (Lock in Recent Apps): افتح قائمة التطبيقات الأخيرة، واضغط مطولًا أو اسحب بطاقة التطبيق لإظهار أيقونة القفل (Lock)، حتى لا يحذفه النظام عند تنظيف الذاكرة العشوائية.
  • السماح بالتشغيل التلقائي (Autostart): في هواتف Xiaomi وOppo وHuawei، فعّل خيار التشغيل التلقائي (Autostart) للتطبيق وأوقف خيار إيقاف التطبيق إذا لم يُستخدم، لضمان عودته للعمل فور إعادة تشغيل الهاتف.
  • إبقاء الشبكة نشطة في وضع السكون: تأكد من ضبط إعدادات Wi-Fi على البقاء متصلًا دائمًا أثناء السكون (Keep Wi-Fi on during sleep: Always).

أما فيما يتعلق بانقطاع الإنترنت المفاجئ عن الهاتف أثناء وصول تحويل جديد، فتعتمد منظومة VCash في واتس360 (Whats360) على آلية المرونة عند انقطاع الاتصال (Offline Resilience)؛ حيث يراقب النظام حالة اتصال الجهاز دوريًا عبر الحقل الزمني لآخر ظهور (last_seen)، وعند فقدان الاتصال يتم جدولة العمليات وتخزينها مؤقتًا لتُرسل وتُنفَّذ بمجرد عودة الجهاز للاتصال بالشبكة، غير أن إبقاء اتصال الهاتف مستقرًا يظل شرطًا أساسيًا لضمان التأكيد الفوري (Real-Time) لطلبات العملاء دون تأخير.

⚠️ تنبيه تشغيلي قبل التفعيل الفعلي: هل تواجه صعوبة في صلاحيات أندرويد أو تهيئة الجهاز؟

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

اطلب مساعدة فنية لتجهيز الجهاز

🛡️ إدارة رسائل SMS الواردة وضبط فلتر المُرسِل (Sender Filter)

بعد ربط الجهاز بنجاح، تبدأ رسائل SMS بالتدفق من الهاتف إلى السحابة. ولكن ترك الباب مفتوحًا أمام جميع الرسائل الواردة دون ترشيح يُعد خطأً أمنيًا وتشغيليًا جسيمًا؛ فالهاتف قد يستقبل رسائل شخصية، أو إعلانات ترويجية، أو أكواد تحقق بنكية سرية (OTP) لا ينبغي أبدًا إرسالها إلى لوحة تحكم يطّلع عليها موظفو التشغيل أو المطورون. كما أن غياب التحقق من هوية مُرسِل الرسالة يفتح بابًا لثغرة أمنية خطيرة تتمثل في قيام محتال بإرسال رسالة SMS عادية من هاتفه الشخصي تحاكي نص رسالة فودافون كاش لخداع النظام!

كيف يحمي فلتر المُرسِل (Sender Filter) خصوصيتك ويمنع التزييف؟

يوفر نظام واتس360 (Whats360) VCash ميزة فلتر المُرسِل (Sender Filter) لضبط معايير القبول عند المصدر قبل بدء أي تحليل أو تسجيل مالي. ولتفعيلها وفق الدليل الرسمي:

  1. توجه إلى قائمة الأجهزة في لوحة التحكم، واضغط على أيقونة الإعدادات (التِرس) بجانب الجهاز المطلوب.
  2. حدد خيار فلتر المرسل (Sender Filter).
  3. أدخل اسم المرسل أو جزءًا مميزًا منه تمامًا كما يظهر في إشعارات محفظتك على الهاتف، مثل: vf-cash أو VodafoneCA.
  4. احفظ الإعدادات؛ وبذلك سيلتزم تطبيق VCash Gateway بإرسال الرسائل التي يحتوي اسم مُرسِلها على هذا النص الجزئي فقط.
🚨 تحذير مهم بشأن ترك الحقل فارغًا:

يوضح الدليل الرسمي أن ترك حقل فلتر المرسل فارغًا يجعل التطبيق يرسل جميع رسائل SMS الواردة بدون تصفية. لا يُنصح بترك هذا الحقل فارغًا إلا في بيئات الاختبار المؤقتة على هاتف معزول تمامًا، أو عند استخدام الجهاز كبوابة SMS عامة؛ أما في بيئات تحصيل المدفوعات، فإن تقييد الفلتر باسم مزود المحفظة الحقيقي (Sender ID الأبجدي الذي لا يمكن لأي رقم هاتف عادي انتحاله عبر رسائل الأفراد القياسية) يقطع الطريق أمام محاولات التلاعب بإرسال رسائل تحويل وهمية من هواتف شخصية.

استعراض تبويب رسائل SMS والإرسال اليدوي

بعد ضبط الفلتر، يمكنك مراقبة الرسائل الواردة بوضوح عبر تبويب رسائل SMS داخل قائمة VCash. يعرض هذا التبويب سجلًا منظمًا لكل رسالة واردة التقطها الفلتر، موضحًا:

  • اسم أو معرف المُرسِل (مثل VodafoneCA).
  • قيمة المبلغ المستخرجة (في حال تطابقها).
  • التاريخ والوقت الدقيق للاستلام.

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

🧩 هندسة محرك تحليل الرسائل (Message Patterns) باستخدام التعبيرات النمطية Regex

يُعد محرك تحليل الرسائل (Regex Parsing Engine) الموجود في تبويب إضافة الأنماط والأنماط العامة العقل الحقيقي لنظام VCash داخل منصة واتس360 (Whats360). فبدونه، تظل رسائل التحويل مجرد نصوص صماء يتعذر جمعها أو فرزها أو مطابقتها مع فواتير المتجر.

لماذا يتفوق Regex الحتمي على تقسيم الأسطر (Variable Split) والذكاء الاصطناعي في البيانات المالية؟

عندما يبني المبتدئون أتمتة لاستخراج المبلغ من رسالة تحويل في تطبيقات مثل Tasker، يلجأ كثيرون إلى طريقة تقسيم النص بالمسافات أو فواصل الأسطر (Variable Split) والاعتماد على رقم المتغير مثل %SMSRB2 أو %SMSRB3. هذه الطريقة تنهار عمليًا بمجرد أن ترسل شركة الاتصالات إعلانًا من سطر إضافي في ذيل الرسالة، أو يختلف طول اسم المُحوِّل من كلمة واحدة إلى ثلاث كلمات، فتظهر في قاعدة البيانات متغيرات فارغة أو نصوص خاطئة مكان المبلغ!

وفي المقابل، جرب عدد من المطورين مؤخرًا تمرير رسائل المعاملات إلى نماذج الذكاء الاصطناعي (LLMs) لاستخراج البيانات دون كتابة أنماط ثابتة، لكن التجارب العملية في مجتمعات الأتمتة (مثل نقاشات r/n8n وr/selfhosted) كشفت ثلاث مشكلات حقيقية في الاعتماد على الذكاء الاصطناعي وحده:

  1. عدم الحتمية (Non-Determinism): قد يعيد النموذج اللغوي الرقم أحيانًا بصيغة نصية أو يخطئ في قراءة الفواصل العشرية إذا تشابهت أرقام الرصيد المتاح مع مبلغ التحويل نفسه.
  2. التكلفة والتأخير (Latency & Token Cost): استدعاء API خارجي لنموذج ذكاء اصطناعي مع كل رسالة SMS يضيف زمن تأخير وتكلفة مستمرة لا داعي لها.
  3. خطر الاعتماد الأعمى: عند معالجة الأموال، لا مجال للاحتمالات التقريبية؛ أنت تحتاج قاعدة برمجية حتمية إما أن تطابق الصيغة بنسبة دقيقة أو ترفض الرسالة وتنبهك لعدم مطابقتها.

لذلك، يمثل اعتماد واتس360 (Whats360) VCash على محرك التعبيرات النمطية (Regular Expressions – Regex) الخيار الهندسي الأدق والأسرع، لأنه يلتقط القيم استنادًا إلى السياق البنيوي الثابت حول الرقم والمعرف في أجزاء من المللي ثانية، دون أي تكلفة معالجة إضافية ودون هلوسة لغوية.

الحقول الأربعة المستخرجة في نظام VCash وربطها بتبويب الحسابات

وفق التوثيق الرسمي لصفحة أنماط الرسائل، يعمل كل نمط Regex داخل VCash على استخراج أربعة حقول محورية من نص رسالة SMS الخام:

  1. المبلغ (Amount): القيمة المالية المحولة (بما في ذلك الكسور العشرية إن وُجدت)، مع الانتباه الحرج لعدم الخلط بين “المبلغ المستلم” و”الرصيد الحالي في المحفظة” الذي غالبًا ما تذكره الرسالة في الجملة التالية.
  2. رقم الهاتف (Phone Number): رقم هاتف المرسل أو المستلم المرتبط بالمعاملة، ويفضل أن يطابق صيغة الأرقام المصرية القياسية (010، 011، 012، 015) أو الصيغة الدولية (201...) بحسب نص الرسالة.
  3. معرف العملية (Transaction ID / Reference): الرقم المرجعي الفريد الذي تصدره شركة الاتصالات أو المحفظة لكل معاملة مالية، وهو حجر الزاوية في منع تكرار تسجيل المعاملة لاحقًا.
  4. الاسم (Name): اسم الطرف الآخر أو الوصف النصي المرتبط بالمعاملة إذا ذكرته رسالة الإشعار.

بمجرد أن يطابق النظام النمط المحفوظ على رسالة SMS واردة متجاوزة لفلتر المرسل، يُطبَّق النمط تلقائيًا لإنشاء معاملة مالية (Transaction) جديدة تُدرج مباشرة في تبويب الحسابات وتصبح جاهزة للاستعلام عبر الـ API.

منهجية كتابة واختبار أنماط Regex على رسائل حقيقية قبل الحفظ

لتوضيح آلية التفكير الهندسي عند بناء نمط Regex (أو تعديل الأنماط الجاهزة الموجودة في المنصة)، لنفترض وجود رسالة نصية تمثيلية افتراضية تحاكي بنية رسائل الاستلام باللغة العربية أو الإنجليزية:

نموذج نص تمثيلي للتحليل:
تم استلام مبلغ 500.00 جنيه من رقم 01098765432 رصيدك الحالي 15000.50 جنيه رقم العملية 9876543210

لاحظ الخطر هنا: النص يحتوي على رقمين ماليين (500.00 و15000.50) ورقمين طويلين (01098765432 و9876543210). إذا كتبت تعبيرًا ساذجًا يلتقط أي رقم عشري، فقد يلتقط الرصيد الكلي بدلًا من مبلغ التحويل! الحل الهندسي هو الارتكاز على الكلمات الدلالية السابقة واللاحقة (Context Anchors) باستخدام مجموعات الالتقاط المسماة أو المرتبطة بحقول اللوحة، مثل:

  • لالتقاط المبلغ تحديدًا بعد عبارة الاستلام وليس الرصيد، نربط التعبير نصيًا بعبارة الاستلام لالتقاط الرقم الذي يليها مباشرة وتجاهل رقم الرصيد الحالي:
    تم استلام مبلغ\s+([0-9]+(?:\.[0-9]{1,2})?)
  • لالتقاط رقم الهاتف المصري وتفادي التقاط معرف العملية:
    من رقم\s+(01[0125][0-9]{8})
  • لالتقاط معرف العملية بحيث يستوعب الأرقام أو المعرفات المختلطة بحروف:
    رقم العملية\s+([A-Za-z0-9-]+)

قاعدة الاختبار الإلزامية قبل التفعيل: من أكبر المشكلات الواقعية التي رُصدت لدى مستخدمي أنظمة التحليل النصي أن شركات الاتصالات قد تغير حرفًا واحدًا أو كلمة في صيغة رسالة الإشعار دون إشعار مسبق (مثل استبدال “من رقم” بـ “من محفظة”، أو إضافة فاصلة آلاف 1,500.00 للمبالغ الكبيرة)، مما يؤدي إلى فشل النمط وتوقف تسجيل المعاملات بصمت! لذلك:

  • استخدم دائمًا ميزة الاختبار المباشر المدمجة في تبويب أنماط الرسائل داخل واتس360 (Whats360) VCash لاختبار النمط على عينات رسائل حقيقية متنوعة (مبالغ صحيحة، ومبالغ بكسور عشرية، ومبالغ تتجاوز الألف بفاصلة أو بدونها) قبل الضغط على حفظ.
  • أنشئ نمطًا منفصلًا لرسائل الدخل (Income) وآخر لرسائل المصروف (Expense) حتى لا تخلط اللوحة بين التحويلات الواردة والتحويلات الصادرة من محفظتك.
  • راجع تبويب رسائل SMS دوريًا لمقارنة الرسائل الواردة بالسجلات المسجلة في الحسابات للتأكد من عدم سقوط أي نمط نتيجة تحديث مفاجئ في صيغة شركة الاتصالات.
💡 نصيحة خبير (Information Gain): اختبر أنماطك قبل استقبال عملاء حقيقيين

نمط Regex غير مختبر قد يفوّت معاملات الأرقام العشرية أو الآلاف المفصولة بفاصلة. ادخل الآن إلى صفحة الأنماط في لوحة واتس360 (Whats360) وطابق صيغة محفظتك على عينات حقيقية.

⚙️ أتمتة أوامر USSD: من الأوامر الفردية إلى الحملات الجماعية والسيناريوهات متعددة الخطوات

بينما يعالج تحليل SMS ما يصل إلى محفظتك، تعالج منظومة USSD في واتس360 (Whats360) VCash ما تطلبه أو تنفذه عبر شبكة المحمول نفسها — مثل الاستعلام عن الرصيد، أو سداد فواتير، أو إجراء تحويلات صادرة، أو تشغيل أكواد خدمات الشبكة — دون الحاجة لتطبيق بنكي أو اتصال إنترنت لإتمام العملية على الشبكة ذاتها.

تنفيذ أوامر USSD الفردية وإدارة شريحة SIM ورمز PIN

لتنفيذ أمر فوري لمرة واحدة، انتقل إلى تبويب أوامر USSD في لوحة التحكم واتبع الخطوات الأربع الموثقة:

  1. اكتب كود USSD المطلوب بدقة في حقل الأمر (مثل *878# للاستعلام أو أي كود خدمة مدعوم من شبكتك).
  2. اختر الجهاز المتصل من القائمة، ثم حدد رقم شريحة الاتصال (SIM) المقصودة إذا كان الهاتف يدعم شريحتين (Dual SIM) لتجنب تنفيذ أمر المحفظة على شريحة غير مخصصة لها.
  3. اضغط على زر تنفيذ؛ سيُرسَل الأمر لحظيًا إلى تطبيق VCash Gateway ليُنَفَّذ على الهاتف ويُعاد عرض رد الشبكة مباشرة في واجهة اللوحة تلقائيًا.
  4. التعامل التلقائي مع نافذة PIN: إذا تطلب الأمر ظهور نافذة حوار تأكيد لإدخال الرقم السري للمحفظة، يقوم النظام بإدخال رمز PIN تلقائيًا شريطة أن تكون قد حددته مسبقًا في إعدادات الجهاز داخل اللوحة.

حملات USSD بالجملة عبر قوائم (رقم,مبلغ)

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

  1. أنشئ حملة جديدة من تبويب حملات USSD.
  2. أدخل قالب الأمر (Command Template) باستخدام المتغيرين الديناميكيين لرقم الهاتف والمبلغ.
  3. الصق قائمة المستلمين بصيغة نصية بسيطة: رقم,مبلغ بحيث يحتوي كل سطر على سجل واحد فقط، على النحو التالي:
    010XXXXXXXX,250
    010YYYYYYYY,500
    010ZZZZZZZZ,1200
  4. اضغط على تشغيل؛ سيبدأ النظام في معالجة القائمة وتنفيذ الأوامر تباعًا واحدًا تلو الآخر بصورة تلقائية، مع إتاحة خيارات الإيقاف المؤقت (Pause) والاستئناف (Resume) في أي وقت لمراجعة النتائج أو تجنب اختناق استجابة الشبكة.

تحذير هندسي حرج: تجنب فخ اتجاه النص (RTL/LTR Bidi) في قالب كود تحويل فودافون كاش

عند التعامل مع أكواد USSD في الواجهات العربية التي تعرض النصوص من اليمين إلى اليسار (RTL)، يقع كثير من المستخدمين في فخ بصري خطير ناجم عن خوارزمية العرض ثنائي الاتجاه (Bidirectional Text Rendering) لرمزي النجمة * والمربع # مع الحروف اللاتينية مثل $phone$ و$amount$. فقد يبدو لك الكود بصريًا على الشاشة وكأنه مقلوب، فيظن المستخدم أن الترتيب يبدأ بالمبلغ قبل الرقم أو ينتهي بالنجمة!

في شبكة فودافون مصر الرسمية، الصيغة التشغيلية الصحيحة لأمر التحويل عبر USSD تبدأ من اليسار إلى اليمين بـ *9*7* متبوعًا برقم المستلم ثم المبلغ ثم علامة المربع #:

*9*7*$phone$*$amount$#
🔒 قواعد السلامة الصارمة قبل تشغيل أي حملة USSD مالية:

  • اقرأ القالب داخل محرر نصي يدعم الاتجاه اللاتيني من اليسار إلى اليمين (LTR) وتأكد أن البداية هي *9*7* وأن المتغير الأول بعده هو $phone$ والثاني هو $amount$، لأن عكس المتغيرين قد يتسبب في فشل التحويل أو إرسال مبلغ غير مقصود لرقم خاطئ!
  • تأكد من دقة تسمية المتغيرات كما تطلبها شاشة القالب في إصدار لوحتك الحالي (مثل $phone$ و$amount$ في الحملات، أو $phone و$amount في السيناريوهات).
  • قبل تشغيل حملة لخمسين رقمًا دفعة واحدة، نفّذ تجربة أولية بصف واحد فقط لمبلغ رمزي صغير جدًا بين محفظتين تابعتين لك للتحقق العملي من نجاح الدورة الكاملة وتأكيد خصم المبلغ الصحيح للرقم الصحيح.

بناء سيناريوهات USSD متعددة الخطوات (Scenarios)

بعض خدمات الشبكة والبنوك والمحافظ لا تقبل تنفيذ المعاملة في كود واحد مختصر (One-Shot USSD)، بل تفتح قائمة تفاعلية متدرجة تطلب منك إرسال رقم الاختيار 1، ثم انتظار رد الشبكة، ثم إرسال رقم الهاتف، ثم المبلغ، ثم رمز التأكيد.

للتغلب على هذا التعقيد، خصصت منصة واتس360 (Whats360) VCash تبويب السيناريوهات (Scenarios) الذي يسمح ببناء سلسلة إجراءات متعاقبة:

  • يمكن أن تكون كل خطوة داخل السيناريو إما تنفيذ أمر/إدخال USSD أو فترة انتظار زمني (مثل انتظار ثانيتين) لمنح شبكة المحمول مهلة كافية لعرض القائمة التفاعلية التالية قبل إرسال الرد الآلي.
  • يدعم السيناريو تعريف متغيرات ديناميكية مثل $phone و$amount وتمريرها عبر الخطوات المتتابعة.
  • نصيحة هندسية: إذا لاحظت أن شبكة الاتصالات تعاني من بطء استجابة في ساعات الذروة، أضف هامش انتظار مناسبًا بين الخطوات حتى لا يرسل التطبيق استجابة الخطوة الثالثة قبل أن تصل نافذة الخطوة الثانية على الهاتف، وتجنب إدخال رمز PIN خاطئ بشكل متكرر حتى لا يتسبب في إيقاف المحفظة مؤقتًا من جهة شركة الاتصالات.
⚡ أتمتة متقدمة لصرف العمولات والمستحقات

أطلق حملات USSD من قوائم الأرقام أو ابنِ سيناريوهات تفاعلية خلال دقائق

سواء كنت تصرف مستحقات مسوقين، أو تسدد دفعات دورية، أو تستعلم عن أرصدة فروع متعددة، توفر لك لوحة واتس360 (Whats360) أدوات الحملات الجماعية والسيناريوهات مع تشفير كامل لرمز PIN.

تواصل لتفعيل حملات USSD لنشاطك

متابعة تبويب الحسابات والمعاملات المالية

يمثل تبويب الحسابات المحطة النهائية التي تصب فيها نتائج الرسائل المحللة بـ Regex. يتميز هذا القسم بالتسجيل الآلي للمعاملة فور وصول رسالة SMS ومطابقتها لنمط الرصيد، مع أدوات تصفية عملية تتيح لك فرز الدفاتر وفق ثلاثة محاور:

  1. الجهاز: لمراجعة تدفقات كل خط أو فرع على حدة في حال تشغيل أكثر من هاتف.
  2. النوع: الفصل المباشر بين عمليات الدخل (Income) وعمليات المصروف (Expense).
  3. التاريخ: استخراج إجمالي حركة يوم معين أو فترة زمنية محددة لمراجعتها محاسبيًا في نهاية الوردية.

🔌 دليل المطورين: التكامل الكامل عبر VCash REST API

إذا كنت تبني متجرًا إلكترونيًا مخصصًا، أو نظام تخطيط موارد مؤسسات (ERP)، أو أداة إدارة عملاء (CRM)، أو تدير أتمتة معقدة عبر منصة وسيطة، فإن استخدام واجهة الويب يدويًا لن يكفي. توفر بوابة المطورين داخل واتس360 (Whats360) VCash — والموثقة في صفحة وثائق API للمحافظ الإلكترونية — واجهة برمجية قياسية (RESTful API) تضع جميع قدرات اللوحة في متناول كودك البرمجي.

الأساسيات الهندسية للربط: Base URL والمصادقة

تستخدم جميع طلبات واجهة المطورين العنوان الأساسي التالي:

https://whats360.live

وتتطلب جميع الطلبات تمرير مفتاح التوثيق (API Token) الخاص بحسابك داخل ترويسة الطلب (HTTP Header) بصيغة Bearer Token على النحو التالي:

Authorization: Bearer WHATS360_API_TOKEN
Content-Type: application/json
🔐 قاعدة أمان إلزامية للمطورين:
احتفظ برمز WHATS360_API_TOKEN داخل متغيرات البيئة الآمنة على السيرفر (.env) ولا تضعه أبدًا داخل كود الواجهة الأمامية (Frontend JavaScript) أو تطبيقات الهاتف أو مستودعات Git العامة. وإذا شككت في انكشاف الرمز في أي وقت، استخدم زر تجديد التوكن في أعلى بوابة المطورين فورًا لإبطال الرمز القديم.

استعراض ومراقبة الأجهزة المتصلة (GET /api/v1/vcash/devices)

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

مثال الطلب:

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

نموذج الاستجابة المتوقعة (JSON):

{
  "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
    }
  ]
}

استخدام الحقول في منطق تطبيقك: تحقق برمجيًا من أن is_enabled يساوي true وأن status يساوي "online"، وراقب الطابع الزمني last_seen (صيغة Unix Timestamp) للتنبيه الفوري لمدير النظام إذا انقطع اتصال الهاتف لفترة غير معتادة.

إرسال رسائل SMS برمجياً (POST /api/v1/vcash/sms/send)

تتيح لك هذه النقطة إرسال رسالة نصية قصيرة عبر هاتف VCash المتصل، مع القدرة على تحديد فتحة الشريحة (sim_slot) المطلوب الإرسال منها (مثلاً 1 أو 2).

مثال الطلب:

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": "Hello! This is a test message",
    "sim_slot": 1
  }'

نموذج الاستجابة المتوقعة (JSON):

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

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

تنفيذ أوامر USSD برمجياً (POST /api/v1/vcash/ussd/execute)

تُستخدم هذه النقطة لتمرير كود USSD مباشر من خادمك الخلفي إلى الهاتف المتصل؛ سواء للاستعلام عن الرصيد (مثل *9#) أو تنفيذ أمر تحويل أو استعلام شبكة على شريحة محددة.

مثال الطلب:

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
  }'

نموذج الاستجابة المتوقعة (JSON):

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

لاحظ أن تنفيذ USSD يتم بصورة غير متزامنة (Asynchronous)؛ حيث تعيد الواجهة البرمجية حالة "pending" مع رقم تعريفي للأمر (command_id) بمجرد تمرير الطلب نحو الجهاز، لأن استجابة شبكة الاتصالات تستغرق بضع ثوانٍ على الهاتف الفعلي.

استخراج ملخص الرصيد المالي (GET /api/v1/vcash/balance)

يوفر هذا المسار ملخصًا إحصائيًا جاهزًا للتدفقات المالية المسجلة على جهاز محدد (إجمالي الدخل، إجمالي المصروفات، صافي الرصيد، وعدد المعاملات بالعملة المسجلة)، وهو مناسب لبناء لوحات قياس إدارية (Dashboards) أو تدقيق الإجماليات اليومية.

مثال الطلب:

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

نموذج الاستجابة المتوقعة (JSON):

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

استرجاع سجل المعاملات والتصفية (GET /api/v1/vcash/transactions)

هذا هو المسار الأكثر استخدامًا في ربط المتاجر الإلكترونية وأنظمة المطابقة المالية؛ إذ يعيد قائمة المعاملات المسجلة مع دعم التصفية حسب معرف الجهاز (device_id)، ونوع المعاملة (type=income أو expense)، والتحكم في عدد النتائج (limit وoffset) لتطبيق تقسيم الصفحات (Pagination) بكفاءة دون إثقال الذاكرة.

مثال الطلب:

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

نموذج الاستجابة المتوقعة (JSON):

{
  "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
}
👨‍💻 بوابة المطورين والتكاملات المخصصة

هل تخطط لدمج سجل المعاملات والأرصدة مباشرة داخل منصة التجارة الإلكترونية أو نظام ERP الخاص بشركتك؟ ابدأ بفحص التوثيق الرسمي لـ واتس360 (Whats360)، أو تواصل لترتيب خطة التنفيذ البرمجي.

هندسة منع التكرار (Idempotency) ومطابقة الطلبات مع متجرك أو نظام ERP

من أخطر المشكلات الهندسية في أنظمة الأتمتة المالية — والتي يشتكي منها المطورون مرارًا في مجتمعات r/automation وr/n8n — مشكلة ازدواجية القيد (Duplicate Processing)؛ أي أن يقرأ نظامك سجل المعاملات عبر استدعاء دوري (Polling) أو يستقبل تنبيهًا متكررًا، فيقوم بتأكيد طلبين للعميل أو شحن رصيد محفظته داخل المتجر مرتين مقابل تحويل مالي واحد!

لتحصين نظامك ضد هذه الثغرة، اعتمد قواعد التصميم التالية في قاعدة بيانات متجرك:

  1. مفتاح التفرد الصارم (UNIQUE CONSTRAINT): أنشئ عمودًا في جدول المدفوعات بقاعدة بياناتك لحفظ txn_ref (أو ادمج device_id + txn_ref إذا تكررت الصيغ المرجعية عبر مزودين مختلفين)، واضبطه كقيد فريد (UNIQUE) على مستوى قاعدة البيانات نفسها؛ بحيث يرفض المحرك إدراج المعاملة ذاتها مهما تعددت طلبات القراءة المتزامنة.
  2. المطابقة الثلاثية (Three-Way Matching): عند تقديم العميل لطلب الدفع في متجرك وإدخاله الرقم الذي حوّل منه، لا تعتمد على مطابقة المبلغ فقط! فقد يدفع عميلان نفس القيمة الشائعة (مثل 300 جنيه) في الدقيقة نفسها. طابق برمجيًا بين ثلاثة عناصر معًا:
    • قيمة المبلغ (amount يساوي أو يتطابق مع إجمالي الطلب ضمن هامش متفق عليه).
    • رقم هاتف المحوِّل (from_phone يطابق الرقم الذي سجله العميل في صفحة إتمام الدفع).
    • نافذة زمنية منطقية (created_at بعد وقت إنشاء الطلب)، مع التحقق من عدم استهلاك txn_ref في طلب سابق.
  3. الاحتفاظ بسجل مراجعة (Audit Log): احفظ دائمًا سجلًا لبيانات الاستجابة الخام الواردة من الـ API وربطها برقم الطلب الداخلي، بحيث يسهل على فريق المحاسبة مراجعة أي اختلاف في المبالغ (مثل دفع العميل مبلغًا أقل من قيمة الفاتورة).

ملاحظة للمطورين والشركات: إذا كنت تبحث عن حزمة متخصصة جاهزة لربط مدفوعات المتاجر وتأكيد التحويلات عبر المحافظ الرقمية يمكنك استكشاف منصة EGCash، أما إذا كان لديك نظام ERP مخصص أو منصة برمجية خاصة ولا يتوافر لديك فريق تطوير داخلي لبناء طبقة الربط ومعالجة عدم التكرار مع VCash API، فيمكنك الاستعانة بشركة برمجيات متخصصة في التكاملات والأنظمة المخصصة مثل Beincode لبناء هذا الجسر البرمجي وفق مواصفات عملك.

جدول أكواد الأخطاء في VCash API وصيغة الاستجابة الموحدة

تتبع واجهة VCash API بنية استجابة موحدة تسهل على مطورك كتابة معالج أخطاء (Error Handler) مركزي:

في حالة النجاح:

{
  "success": true,
  "message": "...",
  "data": { }
}

في حالة الخطأ:

{
  "success": false,
  "error": "error description"
}

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

كود الخطأ المعنى الموثق في البوابة السبب التقني المحتمل الإجراء الهندسي الصحيح في كودك
400 طلب غير صحيح (بيانات ناقصة أو غير صالحة) نقص حقل مطلوب مثل device_id أو خطأ في صيغة JSON أو رقم هاتف غير صالح. أوقف إعادة المحاولة فورًا، وصحح تحقق المدخلات (Validation) وسجّل تفاصيل الخطأ للمطور.
401 توكن غير صحيح أو منتهي الصلاحية خطأ في كتابة ترويسة Authorization: Bearer ... أو تم تجديد الـ API Token من اللوحة. حدّث WHATS360_API_TOKEN في إعدادات الخادم وأطلق تنبيهًا إداريًا عاجلًا.
403 غير مصرح — تم تجاوز حدود الباقة استنفاد حصة العمليات أو الأجهزة المسموح بها في خطة اشتراكك الحالية. أوقف الإرسال الجماعي، أرسل تنبيهًا لصاحب الحساب لمراجعة خطة الاشتراك، ولا تكرر الطلب عشوائيًا.
404 الجهاز أو المورد غير موجود تمرير device_id محذوف أو خاطئ لا يتبع الحساب الحالي. استدعِ GET /api/v1/vcash/devices لمزامنة معرفات الأجهزة النشطة وتصحيح المعرف.
500 حدث خطأ غير متوقع عطل لحظي في الخادم أو استجابة غير متوقعة في معالجة الطلب. نفّذ آلية إعادة المحاولة المتدرجة (Exponential Backoff) بعد ثوانٍ محدودة مع حدود قصوى للمحاولات.

🔐 الأمان والخصوصية وحوكمة التشغيل وحدود المحافظ في مصر

لأن الأتمتة المالية تتعامل مع أموال حقيقية وبيانات عملاء حساسة، فإن غياب الضوابط الأمنية والقانونية قد يحوّل ميزة توفير الوقت إلى خسارة تشغيلية. تجمع النقاط التالية القواعد الأساسية التي يجب فرضها في بيئة الإنتاج:

سرية Device Token وتشفير PIN والتعطيل الفوري للجهاز المفقود

يوضح القسم العاشر في دليل الاستخدام الرسمي لـ واتس360 (Whats360) VCash ثلاث ركائز أمنية صريحة لا ينبغي التهاون معها:

  1. خصوصية رمز التوثيق (Device Token): يمتلك كل جهاز رمز توثيق فريدًا يربطه بحسابك على المنصة؛ يجب ألا يُشارك هذا الرمز مع أي طرف غير مخوّل، تمامًا مثل كلمة المرور.
  2. تشفير رمز PIN الخاص بـ USSD: يُحفَظ رمز الـ PIN المستخدم في أتمتة أوامر USSD بصورة مشفرة، ولا يُرسَل مطلقًا عبر رسائل SMS، مما يقلص سطح الاختراق المحتمل أثناء الاتصال.
  3. التعطيل الفوري عند فقدان الهاتف: إذا فُقد الهاتف المربوط بالمحفظة أو سُرق في أي لحظة، لا تنتظر ولا تحذف الجهاز فورًا فتفقد تتبعه، بل استخدم ميزة التعطيل الفوري من لوحة التحكم دون حذفه؛ فهذا يقطع صلاحية الجهاز في تنفيذ أي عمليات أو قراءة بيانات مع الحفاظ الكامل على سجل حساباتك السابق، بالتوازي مع تواصلك مع شركة الاتصالات لإيقاف الشريحة نفسها.

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

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

عند تصميم نظام تحصيل آلي لمتجرك في مصر، لا تعمل أبدًا بمعزل عن الضوابط التنظيمية الصادرة عن البنك المركزي المصري وشركات الاتصالات. وفق القواعد المعلنة لمحافظ فودافون كاش للأفراد في السوق المصري:

  • الحد اليومي والشهري القياسي للمحفظة: يبلغ الحد الأقصى للتعاملات اليومية 60,000 جنيه مصري، والحد الأقصى للتعاملات الشهرية 200,000 جنيه مصري (تُحتسب الحدود وفق قواعد السحب والتحويل والشراء المعلنة من شركة الاتصالات والبنك المركزي، وهي عرضة للتحديث الدوري).
  • قيود الخطوط الجديدة: تخضع المحافظ المنشأة حديثًا في أول ثلاثة أشهر لحدود مبدئية مخفضة تبلغ 10,000 جنيه يوميًا و60,000 جنيه شهريًا قبل الرفع التدريجي وفق الضوابط المطبقة.

كيف يؤثر هذا الواقع على هندسة VCash؟ إذا تجاوزت مبيعات متجرك اليومية أو الشهرية سقف المحفظة الواحدة، فستبدأ التحويلات الواردة من العملاء في الرفض من شبكة فودافون نفسها رغم عمل هاتفك ونظامك بكفاءة! وهنا تظهر قيمة ميزة تعدد الأجهزة والشرائح في واتس360 (Whats360) VCash؛ إذ يمكنك تشغيل أكثر من خط رسمي مسجل وموثق (ضمن الأطر القانونية وضوابط شركات الاتصالات والبنك المركزي، مثل محافظ الشركات أو توزيع الفروع)، ومراقبة حجم الدخل المحصل على كل جهاز يوميًا عبر نقطة GET /api/v1/vcash/balance?device_id=...؛ وبمجرد اقتراب الجهاز الأول من سقفه التشغيلي اليومي، يوجّه متجرك العملاء الجدد تلقائيًا في صفحة الدفع إلى رقم المحفظة الاحتياطية المسجلة على الجهاز الثاني دون توقف المبيعات.

⚖️ هل تتجاوز مبيعاتك حد المحفظة الواحدة أو تحتاج إلى خطة تعدد الأجهزة؟

لا تترك توقف التحصيل عند سقف 60 ألف جنيه يوميًا يعطل حملاتك الإعلانية. راجع متطلبات باقة تعدد الأجهزة في واتس360 (Whats360) لضبط التوزيع الآلي بين أكثر من خط.

اطلب تسعير باقات تعدد الأجهزة

تنبيه محاسبي وتنظيمي: SMS طبقة أتمتة تشغيلية لا بديل للتسوية الرسمية

رغم الدقة العالية لمحرك Regex مع Sender Filter في تسريع تأكيد الطلبات داخل متجرك، يجب أن يدرك أصحاب الأعمال أن رسالة SMS الواردة للهاتف تظل أداة تأكيد تشغيلي سريعة (Operational Trigger) وليست مستندًا بنكيًا نهائيًا أو بديلًا عن التسوية المحاسبية والضريبية الرسمية. ولذلك، احرص على مراجعة كشوف المحافظ الفعلية ومطابقتها مع تقارير تبويب الحسابات في نهاية كل أسبوع أو شهر مالي، ولا تعتمد على أرصدة الشريحة دون ضوابط فوترة سليمة.

🛠️ الأخطاء الشائعة في التشغيل وحلولها السريعة (Troubleshooting)

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

توقف التقاط الرسائل بعد ساعات من ترك الهاتف

السبب الجذري: تدخل نظام توفير الطاقة في أندرويد لوضع تطبيق VCash Gateway في حالة سكون أو قتله في الخلفية، أو انقطاع شبكة Wi-Fi عند إطفاء الشاشة.

الحل السريع: ضبط استهلاك البطارية للتطبيق على “غير مقيد” (Unrestricted)، وتفعيل Autostart، وقفل التطبيق في قائمة المهام الأخيرة، وإبقاء Wi-Fi متصلًا دائمًا في وضع السكون، ثم التحقق من عودة حالة الجهاز إلى "online" في اللوحة.

استلام إشعارات SMS دون تسجيل معاملات في الحسابات

السبب الجذري: عدم مطابقة نص الرسالة الواردة لأي نمط Regex مفعّل في تبويب أنماط الرسائل (غالبًا بسبب تغيّر صيغة الرسالة من مزود الخدمة أو وجود فاصلة آلاف غير متوقعة في المبلغ).

الحل السريع: انسخ النص الدقيق للرسالة التي سقطت من تبويب رسائل SMS، وافتح تبويب أنماط الرسائل، وجرّب النمط عليها في أداة الاختبار لتحديد الحرف أو الجزء الذي فشل في المطابقة وتعديله ثم حفظه.

ظهور رسائل شخصية أو إعلانية في تبويب رسائل SMS

السبب الجذري: ترك حقل فلتر المرسل (Sender Filter) فارغًا في إعدادات الجهاز، أو إدخال كلمة عامة جدًا موجودة في أسماء مرسلين آخرين.

الحل السريع: افتح أيقونة التِرس بجانب الجهاز، وأدخل المعرف الجزئي الدقيق لمحفظتك مثل VodafoneCA أو vf-cash واحفظ التعديل.

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

السبب الجذري: عدم منح صلاحية Accessibility كاملة، أو تقييدها عبر Restricted Settings، أو إرسال الخطوة التالية في السيناريو قبل أن تستجيب شبكة المحمول للخطوة السابقة.

الحل السريع: راجع تفعيل صلاحية إمكانية الوصول لتطبيق VCash Gateway، وزد خطوة الانتظار الزمني (Wait) داخل السيناريو بمقدار ثانيتين إضافيتين بين خطوات القوائم التفاعلية.

تكرار إنشاء الطلب أو شحن الرصيد مرتين لنفس التحويل

السبب الجذري: غياب قيد تفرد على حقل txn_ref في قاعدة بيانات المتجر عند استدعاء نقطة GET /api/v1/vcash/transactions دوريًا.

الحل السريع: أضف فهرسًا فريدًا (UNIQUE) لمعرف المعاملة txn_ref في جدول معاملات متجرك، واجعل كود المعالجة يتحقق أولًا من عدم وجود هذا المعرف قبل اعتماد أي طلب.

فشل استدعاء API بأكواد 401 أو 403 أو 404

السبب الجذري: توكن غير محدث (401)، أو تجاوز حدود الخطة (403)، أو معرف جهاز محذوف/خاطئ (404).

الحل السريع: طابق WHATS360_API_TOKEN مع المعروض في بوابة المطورين، أو افحص معرفات الأجهزة النشطة عبر GET /api/v1/vcash/devices، أو راجع استهلاك خطتك.

🎁 ابدأ الاختبار العملي اليوم مجاناً

اختبر منظومة VCash على متجرك أو نظامك دون أي مخاطرة أو بطاقة بنكية

تقدم منصة واتس360 (Whats360) تجربة مجانية بدون اشتراط بطاقة ائتمان، وإمكانية ترقية مرنة تدعم البطاقات وفودافون كاش وفوري وإنستاباي عبر Paymob، مع توثيق كامل للمطورين.

❓ الأسئلة الشائعة حول تشغيل وأتمتة VCash في واتس360 (Whats360)

هل يجب أن يكون الهاتف المرتبط وجهاز الكمبيوتر متصلين بنفس شبكة Wi-Fi دائمًا؟

لا يلزم ذلك عند استخدام النسخة السحابية على الإنترنت؛ إذ يشير دليل الاستخدام إلى ضرورة أن يكون الهاتف والمنصة على نفس الشبكة أو أن يكون الخادم متاحًا عبر الإنترنت. لذلك بمجرد ربط الهاتف عبر QR، يمكنك تشغيله من أي مكان عبر بيانات الهاتف أو أي شبكة Wi-Fi مستقرة، بينما تتابع أنت اللوحة من حاسوبك في مكتب أو مدينة أخرى.

هل يستطيع تطبيق VCash Gateway إرسال رمز الـ PIN السري الخاص بمحفظتي عبر رسائل SMS؟

لا؛ وفق ضوابط الأمان والخصوصية الموثقة في دليل الاستخدام الرسمي، فإن رمز PIN المستخدم لأتمتة أوامر USSD يُخزَّن بصورة مشفرة داخل المنصة ولا يُرسل مطلقًا عبر رسائل SMS. ومع ذلك، يظل الحفاظ على سرية حسابك في المنصة وتفعيل الحماية على هاتف العمل مسؤولية تشغيلية أساسية.

ماذا يحدث لسجل الحسابات المالية إذا قمت بتعطيل هاتف مفقود أو مسروق من لوحة التحكم؟

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

هل أستطيع الاعتماد على نقطة إرسال SMS في VCash API لإطلاق حملات رسائل نصية تسويقية للعملاء؟

من الناحية التقنية، تتيح نقطة POST /api/v1/vcash/sms/send إرسال رسالة نصية عبر شريحة الهاتف المحددة (sim_slot). لكن من الناحية التشغيلية والقانونية، شرائح المحافظ والأفراد مخصصة للتنبيهات التشغيلية المحدودة أو الرسائل التفاعلية الفردية (مثل تأكيد استلام دفعة)؛ أما إطلاق آلاف الرسائل التسويقية العشوائية عبر شريحة عادية فقد يؤدي إلى حظر الخط من شركة الاتصالات، وللرسائل التسويقية الجماعية تُستخدم بوابات SMS المخصصة لذلك.

ما الذي أفعله إذا تأخرت شبكة المحمول في الرد أثناء تشغيل حملة USSD جماعية لقائمة أرقام طويلة؟

يوفر تبويب حملات USSD أزرار إيقاف مؤقت واستئناف يمكنك استخدامها في أي لحظة لإيقاف تدفق الحملة مؤقتًا ريثما تستقر استجابة الشبكة ثم إكمال بقية القائمة لاحقًا. وإذا كانت طبيعة العملية تتضمن قوائم متفرعة تتطلب مهلة زمنية بين كل أمر والرد عليه، فالأفضل نقل منطق التنفيذ إلى تبويب السيناريوهات (Scenarios) وإدراج خطوات انتظار واضحة.

هل أحتاج إلى التعاقد مع مطور برمجيات لبدء استخدام VCash في مشروعي؟

لا يشترط ذلك للعمليات التشغيلية المباشرة؛ إذ يمكنك تثبيت تطبيق VCash Gateway، وضبط فلتر المرسل، وتجربة أنماط الرسائل، وتشغيل أوامر وحملات USSD، ومراجعة تبويب الحسابات بالكامل من واجهة المنصة الجاهزة دون كتابة سطر برمجي واحد. وتبدأ الحاجة إلى مطور فقط في المرحلة المتقدمة عندما ترغب في ربط البيانات تلقائيًا مع متجرك الإلكتروني أو نظام ERP/CRM الخاص بك عبر واجهة VCash API.

ما الفرق بين استخدام VCash في واتس360 (Whats360) وبين بناء منظومة خاصة من الصفر باستخدام MacroDroid وn8n؟

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

🏁 الخاتمة ومسار البدء العملي في أول ثلاثين دقيقة

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

⏱️ خطة الإطلاق العملية في أول ثلاثين دقيقة:

  1. افتح لوحة خدمة المحافظ الإلكترونية VCash وسجّل الدخول (أو أنشئ حساب تجربة مجانية).
  2. خصص هاتف أندرويد احتياطيًا بشريحة المحفظة، وثبّت تطبيق VCash Gateway عبر صفحة إدارة الأجهزة، وطبق قائمة التحقق الخاصة باستثناءات البطارية والذاكرة وإعدادات الصلاحيات المقيدة، ثم اربطه بمسح رمز QR.
  3. ادخل إلى إعدادات الجهاز واضبط فلتر المرسل على معرف محفظتك الجزئي (مثل VodafoneCA) لحماية خصوصية الهاتف.
  4. أرسل لنفسك تحويلًا تجريبيًا بمبلغ رمزي صغير، والتقط نص الرسالة من تبويب رسائل SMS، ثم اختبر وتأكد من مطابقة النمط في صفحة أنماط الرسائل حتى تُسجَّل أول معاملة دخل تلقائيًا في تبويب الحسابات.
  5. بمجرد استقرار هذه الدورة الأساسية، يمكنك التوسع بمراجعة دليل الاستخدام والربط أو تسليم رابط وثائق API للمطورين لفريقك البرمجي للربط المباشر مع متجرك أو نظام عملك.

ابدأ التنفيذ الآن وتواصل معنا عبر واتساب

🏷️ الكلمات المفتاحية

شرح VCash واتس360 (Whats360)
تطبيق VCash Gateway
أتمتة المحافظ الإلكترونية
ربط فودافون كاش API
تحليل رسائل SMS باستخدام Regex
حملات وسيناريوهات USSD
فلتر المرسل Sender Filter
VCash REST API
منع تكرار المعاملات Idempotency
حدود فودافون كاش مصر

🧭 خريطة الكيانات الدلالية وإجابات البحث المتقدمة لأتمتة فودافون كاش عبر واتس360 (Whats360) VCash

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

خريطة الكيانات التقنية والتجارية وعلاقاتها داخل المنظومة

الكيان (Entity) التصنيف الدلالي الدور الوظيفي أو التحدي المرتبط به
واتس360 (Whats360) / VCash منصة ومنتج SaaS الوحدة السحابية لإدارة أجهزة المحافظ الإلكترونية، تحليل SMS، أتمتة USSD، وسجل الحسابات.
VCash Gateway تطبيق Android APK البوابة المحلية على الهاتف لالتقاط إشعارات الدفع وتنفيذ USSD وإرسال SMS مع العمل في الخلفية.
VCash REST API & Bearer Token تقنية تكامل ومصادقة واجهة JSON مؤمنة برمز توثيق لربط الأجهزة والأرصدة والمعاملات مع المتاجر وأنظمة ERP/CRM.
Sender Filter ميزة حماية وترشيح قيد يمنع تمرير الرسائل الشخصية وأكواد OTP ويحجب محاولات التزييف من أرقام أفراد عادية.
Regex Parsing Engine تقنية تحليل نصوص استخراج حتمي للمبلغ ورقم الهاتف ومعرف العملية واسم الراسل بدقة تتفوق على تقسيم الأسطر.
Idempotency & txn_ref مفهوم هندسي ومالي منع تكرار تأكيد الطلب أو شحن الرصيد مرتين لنفس التحويل عبر قيد تفرد على معرف المعاملة.
Android Accessibility & Restricted Settings صلاحيات وسياسات نظام ضبط الصلاحيات المقيدة وإلغاء تحسين البطارية لمنع إغلاق تطبيقات الخلفية وقرءاة نوافذ USSD.
Offline Resilience بنية استمرارية التشغيل مراقبة حالة الجهاز عبر last_seen وجدولة العمليات عند انقطاع الشبكة لحين عودتها.
RTL/LTR Bidi Rendering Trap مشكلة واجهات عربية انقلاب بصري لرموز USSD مثل *9*7*$phone$*$amount$# يتطلب المراجعة في اتجاه LTR.
حدود فودافون كاش ومراقبة الرصيد ضوابط تنظيمية في مصر إدارة سقوف 60 ألف يومياً / 200 ألف شهرياً (و10 آلاف/60 ألف للخطوط الجديدة) بتعدد الأجهزة.
Tasker / MacroDroid / n8n بدائل أتمتة عامة أدوات مرنة لكنها تتطلب صيانة يدوية لنصوص التحليل، USSD، وقواعد البيانات دون لوحة جاهزة.
EGCash / Beincode / Paymob منظومة حلول ودفع مكملة حلول مكملة لتأكيد مدفوعات المتاجر، وبناء تكاملات مخصصة، وبوابة سداد الاشتراكات المحلية.

إجابات مركزة لاستعلامات البحث المتقدمة حول SMS وRegex وUSSD وAPI

السؤال: لماذا يفشل تقسيم نص رسالة البنك بالأسطر وتظهر متغيرات فارغة أو خاطئة عند استخراج المبالغ، وكيف يحل Regex ذلك؟

الإجابة: يفشل تقسيم النص بالمسافات أو فواصل الأسطر (مثل متغيرات %SMSRB2 في تطبيقات مثل Tasker) لأن شركات الاتصالات والبنوك لا تلتزم بعدد ثابت من الأسطر أو الكلمات، وقد تضيف سطرًا ترويجيًا أو يتغير طول اسم المرسل. أما Regex فيعتمد على الكلمات الدلالية الثابتة المحيطة بالقيمة المالية (مثل عبارة الاستلام قبل الرقم) ليلتقط المبلغ ورقم الهاتف ومعرف العملية بدقة مهما تغيرت فواصل الأسطر.

السؤال: هل الأفضل الاعتماد على Regex أم الذكاء الاصطناعي في تحليل رسائل المعاملات المالية الواردة؟

الإجابة: يتفوق Regex الحتمي على نماذج الذكاء الاصطناعي (LLMs) في تحليل إشعارات الدفع ذات الصيغ المتكررة؛ لأن نتائجه ثابتة ولا تقبل التقدير الاحتمالي أو الخلط بين مبلغ التحويل والرصيد المتاح، كما أنه ينفّذ في أجزاء من المللي ثانية دون تكلفة طلبات API مستمرة أو زمن تأخير خارجي.

السؤال: لماذا يُوزَّع تطبيق VCash Gateway كملف APK خارج متجر Google Play وكيف تُفعَّل صلاحيات Accessibility المقيدة بأمان؟

الإجابة: تقيّد سياسات Google Play بشدة نشر التطبيقات التي تطلب صلاحيات READ_SMS وSEND_SMS وAccessibilityService لتطبيقات الأتمتة وبوابات الربط السحابية، لذا يتاح التطبيق عبر حزمة APK مباشرة من لوحة الأجهزة. وفي أندرويد 13 فأحدث، يمكن تفعيل الصلاحيات بفتح معلومات التطبيق (App Info) والضغط على قائمة الخيارات لاختيار السماح بالإعدادات المقيدة (Allow restricted settings) ثم تفعيل إمكانية الوصول والإشعارات.

السؤال: كيف أتحقق أن رسالة التحويل الواردة مرسلة من مزود محفظة حقيقي وليست رسالة مزيفة من رقم هاتف شخصي؟

الإجابة: عبر ضبط فلتر المُرسِل (Sender Filter) في إعدادات الجهاز داخل واتس360 (Whats360) VCash على المعرف الأبجدي الرسمي لمزود المحفظة (مثل VodafoneCA أو vf-cash) وعدم ترك الحقل فارغًا؛ مما يمنع تطبيق البوابة من إرسال أي رسالة صادرة من أرقام هواتف شخصية عادية أو رسائل خاصة وأكواد تحقق بنكية.

السؤال: كيف أمنع تسجيل نفس معاملة التحويل مرتين عند ربط سجل المعاملات بمتجري الإلكتروني أو نظام ERP؟

الإجابة: بتطبيق مبدأ عدم التكرار (Idempotency) عبر إنشاء قيد تفرد صارم (UNIQUE) على حقل معرف المعاملة txn_ref في قاعدة بياناتك، مع تنفيذ مطابقة ثلاثية تجمع بين المبلغ amount ورقم المحوِّل from_phone والتوقيت created_at قبل اعتماد الطلب.

السؤال: كيف أتجنب خطأ ترتيب المتغيرات في قالب حملة USSD لتحويل فودافون كاش داخل الواجهات العربية؟

الإجابة: لأن العرض ثنائي الاتجاه (RTL/LTR Bidi) قد يعكس مظهر رمزي * و# بصريًا، يجب فحص القالب في اتجاه يسار-إلى-يمين (LTR) للتحقق من أن الصيغة تبدأ بـ *9*7* يليها رقم الهاتف ثم المبلغ ثم # كما في النموذج التالي:

*9*7*$phone$*$amount$#

تنبيه هندسي قبل الإطلاق الكامل:

تحقق دائمًا من عينة الاختبار على ثلاث مراحل قبل تفعيل أي حملة أو ربط حي: اختبر نمط Regex على رسائل ذات أرقام عشرية وآلاف، وتحقق من وجود الرمز WHATS360_API_TOKEN داخل متغيرات البيئة فقط، ونفّذ تحويل USSD تجريبيًا بقيمة رمزية لسطر واحد قبل تشغيل قوائم CSV الجماعية.

هل تحتاج إلى مراجعة بنية التكامل أو خطة تشغيل الأجهزة لنشاطك؟

يمكنك الاعتماد على الوثائق الرسمية في واتس360 (Whats360) لبدء الربط الذاتي، أو طلب مساعدة تقنية لتنفيذ التكامل البرمجي مع متجرك أو نظام ERP عبر Beincode أو استعراض حلول EGCash.

تواصل لمراجعة خطة التكامل عبر واتساب

اترك تعليقاً

زر الذهاب إلى الأعلى