اتصال عميل SMPP

هذا الدليل يتعلق بإعداد اتصال عميل SMPP. يحدد ما هو اتصال عميل SMPP، وما الذي يعنيه اختصار SMPP، وكيف يمكنك استخدام اتصال عميل SMPP لتوصيل نظام بوابة الرسائل القصيرة Ozeki بمركز خدمة الرسائل القصيرة (SMSC) لمشغل شبكة الهاتف المحمول عبر الإنترنت.

ماذا يعني اختصار SMPP؟

SMPP تعني بروتوكول الرسائل القصيرة من نظير إلى نظير. هذا هو بروتوكول معياري في الصناعة مصمم لتسليم رسائل SMS عبر اتصالات TCP/IP عبر الإنترنت. هذا البروتوكول يتم تنفيذه بواسطة بوابة الرسائل القصيرة Ozeki.

ما هو عميل SMPP؟

عميل SMPP هو برنامج يسمح لك بالاتصال بمزود خدمة الرسائل القصيرة عبر الإنترنت. عميل SMPP، مثل بوابة الرسائل القصيرة Ozeki، يستخدم بروتوكول SMPP لإرسال واستقبال رسائل SMS النصية.

كيفية توصيل عميل SMPP

لتوصيل عميل SMPP بمزود خدمة الرسائل القصيرة من أجل إرسال واستقبال SMS، يرجى اتباع هذه الخطوات:

  1. افتح https://localhost:9515 في متصفحك
  2. قم بتسجيل الدخول باستخدام اسم المستخدم وكلمة المرور
  3. انقر على "إضافة اتصال جديد"
  4. اختر "عميل SMPP"
  5. أدخل اسم مضيف SMPP والمنفذ
  6. أدخل رقم الهاتف
  7. انقر موافق لتوصيل عميل SMPP
  8. تحقق من سجلات SMPP
  9. أرسل رسالة SMS تجريبية

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

كيفية إرسال SMS عبر عميل SMPP

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

كيفية إرسال رسالة SMS عبر عميل SMPP
الشكل 1 - كيفية إرسال SMS عبر عميل SMPP

كيفية إعداد اتصال عميل SMPP باستخدام بوابة الرسائل القصيرة Ozeki (فيديو تعليمي)

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

الفيديو 1 - كيفية إعداد اتصال عميل SMPP باستخدام بوابة الرسائل القصيرة Ozeki (فيديو تعليمي)

تعليمات تفصيلية لإعداد SMPP

إعداد اتصال SMPP للرسائل القصيرة في بوابة الرسائل القصيرة Ozeki هو إجراء بسيط نسبيًا. تحتاج إلى تسجيل الدخول إلى بوابة الرسائل القصيرة باستخدام متصفح الويب كمسؤول، و تحتاج إلى تنفيذ بعض الخطوات البسيطة. للتكوين نوصي بتسجيل الدخول باستخدام حساب المسؤول. اسم مستخدم المسؤول هو "admin"، و كلمة المرور هي التي قمت بتوفيرها أثناء التثبيت. (الشكل 2)

تسجيل الدخول إلى Ozeki 10 لإعداد اتصال عميل SMPP
الشكل 2 - تسجيل الدخول إلى Ozeki 10 لإعداد اتصال عميل SMPP

كيفية إنشاء اتصال عميل SMPP جديد

لإنشاء اتصال عميل SMPP جديد بعد تسجيل الدخول، تحتاج إلى النقر على رابط 'إضافة اتصال جديد' في وحدة التحكم لإدارة تطبيق بوابة الرسائل القصيرة Ozeki 10. يقع هذا الرابط في لوحة الاتصالات أسفل النص "لا توجد اتصالات مثبتة..." (الشكل 3). سيؤدي هذا الرابط إلى عرض قائمة بالبروتوكولات المتاحة. لاحظ أن SMPP هو بروتوكول رسائل قصيرة يمكن استخدامه لإرسال رسائل SMS.

إنشاء اتصال عميل SMPP جديد
الشكل 3 - إنشاء اتصال عميل SMPP جديد


