نظام VCash Gateway من Whats360: الدليل التقني لأتمتة SMS وUSSD وإدارة المعاملات عبر أجهزة Android

VCash Gateway: من رسائل SMS إلى نظام أتمتة مالي مركزي

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

يعمل VCash Gateway ضمن منظومة Whats360، ويحوّل الهاتف المرتبط إلى نقطة تشغيل يمكن إدارتها من لوحة التحكم، مع وظائف للأجهزة والرسائل والحملات وUSSD والسيناريوهات والحسابات والتقارير وواجهات التكامل.

التعرف على VCash Gateway

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

هنا تظهر فكرة VCash Gateway: ربط جهاز Android بلوحة تحكم مركزية، استقبال رسائل SMS، تطبيق أنماط تحليل Regex عليها، استخراج البيانات المطلوبة، ثم تسجيل المعاملة وإتاحتها للفلترة والمتابعة. وبالإضافة إلى ذلك، يمكن للنظام تنفيذ أوامر USSD واستخدام متغيرات مثل $phone و$amount داخل الحملات والسيناريوهات.

الإجابة المباشرة:

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

ما هو VCash Gateway؟

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

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

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

العلاقة بين VCash وWhats360

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

كيف يعمل النظام من الهاتف إلى لوحة التحكم؟

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

مسار التشغيل

Android Device → VCash App → QR Pairing → SMS / USSD → Parsing → Transaction → Dashboard → Reports / Automation

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

إعداد تطبيق VCash على جهاز Android

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

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

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

تنبيه تشغيلي:

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

ربط جهاز Android باستخدام QR Code

بعد إعداد التطبيق، يتم إنشاء الجهاز من لوحة التحكم. يدخل المستخدم إلى قسم أجهزة VCash، ثم يضيف جهازًا جديدًا ويحدد اسمه، وبعد ذلك يتم إنشاء QR Code ليتم مسحه من تطبيق VCash.

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

لماذا يعتبر QR Pairing مهمًا؟

لأن عملية الربط لا تتطلب إدخال إعدادات تقنية طويلة داخل الهاتف. يتم إنشاء الجهاز من لوحة التحكم ثم ربط التطبيق به عن طريق QR Code، وهو نموذج عملي لإدارة عدة أجهزة من بيئة مركزية.

إدارة الأجهزة من لوحة VCash

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

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

العنصر	الوظيفة
الجهاز	نقطة تشغيل Android مرتبطة بالمنصة
QR Code	وسيلة ربط التطبيق بالجهاز داخل لوحة التحكم
حالة الاتصال	توضح ما إذا كان الجهاز متصلًا بالمنصة
التعطيل	إيقاف الجهاز عن العمل من لوحة التحكم

إدارة مركزية بدلًا من إدارة كل هاتف منفردًا

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

فتح VCash Gateway

فلترة رسائل SMS حسب المرسل

عند استقبال عدد كبير من الرسائل، لا تكون كل الرسائل بالضرورة مرتبطة بالعملية التي تريد تحليلها. لذلك يوفر VCash Gateway فلترًا يعتمد على اسم المرسل.

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

نصيحة:

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

تحليل رسائل SMS باستخدام Regex

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

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

الهدف ليس تخزين الرسالة فقط، بل تحويل محتواها إلى بيانات قابلة للاستخدام في طبقة الحسابات والمعاملات.

من النص الخام إلى البيانات المنظمة

SMS خام → مطابقة Pattern → استخراج المبلغ → استخراج رقم الهاتف → استخراج ID العملية → استخراج الاسم → إنشاء أو تحديث بيانات المعاملة.

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

مثال عام لفكرة Regex دون كشف بيانات حساسة

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

AMOUNT_PATTERN
PHONE_PATTERN
TRANSACTION_ID_PATTERN
NAME_PATTERN

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

تسجيل المعاملات تلقائيًا

بعد نجاح تحليل الرسالة، يستطيع النظام تحويل البيانات المستخرجة إلى معاملة قابلة للعرض داخل قسم الحسابات. وهذا يختصر مرحلة النقل اليدوي من رسالة SMS إلى سجل مالي.

يمكن عرض المعاملات وتصفية البيانات بحسب الجهاز أو نوع المعاملة أو التاريخ. ويتيح ذلك بناء سجل تشغيلي يمكن الرجوع إليه عند مراجعة العمليات.

نوع البيانات	الاستخدام
المبلغ	تسجيل القيمة المالية المستخرجة من الرسالة
رقم الهاتف	ربط العملية بالرقم الموجود في الرسالة عند استخراجه
رقم العملية	تمييز العملية ومتابعتها
التاريخ	تصفية العمليات ومراجعتها زمنيًا

تنفيذ أوامر USSD من خلال VCash

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

من الأمثلة الموجودة في دليل النظام أمر عام مثل *878#. ويمكن تنفيذ الأمر من قسم USSD بعد تحديد الجهاز وشريحة SIM المناسبة.

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

ملاحظة أمنية:

لا تضع أي PIN حقيقي أو Token فعلي في الأكواد أو المقالات أو لقطات الشاشة العامة. استخدم معرفات وهمية مثل VCASH_DEVICE_TOKEN وVCASH_USSD_PIN عند توثيق التكاملات.

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

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

من أمثلة القوالب العامة الواردة في الدليل:

*9*7*$phone*$amount#

في هذا النموذج، $phone و$amount متغيران يتم استبدالهما بالقيم الموجودة في بيانات الحملة.

