الإجابة المختصرة
للربط بمزوّد رسائل نصية عبر SMPP، اطلب اتصال bind وسجّل عناوين IP التي ستتصل منها، ثم افتح اتصال TLS بالمضيف والمنفذ المحددين. أرسل bind_transceiver مع system_id وكلمة المرور، وأرسل الرسائل عبر submit_sm، وأكّد استلام كل تقرير deliver_sm، وأرسل enquire_link بانتظام للإبقاء على الجلسة نشطة.
ما الذي يزوّدك به المزوّد؟
عادةً ما يجهّز المزوّد صلاحية SMPP بنفسه، ولا تتوفر كخدمة ذاتية. أبلغه بالدول المستهدفة، وأسماء المرسلين، وحجم الذروة المتوقع، وعناوين IP العامة التي ستتصل منها.
| البند | ما هو |
|---|---|
| المضيف ومنفذ TLS | العنوان الذي يتصل به عميلك |
| system_id وكلمة المرور | بيانات اعتماد الـ bind، واحفظها كأسرار |
| system_type | يُترك فارغاً عادةً ما لم يحدد المزوّد قيمة له |
| عدد اتصالات bind والإنتاجية | عدد الجلسات المسموح بفتحها والمعدل المتفق عليه لكل bind |
| قائمة IP المسموح بها | لا يمكن الربط إلا من عناوين IP المسجّلة |
فتح الجلسة وتشغيلها
يتيح bind من نوع transceiver الإرسال والاستقبال على جلسة واحدة. ولا تستخدم اتصالَي transmitter وreceiver منفصلين إلا إذا كان عميلك يتطلب ذلك.
- افتح اتصال TLS بالمضيف والمنفذ اللذين حصلت عليهما.
- أرسل bind_transceiver مع system_id وكلمة المرور، وانتظر bind_transceiver_resp بقيمة command_status تساوي 0.
- أرسل كل رسالة عبر submit_sm واحفظ message_id العائد في submit_sm_resp.
- استقبل تقارير التسليم على شكل deliver_sm وردّ على كل واحد منها بـ deliver_sm_resp.
- أرسل enquire_link في فترات الخمول، وأعد الاتصال مع تأخير متزايد (backoff) إذا توقفت الردود.
- أغلق الجلسة بـ unbind وانتظر unbind_resp.
ما حقول submit_sm التي تسبب معظم حالات الرفض؟
- source_addr_ton وsource_addr_npi: القيمتان 5 و0 لاسم مرسل أبجدي رقمي، و1 و1 لرقم دولي.
- destination_addr: رمز الدولة متبوعاً بالرقم، من دون علامة + أو أصفار بادئة.
- data_coding: القيمة 0 لأبجدية GSM-7 الافتراضية، و8 لترميز UCS-2 (العربية والرموز التعبيرية واللغات الأخرى).
- registered_delivery: القيمة 1 لطلب تقرير تسليم.
- يتسع short_message لما يصل إلى 254 أوكتيت؛ وللمحتوى الأطول استخدم message_payload TLV مع sm_length بقيمة 0، ولا تجمع بينهما أبداً.
أخطاء الربط والإرسال الشائعة
تجهّز OmniChannels.ai اتصالات SMPP 3.4 عبر TLS لكل حساب مع إدراج عناوين IP المصدر في القائمة المسموح بها، ويمكن للموزّعين وشركاء الجملة الحصول على اتصالات bind مخصّصة.
| command_status | السبب المرجّح | الحل |
|---|---|---|
| ESME_RBINDFAIL | system_id خاطئ أو عنوان IP غير مدرج في القائمة المسموح بها | تحقق من بيانات الاعتماد وعنوان IP المصدر |
| ESME_RINVPASWD | كلمة مرور خاطئة | تحقق من بيانات الاعتماد |
| ESME_RINVSRCADR | اسم المرسل أو قيم TON/NPI الخاصة به غير صالحة | صحّح اسم المرسل وقيم TON/NPI |
| ESME_RTHROTTLED | الإرسال بمعدل يتجاوز المتفق عليه | خفّف المعدل وأعد المحاولة مع backoff |