لتثبيت اتصال عميل SMPP، سيتعين عليك اختيار عميل SMPP من قائمة الاتصالات المتاحة. يمكن العثور على عميل SMPP في قسم اتصالات الرسائل القصيرة عبر IP (الشكل 4). تحتاج إلى النقر على تثبيت لتثبيت عميل SMPP. ستستخدم اتصال عميل لأنك ترغب في توصيل بوابة الرسائل القصيرة بمزود خدمة الرسائل القصيرة عبر الإنترنت. (إذا كنت ترغب في تقديم خدمة الرسائل القصيرة، وتريد أن يتصل عملاؤك ببوابة الرسائل القصيرة الخاصة بك عبر SMPP، تحتاج إلى إعداد حساب مستخدم SMPP وتحتاج إلى تكوين خدمة SMPP.)

اختر 'عميل SMPP' من القائمة وانقر على تثبيت.

تثبيت اتصال عميل SMPP
الشكل 4 - تثبيت اتصال عميل SMPP

تكوين اتصال عميل SMPP الخاص بك

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

لتكوين عميل SMPP (الشكل 5):

  1. حدد علامة التبويب العامة
  2. انتقل إلى نموذج تكوين عميل SMPP
  3. أعط اسمًا لاتصال عميل SMPP هذا
  4. أدخل اسم مضيف SMPP
  5. قم بتعيين رقم منفذ SMPP
  6. قم بتوفير اسم مستخدم SMPP الخاص بك
  7. اكتب كلمة المرور الخاصة بك
  8. قم بتعيين معرف مرسل لعميل SMPP هذا
  9. انقر فوق موافق

توفير بيانات اعتماد عميل SMPP
الشكل 5 - توفير بيانات اعتماد عميل SMPP

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

مضيف SMPP:

مضيف SMPP هو اسم المضيف أو عنوان IP الذي يستخدمه عميل SMPP للاتصال بخادم SMPP. هذا هو عنوان IP (أو اسم المضيف) لخادم SMPP.

رقم منفذ SMPP:

رقم منفذ SMPP هو رقم منفذ TCP/IP الذي يستخدمه عميل SMPP للاتصال بخادم SMPP. هذا الرقم هو المكان الذي يستمع فيه الخادم لاتصالات SMPP الواردة.

اسم مستخدم SMPP:

اسم مستخدم SMPP هو معرف نظام SMPP. يتم توفير هذا المعرف بواسطة مشغل خادم SMPP عند الاشتراك في خدمتهم.

كلمة مرور SMPP:

كلمة مرور SMPP هي كلمة المرور المستخدمة لمصادقة حساب SMPP الخاص بك على خادم SMPP. يتم توفير هذه كلمة المرور لك بواسطة مشغل خادم SMPP (أو مزود خدمة SMPP) عند الاشتراك في خدمتهم.

رقم هاتف SMPP:

رقم هاتف SMPP هو معرف مرسل SMPP. هذا هو رقم الهاتف الذي يتم عرضه على الهاتف المحمول كعنوان مرسل، عند استلام رسائلك القصيرة.

تحقق من سجل SMPP

بمجرد تكوين اتصال عميل SMPP، يجب عليك التحقق من سجل اتصال عميل SMPP لمعرفة ما إذا كان النظام متصلاً بشكل صحيح بمزود خدمة الرسائل القصيرة الخاص بك. إذا اتصل النظام بشكل صحيح، فسترى إدخال السجل "الاتصال متصل". يمكن العثور على سجلات اتصال الرسائل القصيرة في الدليل التالي في Windows: C:\Program Files\Ozeki\Data\Logs\Connections\. في علامة التبويب "الأحداث" في صفحة تفاصيل اتصال عميل SMPP، يمكنك رؤية معاينة للسجل. تحتوي هذه الصفحة على آخر 100 إدخال في السجل. لاحظ أن ملفات سجل SMPP يتم تدويرها لتوفير مساحة على القرص.

كيفية عرض سجل اتصال عميل SMPP (الشكل 6):
  1. افتح صفحة تفاصيل اتصال عميل SMPP
  2. انقر على علامة التبويب "الأحداث"
  3. انقر على أيقونة العين بجوار عنوان "الأحداث"
  4. انسخ اسم الملف بجوار عنوان "الأحداث"
  5. افتح المفكرة
  6. الصق اسم الملف في مربع الحوار "فتح ملف" في المفكرة
  7. انقر فوق موافق لفتح ملف سجل SMPP
  8. استخدم F3 للعثور على التاريخ الذي تهتم به
  9. ابحث عن "ERRO" للعثور على الأخطاء في السجل