متى تصبح الحملات مفيدة؟

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

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

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

تستطيع السيناريوهات استخدام متغيرات مثل $phone و$amount، مما يسمح بإنشاء عملية تعتمد على بيانات الإدخال بدلًا من كتابة كل خطوة بشكل منفصل لكل عملية.

Workflow نموذجي

بيانات العملية → اختيار الجهاز → تنفيذ أمر USSD → انتظار → تنفيذ الخطوة التالية → استخدام المتغيرات الديناميكية → اكتمال السيناريو → متابعة النتيجة داخل لوحة التحكم.

بهذا الأسلوب يتحول USSD من أمر منفرد إلى Workflow يمكن تصميمه حسب طبيعة العملية.

الفرق بين USSD الفردي والحملة والسيناريو

النمط	الاستخدام	الفكرة
USSD مباشر	عملية واحدة	اختيار جهاز وشريحة وتنفيذ الأمر
حملة USSD	مجموعة عمليات متشابهة	قالب ديناميكي + قائمة بيانات
سيناريو	عملية متعددة الخطوات	أوامر متتابعة + انتظار + متغيرات

كيف تساعد المتغيرات الديناميكيةفي الأتمتة؟

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

مثلًا، يمكن أن يحتوي القالب على $phone و$amount. وعند تشغيل العملية، يتم استبدال المتغيرات بالقيم الخاصة بالسجل الحالي.

PHONE = $phone
AMOUNT = $amount
DEVICE = VCASH_DEVICE_ID

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

صندوق رسائل SMS وإدارة الرسائل

يوفر VCash Gateway قسمًا مخصصًا لرسائل SMS يمكن من خلاله عرض الرسائل الواردة مع بيانات مثل المرسل والمبلغ والتاريخ عند توفرها من عملية التحليل. كما يمكن إرسال رسائل يدوية من النظام.

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

ميزة مهمة في بنية النظام

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

الأمان وإدارة Token الخاص بالأجهزة

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

كما يدعم النظام PIN المشفر المستخدم عند الحاجة إلى إدخال PIN أثناء تنفيذ أوامر USSD، إضافة إلى إمكانية تعطيل الجهاز من لوحة التحكم في حالة فقدان الهاتف أو ظهور خطر يستدعي إيقافه.

قواعد أساسية عند توثيق التكامل

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

واجهة VCash Gateway ووحداتها الرئيسية

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

الأجهزة

إضافة وربط ومتابعة أجهزة Android.

SMS

عرض الرسائل وإدارتها وتحليلها.

USSD

تنفيذ أوامر USSD من الأجهزة.

الحملات

تنفيذ عمليات متكررة باستخدام قوالب.

السيناريوهات

بناء عمليات متعددة الخطوات.

الحسابات

متابعة المعاملات وتصنيفها.

كيف يمكن بناء دورة تشغيل كاملة؟

يمكن النظر إلى VCash Gateway باعتباره سلسلة مترابطة بدلًا من مجموعة أدوات منفصلة. تبدأ الدورة من جهاز Android، ثم تصل رسالة SMS، ثم يتم فحص المرسل، ثم تطبيق Regex، ثم استخراج البيانات، ثم تسجيل المعاملة، وبعد ذلك يمكن استخدام بيانات العملية في سيناريوهات أو عمليات متابعة وفق طبيعة النظام.

البنية التشغيلية المقترحة

ربط جهاز Android بالمنصة.
ضبط فلتر المرسل عند الحاجة.
استقبال الرسالة.
مطابقة الرسالة مع Pattern مناسب.
استخراج البيانات المطلوبة.
تسجيل المعاملة.
مراجعة البيانات من الحسابات والتقارير.
استخدام USSD أو السيناريوهات عندما تتطلب العملية ذلك.

متى يكون VCash Gateway مناسبًا؟

يكون النظام مناسبًا عندما تكون لديك عملية تشغيل تعتمد على جهاز Android ورسائل SMS أو أوامر USSD، وتحتاج إلى وضع هذه العمليات داخل نظام مركزي بدلًا من تنفيذها يدويًا على الهاتف.

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

أما إذا كان احتياجك يقتصر على إرسال رسائل WhatsApp أو إدارة محادثات فريق المبيعات، فهذه وظيفة مختلفة عن VCash ويمكن أن تكون أدوات Whats360 الأخرى مثل API أو Inbox أو CRM هي الأقرب لطبيعة الاستخدام.

اختيار الوحدة المناسبة

SMS + معاملات: ركز على الأجهزة والرسائل وRegex والحسابات.

USSD فردي: استخدم قسم أوامر USSD.

USSD جماعي: استخدم الحملات والمتغيرات.

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

ربط برمجي: راجع واجهة API والتوثيق المناسب قبل بناء التكامل.

VCash Gateway كطبقة أتمتة وليس مجرد SMS Gateway

الفرق المفاهيمي المهم هو أن SMS Gateway التقليدي قد يركز على استقبال أو إرسال الرسائل، بينما VCash Gateway يجمع الرسائل مع التحليل والأجهزة وUSSD والحملات والسيناريوهات والحسابات.

هذا يعني أن النظام يستطيع التعامل مع البيانات في أكثر من مرحلة. الرسالة تدخل من جهاز Android، ثم يمكن تحليلها، ثم تتحول إلى سجل منظم، بينما يمكن للأوامر والسيناريوهات تنفيذ عمليات في الاتجاه الآخر من لوحة التحكم إلى الجهاز.

