الإجابة المختصرة
- استخدموا SOAP عندما يكون النظام الذي يُطلق الرسالة يتصل أصلًا بخدمات ويب SOAP، ويكون تغيير ذلك مكلفًا أو بطيئًا.
- استخدموا REST للتطبيقات الجديدة والمواقع والأنظمة الخلفية لتطبيقات الجوال، فهي تعمل من أي لغة برمجة تقريبًا.
- استخدموا SMPP عندما ترسلون كميات كبيرة ومستمرة من الرسائل النصية وتستطيعون إبقاء اتصال طويل الأمد مفتوحًا.
- أيًّا كان اختياركم، تتصل خوادمكم من عناوين IP مصرّح بها أو عبر اتصال VPN، ويجب تسجيل اسم المرسل، ويستهلك النص العربي أجزاءً من الرسالة النصية أكثر من النص الإنجليزي.
SOAP في فقرة واحدة
SOAP معيار من W3C لتبادل البيانات المنظمة بين الأنظمة بصيغة XML. وكل رسالة SOAP عبارة عن غلاف (Envelope) فيه ترويسة اختيارية لمعلومات التحكم، ومتن إلزامي يحمل الطلب نفسه. وعندما ينتظر الطلب استجابة عبر HTTP، تُرسل رسالة SOAP ضمن طلب POST. فإذا كان لديكم نظام قائم يتصل بخدمات أخرى عبر SOAP، فقد تكون SOAP أقصر طريق من هذا النظام إلى الرسائل النصية.
SOAP أم REST أم SMPP: أي واجهة لأي نظام
| SOAP | REST | SMPP | |
|---|---|---|---|
| صيغة الرسالة | غلاف XML | طلبات HTTPS، غالبًا بصيغة JSON | بروتوكول ثنائي عبر جلسة مستمرة |
| الاتصال | طلب واستجابة لكل عملية | طلب واستجابة لكل عملية | جلسة طويلة الأمد يبقيها نظامكم مفتوحة |
| الاستخدام المعتاد | أنظمة ERP والفوترة وأنظمة المؤسسات القائمة التي تستدعي خدمات SOAP أصلًا | التطبيقات الجديدة والمواقع والأنظمة الخلفية لتطبيقات الجوال وإجراءات CRM | الرسائل النصية عالية الحجم والمستمرة، وأنظمة قطاع الاتصالات |
| ما يحتاجه فريقكم | عميل SOAP أو موصّل جاهز في النظام، ومطابقة حقول XML | أي مكتبة HTTP | عميل SMPP وخبرة في تشغيل جلسة مستمرة |
اسألونا عن العمليات التي تدعمها كل واجهة في حسابكم قبل تصميم الربط.
وإذا كان لدى الجهة عدة أنظمة، فليس عليها أن تستخدم الواجهة نفسها في جميعها. ومن الأنماط الممكنة: SOAP من نظام ERP لرسائل الفواتير وتذكيرات السداد، وREST من التطبيق لرموز التحقق وتحديثات الطلبات، وSMPP حيث يبرر حجم الرسائل ذلك فقط.
قبل الرسالة الأولى: ما الذي تجهزونه
- حدّدوا الأنظمة التي سترسل، والرسائل التي يُطلقها كل منها: رموز التحقق، والتنبيهات، والتذكيرات، والحملات.
- اختاروا واجهة لكل نظام بالاستعانة بالجدول أعلاه.
- زوّدونا بعناوين IP الصادرة من الخوادم التي ستتصل بالـAPI، للاختبار والإنتاج، ليُصرَّح بها، أو رتّبوا اتصال VPN.
- سجّلوا أسماء المرسل للرسائل النصية. وتتولى إنتركي تسجيلها لدى الجهة التنظيمية والمشغلين أثناء التهيئة.
- جهّزوا القوالب للرسائل التي يرسلها فريقكم من المنصة، ويعتمدها فريقكم وإنتركي قبل استخدامها.
- تحققوا من طول الرسالة العربية. تتسع الرسالة النصية العربية لـ70 حرفًا إذا كانت رسالة واحدة، ولـ67 حرفًا في كل جزء إذا طالت، بينما تتسع الإنجليزية (GSM-7) لـ160 حرفًا، أو 153 في كل جزء.
- حدّدوا كيف سيعرف نظامكم نتيجة تسليم كل رسالة، وما الذي يفعله إذا فشلت.
- اتفقوا على خطة اختبار: مجموعة صغيرة من الأرقام الحقيقية على كل شبكة سعودية، بالعربية والإنجليزية.
أسئلة تطرحونها على أي واجهة SOAP للرسائل النصية
- ما العمليات المتاحة عبر SOAP: إرسال رسالة واحدة، أو إرسال دفعة، أو الاستعلام عن حالة التسليم؟
- كيف تتم مصادقة الطلب، وكيف تُستبدل بيانات الاعتماد؟
- كيف يحصل نظامكم على نتائج التسليم: بالاستعلام عن الحالة، أم باستقبال إشعار (callback)؟
- هل يوجد وصف للخدمة يستطيع عميل SOAP لديكم استيراده، وهل توجد بيئة اختبار؟
- ماذا يحدث عند رفض الطلب، وما رموز الخطأ التي تعود؟
ونجيب عن هذه الأسئلة كتابيًا لحسابكم أثناء التخطيط للربط.
دور ديجيتال كونكت
- ثلاث واجهات في منصة واحدة: REST لرسائل التطبيقات، وSMPP للرسائل النصية عالية الحجم والمستمرة، وSOAP عندما يتطلبه نظام أعمال قائم.
- دعم التكامل مع أنظمة CRM وERP.
- ضوابط الوصول: الوصول من عناوين IP مصرّح بها أو عبر اتصال VPN لأنظمتكم، والمصادقة الثنائية برمز يصل عبر البريد الإلكتروني ومستويات صلاحيات للمدير والمستخدم لمستخدمي المنصة.
- حماية الحساب: الحماية من الاحتيال، وحظر الدول، وحدود الإنفاق.
- إشعار تسليم لكل رسالة، وتقارير تسليم موحّدة.
- تسجيل اسم المرسل لدى الجهة التنظيمية والمشغلين ضمن التهيئة.
- دعم من الرياض خلال أيام العمل في المملكة، بالعربية والإنجليزية.
- الأسعار بعرض سعر يناسب حجم رسائلكم.
متى لا تكون الخيار المناسب: إذا كان معظم مستلمي رسائلكم خارج المملكة العربية السعودية، أو إذا كنتم ترسلون بضع مئات من الرسائل شهريًا فقط.
الأمان وضوابط الوصول في ديجيتال كونكت
أسئلة تطرحها فرق الربط
هل SOAP أبطأ أو أقل موثوقية من REST؟
يحمل طلب SOAP ترميزًا أكثر من طلب REST المعتاد بسبب غلاف XML. وكلاهما استدعاء بطلب واستجابة عبر HTTP، فاختاروا الواجهة التي يسهل على نظامكم بناؤها وصيانتها، واستخدموا SMPP حيث يبرر الحجم المستمر ذلك.
هل يستطيع نظامنا معرفة نتيجة تسليم كل رسالة؟
نعم. توفر ديجيتال كونكت إشعار تسليم لكل رسالة. اسألونا عن طريقة استقبال نظامكم له عبر الواجهة التي تختارونها.
نظام ERP لدينا لا يحتوي على موصّل SOAP. ما الحل؟
استخدموا REST من خدمة ربط صغيرة أو من أداة الربط الوسيطة (middleware) لديكم، أو اسألوا شريك ERP عن توفر موصّل. ويمكننا مراجعة الخيارات مع فريقكم.
ما عناوين IP التي نحتاج إلى التصريح بها؟
العناوين الصادرة لكل خادم سيتصل بالـAPI، في بيئة الاختبار وبيئة الإنتاج. خططوا لذلك قبل الإطلاق، لأن أي خادم جديد أو عنوان متغير يجب أن يُضاف إلى القائمة المصرّح بها. وإذا صعُب الحفاظ على قائمة عناوين ثابتة، فاسألونا عن اتصال VPN بدلًا منها.
هل يمكن أن تستخدم أنظمة مختلفة واجهات مختلفة على الحساب نفسه؟
اسألونا عن إعدادكم. فالتخطيط لواجهة لكل نظام أبسط غالبًا من فرض واجهة واحدة على جميع الأنظمة.