عرض سجل اتصال عميل SMPP
الشكل 6 - عرض سجل اتصال عميل SMPP

إرسال رسالة SMS اختبارية

بمجرد اتصال اتصالك، يمكنك التحقق مما إذا كان جاهزًا لتسليم رسائل SMS عن طريق إرسال رسالة SMS اختبارية. لإرسال رسالة SMS اختبارية، تحتاج إلى فتح علامة التبويب "اختبار"، وتحتاج إلى إدخال رقم الهاتف ونص الرسالة. يُوصى بتوفير رقم الهاتف بالتنسيق الدولي. هذا يعني أن رقم الهاتف يجب أن يبدأ بعلامة زائد متبوعة برمز الدولة. إذا كان رقم هاتفك المحلي يبدأ بـ 0، فمن المحتمل أنك ستحتاج إلى حذف البادئة 0. على سبيل المثال، إذا كان رقم هاتفك في المملكة المتحدة هو 07958663698، فسترسل رسالة SMS الاختبار إلى +447958663698.

كيفية إرسال رسالة SMPP اختبارية (الشكل 7):
  1. انتقل إلى صفحة تفاصيل اتصال عميل SMPP
  2. حدد علامة التبويب "اختبار"
  3. أدخل رقم هاتف المستلم
  4. تأكد من أن رقم الهاتف بالتنسيق الدولي
  5. أدخل نص الرسالة
  6. تأكد من أن نص الرسالة أقل من 160 حرفًا
  7. انقر على زر "إرسال"
  8. تحقق من سجلات SMPP

يتم إرسال الرسالة القصيرة باستخدام submit_sm PDU عبر رابط SMPP الذي تم إنشاؤه بين عميل SMPP وخادم SMPP. يحمل هذا PDU معرف المرسل، وعنوان المستلم، ونص الرسالة، وجميع العلامات والمعلمات اللازمة لعرض الرسالة القصيرة بشكل صحيح على هاتف المستلم.

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

إرسال رسالة اختبارية
الشكل 7 - إرسال رسالة اختبارية


بعد إرسال الرسالة بنجاح، يجب عليك التحقق من سجلات SMPP. ستكشف سجلات SMPP عن رسائل SMPP منخفضة المستوى، والتي تُستخدم لتمرير محتوى الرسالة إلى مزود خدمة الرسائل القصيرة. تُسمى هذه الرسائل أيضًا بـ PDU SMPP (وحدة بيانات بروتوكول SMPP). إذا كانت هناك مشكلة في إرسال الرسالة، سيطلب منك مزود خدمة الرسائل القصيرة سجلات SMPP. في هذه الحالة، تحتاج إلى إرسال وحدات PDU SMPP إليهم. لكل إرسال رسالة قصيرة، ستظهر وحدتان PDU SMPP في السجل. الأولى هي PDU SMPP SUBMIT_SM، التي تمرر الرسالة إلى مزود خدمة الرسائل القصيرة، و PDU SMPP SSUBMIT_SM_RESP، التي تُرجع معرفًا مرجعيًا يمكن استخدامه لتتبع الرسالة، وللعثور على تقارير التسليم التي تُعاد إليك عند تسليم الرسالة إلى هاتف المستلم. (الشكل 8)

نتيجة إرسال رسالة SMPP في السجلات
الشكل 8 - نتيجة إرسال رسالة SMPP في السجلات

مواصفات بروتوكول SMPP

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

مواصفات بروتوكول SMPP:

تنزيل: smpp-protocol-specification-v3.4.pdf

إصدارات بروتوكول SMPP

معيار SMPP هو بروتوكول متطور. كان الإصدار الأول الذي تم اعتماده على نطاق واسع هو v3.3. حاليًا، الإصدار الأكثر شيوعًا هو v3.4، ولكن هناك أيضًا إصدار أحدث وهو v5.0 الذي نادرًا ما يُستخدم في خدمات الرسائل القصيرة.