الطبقة	الدور
Android	نقطة استقبال وتنفيذ
SMS	مصدر بيانات نصية
Regex	تحويل النص إلى حقول منظمة
USSD	تنفيذ أوامر على الجهاز
Dashboard	إدارة ومراقبة العمليات

أين يدخل API في بنية VCash؟

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

للمطور الذي يريد دراسة طبقة التكامل، يمكن الرجوع إلى توثيق VCash API لفهم المسارات والوظائف التي يوفرها النظام وفق التوثيق المتاح.

للمطورين وSystem Integrators

إذا كانت لديك منصة خارجية وتحتاج إلى إدخال بيانات VCash أو تنفيذ عمليات برمجية، ابدأ من التوثيق الرسمي بدل بناء التكامل بالاعتماد على افتراضات. استخدم معرفات آمنة مثل WHATS360_API_TOKEN داخل الأمثلة البرمجية ولا تضع مفاتيح حقيقية في المستودعات العامة.

فتح توثيق VCash API

الأخطاء الشائعة عند بناء أتمتة SMS وUSSD

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

الجهاز لا يظهر متصلًا

ابدأ بفحص عملية QR Pairing، ثم تسجيل الدخول والصلاحيات وحالة التطبيق في الخلفية. لا تنتقل مباشرة إلى Regex لأن مشكلة الاتصال تسبق مرحلة تحليل الرسائل.

الرسائل تصل لكن لا تتحول إلى معاملات

هنا يجب فحص فلتر المرسل ثم Pattern المستخدم لتحليل الرسالة. إذا كان المرسل لا يتطابق مع الفلتر، فلن تدخل الرسالة في المسار المطلوب. وإذا وصلت الرسالة ولم تطابق Regex، فلن يتم استخراج الحقول المطلوبة.

أمر USSD لا يعمل كما هو متوقع

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

الحملة لا تستخدم القيم الصحيحة

راجع المتغيرات الموجودة في القالب مثل $phone و$amount، ثم تحقق من أن البيانات المرسلة إلى الحملة تتوافق مع أسماء المتغيرات المستخدمة.

منهج تشخيص عملي

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

VCash Gateway والحسابات والتقارير

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

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

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

متى تحتاج إلى VCash ومتى تحتاج إلى أدوات Whats360 الأخرى؟

من المهم عدم الخلط بين المنتجات والوظائف داخل منظومة Whats360. VCash متخصص في طبقة Android وSMS وUSSD والحسابات المرتبطة بها، بينما توجد وظائف أخرى داخل المنظومة للتعامل مع WhatsApp وCRM وAPI وWebhook والحملات والبوتات والذكاء الاصطناعي.

احتياجك	المسار الأقرب
SMS وUSSD وأجهزة Android	VCash Gateway
ربط WhatsApp مع نظام خارجي	Whats360 API / Webhook
إدارة محادثات فريق	Whats360 CRM / Inbox
حملات واتساب	Whats360 Campaigns

الفرق بين VCash Gateway وSMS Gateway التقليدي

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

متى يكون VCash أكثر ارتباطًا بالاحتياج؟

عندما لا يكون المطلوب مجرد استقبال SMS، بل تحتاج إلى إدارة جهاز Android، تحليل الرسائل، استخراج بيانات مالية، تنفيذ USSD، تشغيل عمليات جماعية، وبناء سيناريوهات متعددة الخطوات داخل لوحة تحكم مركزية.

كيفية البدء في بناء نظام تشغيل باستخدام VCash

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

حدد العملية التي تريد أتمتتها.
حدد الجهاز أو الأجهزة التي ستشارك في العملية.
ثبت تطبيق VCash واضبط الصلاحيات.
اربط الجهاز باستخدام QR Code.
اختبر استقبال الرسائل.
اضبط فلتر المرسل عند الحاجة.
أنشئ Pattern لتحليل الرسالة.
اختبر استخراج البيانات قبل الاعتماد عليه.
راجع تسجيل المعاملة داخل الحسابات.
اختبر USSD إذا كانت العملية تحتاج إليه.
حوّل العمليات المتكررة إلى حملات.
استخدم السيناريوهات عندما توجد خطوات متعددة.

فكر في العملية كـ Workflow

لا تسأل فقط: “هل النظام يستقبل SMS؟” بل اسأل: أين تبدأ العملية؟ ما الحدث الذي يطلقها؟ ما البيانات التي تحتاجها؟ كيف يتم تحليلها؟ أين يتم تسجيلها؟ هل توجد خطوة USSD؟ هل توجد خطوات متتابعة؟ وما النقطة التي تحتاج إلى تدخل بشري؟

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

هل VCash Gateway مناسب للمطورين؟

نعم من ناحية طبيعة الوظائف، النظام يخاطب احتياجات تقنية واضحة، خصوصًا عندما يكون المشروع بحاجة إلى أجهزة Android أو تحليل Regex أو USSD أو تكامل API. وجود قسم API والتوثيق الخاص به يجعل من الممكن دراسة طبقة التكامل وفق ما هو متاح في النظام.

أما إذا كان المشروع يحتاج إلى ربط WhatsApp بتطبيق خارجي، فالمسار التقني مختلف ويجب دراسة قسم Developers في Whats360 والخدمات المرتبطة بالـAPI وWebhook بدل افتراض أن VCash هو طبقة WhatsApp API.

هل VCash Gateway مناسب لأصحاب الأنشطة التجارية؟

يمكن أن يكون مناسبًا عندما تكون طبيعة النشاط تعتمد على العمليات التي يغطيها النظام، مثل استقبال بيانات معاملات عبر SMS أو تنفيذ عمليات USSD أو تنظيم عدد من الأجهزة في بيئة مركزية. أما النشاط الذي يحتاج أساسًا إلى إدارة محادثات WhatsApp وخدمة العملاء، فقد يكون CRM أو Inbox هو الاحتياج الأكثر ارتباطًا.

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

ما الذي يجعل VCash مختلفًا من منظور الأتمتة؟

القيمة الأساسية في VCash هي الجمع بين عدة طبقات في دورة تشغيل واحدة: جهاز Android، SMS، تحليل Regex، USSD، حملات، سيناريوهات، معاملات وتقارير. كل طبقة تؤدي وظيفة مختلفة، لكن جمعها داخل لوحة تحكم واحدة يتيح تصميم عمليات أكثر ترابطًا.

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

النتيجة التقنية

SMS ليست مجرد رسالة، وUSSD ليس مجرد أمر، والجهاز ليس مجرد هاتف. داخل VCash يمكن دمج هذه العناصر في بنية تشغيل واحدة يكون فيها الجهاز نقطة تنفيذ، والرسالة مصدر بيانات، وRegex طبقة تحليل، وUSSD قناة تنفيذ، والحملة أو السيناريو طبقة أتمتة، ولوحة التحكم طبقة تحكم ومتابعة.

كيف تبدأ باستخدام VCash Gateway؟

البداية تكون من خلال تجهيز جهاز Android ليعمل كجهاز استقبال وتنفيذ، ثم تثبيت تطبيق VCash ومنحه الصلاحيات المطلوبة، وبعد ذلك إضافة الجهاز من داخل لوحة التحكم وربطه من خلال QR Code.

خطوات الإعداد الأساسية

تثبيت تطبيق VCash → منح الصلاحيات المطلوبة → تسجيل الدخول → إنشاء الجهاز من لوحة التحكم → تسمية الجهاز → إنشاء QR Code → مسح QR من التطبيق → التأكد من ظهور حالة الجهاز كـConnected.

بعد نجاح الربط يمكن الانتقال إلى إعدادات SMS أو إنشاء Regex Patterns أو تجربة أوامر USSD، حسب العملية التي تريد تنفيذها.

يمكن الرجوع إلى دليل VCash Gateway لمعرفة تفاصيل الإعداد والاستخدام خطوة بخطوة.

ما الصلاحيات التي يحتاجها تطبيق VCash؟

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

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

تنبيه مهم

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

كيف يتم ربط جهاز Android باللوحة؟

عملية الربط تعتمد على QR Code. يتم إنشاء الجهاز من داخل لوحة VCash ثم إنشاء رمز الربط، وبعد ذلك يتم استخدام تطبيق VCash على جهاز Android لمسح الرمز.

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

مؤشر نجاح الربط

ظهور الجهاز داخل قسم Devices بحالة Connected يعني أن الجهاز أصبح مرتبطًا باللوحة ويمكن استخدامه ضمن العمليات التي يدعمها النظام.

كيف تتم معالجة رسائل SMS داخل VCash؟

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

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

بعد ذلك تأتي طبقة Regex Patterns لاستخراج البيانات المهمة من نص الرسالة، مثل قيمة العملية ورقم الهاتف ورقم المعاملة والاسم.

مثال على البيانات التي يمكن استخراجها

قيمة المبلغ.
رقم الهاتف.
رقم العملية أو Transaction ID.
اسم صاحب العملية عند توفره.
بيانات أخرى يمكن تحديدها من خلال Pattern مناسب.

لماذا تعتبر Regex مهمة في VCash؟

لأن الرسائل المالية تصل غالبًا كنصوص تحتوي على مجموعة من البيانات في صيغة واحدة. Regex تسمح بتحديد أجزاء معينة من النص وتحويلها إلى بيانات يمكن للنظام التعامل معها بصورة أكثر تنظيمًا.

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

الفكرة ببساطة

SMS → Regex → استخراج البيانات → تسجيل العملية → إمكانية استخدام البيانات في المتابعة أو الأتمتة.

كيف يتم اختبار Regex قبل الاعتماد عليه؟

يمكن إنشاء Pattern ثم استخدام وظيفة الاختبار للتأكد من أن البيانات المطلوبة يتم استخراجها من نص الرسالة بالشكل المتوقع.

هذه الخطوة مهمة قبل تشغيل أتمتة تعتمد على البيانات المستخرجة، لأن أي Pattern غير دقيق قد يؤدي إلى قراءة قيمة خاطئة أو عدم استخراج البيانات المطلوبة.

ولهذا يفضل اختبار أكثر من نموذج للرسائل إذا كانت صيغة الرسائل قد تختلف بين الحالات أو المرسلين.

كيف يعمل USSD داخل VCash؟

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

يمكن استخدام ذلك لتنفيذ أوامر فردية، كما يمكن إدخال متغيرات مثل رقم الهاتف والمبلغ عند بناء حملات أو سيناريوهات.

مثال على المتغيرات

PHONE = $phone
AMOUNT = $amount
DEVICE = VCASH_DEVICE_ID

الفكرة أن القيم لا تكون ثابتة بالضرورة، وإنما يمكن تمريرها إلى العملية وفق البيانات المحددة للحملة أو السيناريو.

ما هي حملات USSD؟