يدعم SMPP 3.3، وهو أقدم إصدار، رسائل GSM SMS فقط. يولد استجابة فورية لكل رسالة مرسلة. في معظم الحالات، لا يتم دعم هذا الإصدار عبر اتصالات SSL. المشكلة في SMPP 3.3 هي أنه يتطلب رابطين SMPP: رابط إرسال SMPP ورابط استقبال SMPP إلى مزود خدمة الرسائل القصيرة. عند إعداد رابط SMPP v3.3 في Ozeki SMS Gateway، سيتعين عليك إنشاء اتصالين عميل SMPP، وتكوين أحدهما كمرسل SMPP والآخر كمستقبل SMPP.

بروتوكول SMPP 3.4 مشابه لـ SMPP 3.3، لكنه يتمتع بميزة قوية: فهو يسمح لك بإرسال واستقبال رسائل SMS عبر رابط TCP/IP واحد. في Ozeki SMS Gateway، ستحتاج فقط إلى إعداد اتصال عميل SMPP واحد إذا كنت ترغب في استخدام هذا البروتوكول. يضيف SMPP v3.4 أيضًا معلمات Tag-Length-Value (TLV) اختيارية إلى رسالة SMS، مما يسمح للمستخدم بالعمل مع تقنيات SMS غير GSM، مثل رسائل SMS في شبكات CDMA.

SMPP 5.0 هو أحدث إصدار من SMPP. وهو يمتد v3.4 بإضافة دعم للبث الخلوي، والتحكم الذكي في التدفق. لا يستخدم العديد من مزودي خدمة الرسائل القصيرة هذا البروتوكول. نوصي بإعداد اتصالات SMPP v3.4 في Ozeki SMS Gateway.

اختبار عميل SMPP

لاختبار اتصال عميل SMPP الخاص بك، من الجيد إعداد صفحة اختبار أداء SMPP.

الأسئلة الشائعة

ما هي نوع المعلمات التي أحتاجها للاتصال بمزود خدمة SMPP؟

هذه هي التفاصيل الأساسية المطلوبة لتكوين اتصال SMPP لبوابة Ozeki للرسائل القصيرة:

  • عنوان الخادم/اسم المضيف: يحدد موقع خادم SMSC (إما عنوان IP أو اسم المضيف) للاتصال به.
  • رقم المنفذ: يحدد منفذ TCP/IP المحدد على خادم SMSC الذي يجب أن تستخدمه البوابة للاتصال.
  • اسم المستخدم (معرف النظام): يعرف حسابك على خادم SMSC.
  • كلمة المرور: كلمة المرور المرتبطة باسم المستخدم للمصادقة الآمنة.
  • إصدار SMPP: حدد الإصدار المتوافق من بروتوكول SMPP المدعوم من خادم SMSC (يدعم Ozeki الإصدارين 3.3 و3.4).
  • نوع النظام (اختياري): مطلوب فقط إذا كان خادم SMSC يفرضه. هذه القيمة، غالبًا ما تكون "SMPP"، سيتم توفيرها من قبل مسؤول نظام SMPP الخاص بك.
  • عنوان المرسل: رقم الهاتف الافتراضي الذي يظهر كمرسل للرسائل القصيرة الصادرة.
  • نطاق العناوين (اختياري): يستخدم بشكل أساسي لاستقبال الرسائل. هذه المعلومات، التي يتم إرسالها إلى SMSC بعد تسجيل الدخول، تكون ذات صلة عند إدارة أرقام هواتف متعددة على اتصال SMPP واحد.
امتلاك هذه التفاصيل جاهزة يضمن عملية تكوين سلسة لاتصال SMPP الخاص ببوابة Ozeki للرسائل القصيرة.

ما هو اتصال مرسل SMPP؟

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

ما هو اتصال مستقبل SMPP؟

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

ما هو اتصال مرسل-مستقبل SMPP؟

اتصال مرسل-مستقبل SMPP يوفر خيارًا متعدد الاستخدامات لكل من إرسال واستقبال رسائل SMS. يعمل مثل طريق ذو اتجاهين، مما يتيح لبوابة Ozeki للرسائل القصيرة إرسال الرسائل واستقبال الرسائل الواردة من SMSC (مركز خدمة الرسائل القصيرة) عبر اتصال TCP/IP واحد. هذا النوع من الاتصال مثالي لمعظم السيناريوهات التي تحتاج فيها إلى كل من إمكانيات إرسال واستقبال SMS.

ملخص

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

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

الآن قم بتنزيل بوابة Ozeki للرسائل القصيرة ولتبدأ العمل!

More information