حملات USSD تسمح بتنفيذ نفس العملية على مجموعة من البيانات بدل تكرار الأمر يدويًا لكل حالة.

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

ومن الأمثلة التقنية على صيغة تحتوي على متغيرات:

*9*7*$phone*$amount#

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

ما الفرق بين الحملة والسيناريو؟

الحملة مناسبة عندما تكون العملية متكررة على مجموعة من المدخلات، بينما السيناريو يسمح ببناء تسلسل من الخطوات مع وجود فواصل زمنية ومتغيرات بين المراحل.

العنصر	الاستخدام	الفكرة
USSD فردي	عملية واحدة	تنفيذ أمر على جهاز وشريحة محددة
Campaign	مجموعة عمليات	تكرار أمر باستخدام قائمة من البيانات
Scenario	Workflow	عدة خطوات مترابطة مع انتظار ومتغيرات

هل VCash Gateway خدمة مستقلة عن اشتراك WhatsApp؟

VCash هو نظام خدمات مالية وأتمتة للأجهزة وSMS وUSSD داخل منظومة Whats360. ويمكن تفعيل باقة مدفوعة للمحافظ الإلكترونية واستخدام وظيفة المحافظ الإلكترونية دون الحاجة إلى الاشتراك في باقة WhatsApp.

أما التجربة المجانية للمحافظ الإلكترونية فتتم من خلال التواصل مع الدعم عبر نظام التذاكر وفق آلية التفعيل المتاحة.

معلومة مهمة

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

هل يمكن استخدام VCash مع Whats360 في مشروع واحد؟

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

VCash يعالج جانب الأجهزة والرسائل المالية وUSSD والعمليات المرتبطة بها، بينما خدمات Whats360 الأخرى قد تغطي إدارة WhatsApp أو الحملات أو الـInbox أو CRM أو الـAPI بحسب الباقة المستخدمة.

هذه الفكرة مهمة عند تصميم النظام حتى لا يتم تحميل VCash وظيفة ليست من اختصاصه، أو افتراض أن كل خدمة داخل Whats360 تؤدي نفس الدور.

متى تحتاج إلى API في VCash؟

تظهر الحاجة إلى API عندما يكون هناك نظام خارجي يحتاج إلى تبادل بيانات أو تنفيذ عمليات مرتبطة بالبنية التي يوفرها VCash.

وهنا يجب الرجوع إلى توثيق VCash API لمعرفة الوظائف والبيانات المتاحة فعليًا، بدل بناء تكامل على افتراضات غير موثقة.

للمطورين

عند بناء التكامل، استخدم بيانات اعتماد حقيقية من حسابك وفق التوثيق، ولا تضع مفاتيح API أو Tokens حقيقية داخل المقالات أو الأمثلة البرمجية.

Authorization: Bearer WHATS360_API_TOKEN

أخطاء شائعة عند إعداد VCash

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

الجهاز غير متصل

راجع التطبيق والصلاحيات واتصال الجهاز، ثم تحقق من حالة الربط داخل قسم Devices.

SMS لا تظهر

راجع صلاحيات SMS والتطبيق في الخلفية، ثم تحقق من Sender Filter والإعدادات المرتبطة بالرسائل.

Regex لا يستخرج البيانات

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

USSD لا ينفذ

راجع الجهاز والشريحة المختارة وصيغة الأمر والصلاحيات المطلوبة للتنفيذ.

كيف تتعامل مع الأمان في VCash؟

لأن النظام يعتمد على أجهزة Android وبيانات مالية وأوامر USSD، فإن إدارة الوصول إلى الأجهزة وبيانات الربط أمر مهم.

لكل جهاز Token خاص به، ويجب عدم مشاركة هذا الـToken مع أشخاص غير مخولين. كما أن PIN يتم التعامل معه وفق آلية الحماية الموجودة في النظام، ويمكن تعطيل الجهاز عن بُعد عند الحاجة.

قاعدة أمان أساسية

لا تشارك Device Token، ولا تضع مفاتيح الوصول الحقيقية داخل ملفات عامة أو مقالات أو لقطات شاشة منشورة. استخدم دائمًا Placeholders عند كتابة الشروحات.

كيف يتم تسجيل المعاملات تلقائيًا؟

عندما تصل رسالة تتوافق مع Pattern تم إعداده، يمكن استخدام البيانات المستخرجة لتسجيل العملية داخل قسم Accounts وTransactions.

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

المصدر	المعالجة	النتيجة
SMS	Regex	بيانات منظمة
بيانات منظمة	Accounts / Transactions	سجل للعمليات
السجلات	Filters / Reports	متابعة وتحليل

من هم المستخدمون الأكثر احتياجًا إلى VCash؟

يمكن أن يكون النظام مناسبًا للمطورين وأصحاب الأنشطة التي تعتمد على أجهزة Android ورسائل المعاملات أو أوامر USSD، وكذلك لمن يحتاج إلى إدارة عدة أجهزة من مكان مركزي.

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

المطور

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

صاحب النشاط

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

مسؤول التشغيل

يحتاج إلى متابعة الأجهزة والرسائل والحملات والسيناريوهات والمعاملات من مكان واحد.

متى لا يكون VCash هو الحل المطلوب؟

إذا كانت المشكلة الأساسية هي إدارة محادثات WhatsApp، توزيع المحادثات على الموظفين، إدارة Inbox أو CRM، فهذه احتياجات مختلفة عن وظيفة VCash الأساسية.

في هذه الحالة يجب دراسة الخدمات الأخرى داخل Whats360 وتحديد الطبقة التي تتوافق مع طبيعة العمل، بدل استخدام VCash لمجرد أنه متاح داخل نفس المنظومة.

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

هل VCash مناسب للمشروعات التي تحتاج إلى Workflow؟

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

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

Workflow Model

Input → Device → USSD/SMS → Processing → Wait → Next Step → Transaction/Result → Monitoring.

دور لوحة التحكم في إدارة VCash

لوحة التحكم هي الطبقة التي تجمع عناصر التشغيل المختلفة في مكان واحد. ويمكن من خلالها الوصول إلى Dashboard وInbox وDevices وCampaigns وGroups وSettings وSMS وUSSD وScenarios وAccounts وReports وAPI وGuide وSubscription.

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

كيف تختار طريقة استخدام VCash؟

ابدأ بتحديد العملية بدل البدء من اسم الوظيفة. اسأل أولًا: هل البيانات تأتي من SMS؟ هل أحتاج إلى تنفيذ USSD؟ هل العملية فردية أم جماعية؟ هل هناك عدة خطوات؟ هل أحتاج إلى تسجيل المعاملات؟ هل هناك نظام خارجي يحتاج إلى API؟

السؤال	إذا كانت الإجابة نعم
هل تحتاج استقبال SMS؟	ابدأ بإعداد الجهاز وSMS وSender Filter.
هل تحتاج استخراج بيانات؟	استخدم Regex Patterns.
هل تحتاج تنفيذ USSD؟	استخدم USSD مع تحديد الجهاز والشريحة.
هل تحتاج تكرار العملية؟	استخدم Campaigns.
هل تحتاج خطوات متعددة؟	استخدم Scenarios.
هل تحتاج سجلًا للعمليات؟	استخدم Accounts وTransactions.
هل تحتاج ربط نظام خارجي؟	راجع API Documentation.

ابدأ من التوثيق الرسمي

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

يمكنك الرجوع إلى دليل VCash Gateway لمعرفة تفاصيل الأجهزة وSMS وRegex وUSSD والحملات والسيناريوهات والحسابات والتقارير.

روابط VCash الأساسية

يمكن الوصول إلى الأقسام المختلفة من خلال الروابط الرسمية التالية:

متى تحتاج إلى API في VCash؟

للمطورين

عند بناء أي تكامل، استخدم بيانات الاعتماد الحقيقية من حسابك وفق التوثيق، ولا تضع مفاتيح API أو Tokens حقيقية داخل المقالات أو الأمثلة البرمجية.

Authorization: Bearer WHATS360_API_TOKEN

ما الذي يجب مراجعته قبل تشغيل الأتمتة؟

قبل تشغيل أي عملية بصورة فعلية، من الأفضل مراجعة الجهاز المرتبط، والصلاحيات، والشريحة المستخدمة، وSender Filter، وRegex Pattern، وصيغة USSD، والمتغيرات المستخدمة داخل الحملة أو السيناريو.

هذه المراجعة تساعد على اكتشاف الأخطاء في مرحلة الإعداد بدل اكتشافها بعد بدء التشغيل.

1. الجهاز

تأكد من أن الجهاز ظاهر داخل Devices وأن حالة الاتصال سليمة.

2. الرسائل

راجع مصدر الرسائل وSender Filter وتأكد من وصول الرسالة إلى الجهاز.

3. Regex

اختبر Pattern على نص حقيقي قبل الاعتماد عليه في تسجيل المعاملات.

4. USSD

اختبر الأمر على الجهاز والشريحة المحددين قبل تشغيل حملة أو Scenario.

كيف تتعامل مع المشكلات الشائعة؟

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

المشكلة	ما يجب مراجعته
الجهاز لا يظهر متصلًا	التطبيق، الصلاحيات، الاتصال، وحالة QR pairing.
لا توجد رسائل	صلاحيات SMS وSender Filter وتشغيل التطبيق.
البيانات المستخرجة غير صحيحة	Regex Pattern ونص الرسالة الفعلي.
USSD لا ينفذ	الجهاز، الشريحة، صيغة الأمر، والصلاحيات.
الحملة لا تعمل كما هو متوقع	المدخلات والمتغيرات وأمر USSD والجهاز المستخدم.

كيف يمكن بناء دورة تشغيل كاملة داخل VCash؟

يمكن تصور دورة التشغيل على شكل سلسلة مترابطة تبدأ من الجهاز وتنتهي بتسجيل النتيجة ومراجعتها.

دورة التشغيل

Android Device → SMS / USSD → Filter → Regex Processing → Variables → Campaign / Scenario → Transaction → Reports.

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

هل يمكن إدارة أكثر من جهاز؟

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

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

إدارة مركزية

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

كيف تساعد أسماء الأجهزة في التشغيل؟

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

يمكن استخدام أسماء وصفية تساعد مسؤول التشغيل على معرفة الجهاز المقصود عند إنشاء حملة أو تنفيذ أمر USSD أو مراجعة المعاملات.

المهم أن يكون نظام التسمية واضحًا وثابتًا داخل المشروع حتى لا يحدث التباس بين الأجهزة.

ما دور Reports في VCash؟

قسم Reports يساعد على الانتقال من مجرد تنفيذ العمليات إلى مراجعة البيانات الناتجة عنها. وبوجود Accounts وTransactions يمكن استخدام السجلات المتاحة لفهم العمليات ومراجعتها وفق الفلاتر الموجودة داخل النظام.

وهذا مهم في البيئات التي تحتوي على عدد كبير من الرسائل أو العمليات، لأن المتابعة اليدوية لكل رسالة تصبح أكثر صعوبة مع زيادة حجم التشغيل.

كيف تربط بين SMS والمعاملات؟

يمكن أن تبدأ الدورة برسالة SMS تحتوي على تفاصيل عملية، ثم يقوم Pattern باستخراج البيانات المطلوبة، وبعد ذلك يمكن تسجيل البيانات داخل Accounts وTransactions وفق إعدادات النظام.

مثال منطقي للدورة

رسالة واردة → تحديد المرسل → مطابقة Pattern → استخراج المبلغ → استخراج رقم الهاتف → استخراج رقم العملية → تسجيل المعاملة → مراجعة التقرير.

ما أهمية اختبار النظام قبل التشغيل الفعلي؟

الاختبار يساعد على التأكد من أن كل طبقة تعمل كما هو متوقع قبل الاعتماد عليها في العمليات الفعلية. ويشمل ذلك اختبار الربط، واستقبال SMS، وRegex، وتنفيذ USSD، والمتغيرات، والحملات، والسيناريوهات.

ومن الأفضل اختبار كل خطوة منفردة أولًا، ثم اختبار الدورة الكاملة بعد التأكد من سلامة المكونات الأساسية.

لا تبدأ بالأتمتة الكاملة مباشرة

اختبر الجهاز أولًا، ثم SMS، ثم Regex، ثم USSD، ثم الحملة أو السيناريو. تقسيم الاختبار إلى مراحل يجعل تحديد سبب الخطأ أسهل.

VCash كطبقة أتمتة مالية

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

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

Device Layer

الجهاز هو نقطة استقبال الرسائل وتنفيذ الأوامر.

Data Layer

SMS وRegex يحولان النصوص إلى بيانات يمكن التعامل معها.

Execution Layer

USSD والحملات والسيناريوهات تنفذ العمليات المطلوبة.

Monitoring Layer

Accounts وTransactions وReports توفر طبقة المتابعة والمراجعة.

متى يكون VCash جزءًا من نظام أكبر؟

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

في هذه الحالة يجب تصميم الحدود بين الأنظمة بوضوح: النظام الخارجي يدير منطق العمل الذي يخصه، وVCash يدير الوظائف التي يوفرها، ويتم الربط بينهما من خلال واجهات موثقة.

قاعدة هندسية

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

ما الفرق بين VCash وSMS Gateway التقليدي؟

SMS Gateway التقليدي قد يركز على استقبال أو إرسال الرسائل، بينما VCash يضيف طبقات أخرى مثل تحليل الرسائل باستخدام Regex، وتنفيذ USSD، والحملات، والسيناريوهات، وربط الأجهزة، وتسجيل المعاملات.

الوظيفة	SMS Gateway تقليدي	VCash
استقبال SMS	قد يكون متاحًا	مدعوم ضمن بنية VCash
Regex Parsing	يعتمد على النظام	جزء من النظام
USSD	ليس بالضرورة	متاح
Campaigns	حسب النظام	متاحة
Scenarios	حسب النظام	متاحة
Transactions	حسب النظام	مدعومة ضمن Accounts

هل VCash مناسب للمطورين؟

يقدم VCash مجموعة من المكونات التي يمكن للمطور دراستها عند بناء نظام يعتمد على أجهزة Android أو SMS أو USSD أو المعاملات. وتظهر أهمية ذلك خصوصًا عندما يكون المطلوب نقل عملية كانت تتم يدويًا على الهاتف إلى Workflow أكثر تنظيمًا.

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

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

حدد أولًا مصدر البيانات، ثم طريقة التنفيذ، ثم شكل البيانات، ثم نقطة التكامل. بعد ذلك ابدأ في بناء الكود اعتمادًا على التوثيق الرسمي.

هل VCash مناسب لأصحاب الأنشطة التجارية؟

ما الذي يجعل VCash مختلفًا من منظور الأتمتة؟

النتيجة التقنية

كيف تبدأ باستخدام VCash Gateway؟

خطوات الإعداد الأساسية

بعد نجاح الربط يمكن الانتقال إلى إعدادات SMS أو إنشاء Regex Patterns أو تجربة أوامر USSD، حسب العملية التي تريد تنفيذها.

يمكن الرجوع إلى دليل VCash Gateway لمعرفة تفاصيل الإعداد والاستخدام خطوة بخطوة.

روابط مهمة للمستخدم والمطور

VCash

الوصول إلى صفحة خدمة VCash وإدارة الوظائف المرتبطة بها.

فتح VCash

دليل الاستخدام

شرح المكونات الأساسية وطريقة الإعداد والاستخدام.

فتح الدليل

API Documentation

للمطورين الذين يحتاجون إلى دراسة طبقة التكامل.

فتح API Docs

الدعم الفني

للاستفسارات أو طلبات التفعيل والدعم المتعلقة بالخدمة.

فتح تذكرة دعم

هل تحتاج إلى مساعدة في تحديد المسار المناسب؟

حدد العملية أولًا

إذا كنت تعرف ما تريد أتمتته، يمكن تحديد ما إذا كنت تحتاج SMS أو Regex أو USSD أو Campaign أو Scenario أو API، بدل البدء من اسم الخدمة فقط.

تواصل للاستفسار عن VCash

الخلاصة

VCash Gateway داخل منظومة Whats360 يمثل طبقة أتمتة موجهة إلى الأجهزة وSMS وUSSD والعمليات المالية التي يمكن تنظيمها من خلال لوحة تحكم مركزية.

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

يمكن للجهاز أن يكون نقطة التنفيذ، ويمكن لـSMS أن تكون مصدر البيانات، ويمكن لـRegex أن يحول النص إلى بيانات منظمة، ويمكن لـUSSD أن ينفذ الأوامر، ويمكن للحملات والسيناريوهات تحويل العمليات المتكررة إلى Workflow، بينما توفر الحسابات والتقارير طبقة للمراجعة والمتابعة.

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

الخلاصة التقنية في سطر واحد

VCash يحول الجهاز والرسائل وأوامر USSD إلى مكونات يمكن تنظيمها داخل دورة أتمتة واحدة وإدارتها من خلال لوحة تحكم مركزية.

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

VCash Gateway، VCash، Whats360، المحافظ الإلكترونية، أتمتة المحافظ الإلكترونية، SMS Gateway، SMS Automation، USSD Automation، USSD Campaigns، USSD Scenarios، Regex Patterns، Android SMS Gateway، إدارة أجهزة Android، SMS Parsing، Transaction Automation، Financial SMS، API Integration، VCash API، Whats360 API، أتمتة المعاملات، إدارة المعاملات، أتمتة USSD، بوابة المحافظ الإلكترونية، أتمتة الرسائل المالية، Whats360 VCash Gateway.

الأسئلة الشائعة حول VCash Gateway

ما هو VCash Gateway؟

VCash Gateway هو نظام لإدارة وأتمتة أجهزة Android واستقبال SMS وتحليلها باستخدام Regex وتنفيذ USSD وإنشاء حملات وسيناريوهات ومتابعة الحسابات والمعاملات من خلال لوحة تحكم مركزية داخل منظومة Whats360.

هل يحتاج VCash إلى جهاز Android؟

يعتمد تشغيل VCash على جهاز Android يعمل كطبقة استقبال وتنفيذ للوظائف المرتبطة بـSMS وUSSD، ويتم ربط الجهاز باللوحة من خلال التطبيق وQR Code.

هل يمكن استخراج بيانات المعاملة من SMS؟

نعم، يمكن إعداد Regex Patterns لاستخراج عناصر مثل المبلغ ورقم الهاتف ورقم العملية والاسم من نص الرسائل وفق الصيغة التي تصل بها الرسالة.

هل يدعم VCash تنفيذ USSD؟

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

ما الفرق بين Campaign وScenario في VCash؟

Campaign مناسبة لتكرار عملية على مجموعة من البيانات، بينما Scenario تسمح ببناء سلسلة من الخطوات المتتابعة مع الانتظار والمتغيرات.

هل يمكن ربط VCash بنظام خارجي؟

يمكن دراسة التكامل من خلال واجهة API والتوثيق المتاح، مع الالتزام بالوظائف والبيانات التي يدعمها النظام فعليًا.

هل VCash هو WhatsApp API؟

لا. VCash مخصص لطبقة الأجهزة وSMS وUSSD والأتمتة المرتبطة بها. أما تكامل WhatsApp فيتم التعامل معه من خلال الخدمات والتوثيق الخاصين بـWhats360 وفق الوظيفة المطلوبة.

هل يمكن استخدام المحافظ الإلكترونية دون اشتراك WhatsApp؟

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

FAQ Schema Ready Section

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "ما هو VCash Gateway؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "VCash Gateway هو نظام لإدارة وأتمتة أجهزة Android واستقبال SMS وتحليلها باستخدام Regex وتنفيذ USSD وإنشاء حملات وسيناريوهات ومتابعة الحسابات والمعاملات من خلال لوحة تحكم مركزية داخل منظومة Whats360."
      }
    },
    {
      "@type": "Question",
      "name": "هل يحتاج VCash إلى جهاز Android؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "يعتمد تشغيل VCash على جهاز Android يعمل كطبقة استقبال وتنفيذ للوظائف المرتبطة بـSMS وUSSD ويتم ربط الجهاز باللوحة من خلال التطبيق وQR Code."
      }
    },
    {
      "@type": "Question",
      "name": "هل يمكن استخراج بيانات المعاملة من SMS؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "نعم، يمكن إعداد Regex Patterns لاستخراج عناصر مثل المبلغ ورقم الهاتف ورقم العملية والاسم من نص الرسائل وفق الصيغة التي تصل بها الرسالة."
      }
    },
    {
      "@type": "Question",
      "name": "هل يدعم VCash تنفيذ USSD؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "نعم، يمكن اختيار الجهاز والشريحة وتنفيذ أوامر USSD، كما يمكن استخدام USSD داخل الحملات والسيناريوهات بحسب تصميم العملية."
      }
    },
    {
      "@type": "Question",
      "name": "هل يمكن ربط VCash بنظام خارجي؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "يمكن دراسة التكامل من خلال واجهة API والتوثيق المتاح، مع الالتزام بالوظائف والبيانات التي يدعمها النظام فعليًا."
      }
    },
    {
      "@type": "Question",
      "name": "هل VCash هو WhatsApp API؟",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "لا. VCash مخصص لطبقة الأجهزة وSMS وUSSD والأتمتة المرتبطة بها، بينما تكامل WhatsApp يتم التعامل معه من خلال الخدمات والتوثيق الخاصين بـWhats360."
      }
    }
  ]
}

المراجع الرسمية

نظام تذاكر الدعم الفني

Whats360