لماذا تفشل رسائلي النصية القصيرة في السعودية؟.

لم يتم تسجيل معرّف المُرسِل لدى CST

تُلزم هيئة الاتصالات والفضاء والتقنية (CST، المعروفة سابقًا باسم CITC)، وهي الجهة المنظمة لخدمات الاتصالات في المملكة العربية السعودية، بتسجيل جميع معرّفات مُرسلي الرسائل من التطبيقات إلى الأشخاص (A2P)، ولا تُقدّم شركات الاتصالات السعودية (STC) وموبايلي وزين السعودية خدماتها إلا بناءً على هذا التسجيل. يُؤدي عدم تسجيل معرّف المُرسِل إلى ظهور خطأ HTTP06 (معرّف مُرسِل غير صالح) أو يتم رفض الرسالة من قِبل الشبكة. تتولى BroadNet عملية التسجيل لدى CST، لذا أرسل فقط باستخدام معرّف المُرسِل المُعتمد في المعامل sid. أسماء المعاملات (sid وmno وtype) ورموز الأخطاء HTTPxx في هذه الصفحة خاصة بواجهة HTTP القديمة (/websmpp)؛ أما في واجهة REST API المعتمدة على Bearer (POST /sms/sendSms) فالمقابلات هي senderId وdestinationNumber وmessageType (القيمة UNICODE للعربية).

• تشترط CST (سابقًا CITC) تسجيل معرّفات مُرسِلي A2P.
• لا تُسلِّم STC وموبايلي وزين السعودية إلا عبر المسارات المسجلة.
• غير مسجل ← HTTP06 أو إسقاط الرسالة من الشبكة.
• أرسل باستخدام معرّف المُرسِل المعتمد من CST في sid.

محتوى تسويقي وساعات هادئة

تفصل المملكة العربية السعودية بين حركة الرسائل الخاصة بالمعاملات وحركة الرسائل الترويجية، وتقصر التسويق على ساعات النهار المسموح بها، حيث تتطلب الرسائل الترويجية عادةً معرّف مُرسِل مُسجّلًا مُختلفًا، مع مراعاة خيار إلغاء الاشتراك. ويمكن تصفية الرسائل الترويجية المُرسلة باستخدام معرّف مُرسِل خاص بالمعاملات، أو خارج ساعات العمل المسموح بها. لذا، اجعل حركة الرسائل الخاصة بالمعاملات إعلامية بحتة، وأرسل التسويق فقط إلى قائمة مشتركين وافقوا مسبقًا (opt-in)، واستخدم معرّف المُرسِل الصحيح لكل نوع من أنواع حركة الرسائل.

• يتم التعامل مع المعاملات والتسويق بشكل منفصل.
• يقتصر التسويق على ساعات النهار المسموح بها.
• تحتاج حركة الرسائل الترويجية إلى معرّف مُرسِل مستقل بالإضافة إلى خيار إلغاء الاشتراك.
• لا ترسل محتوى ترويجياً باستخدام معرّف مُرسِل خاص بالمعاملات.

تنسيق الأرقام والترميز العربي

أدخل أرقام الوجهة في mno كرمز الدولة 966 متبوعًا بالرقم الوطني، أرقامًا فقط، مع حذف أي أصفار أو علامات زائد أو 00 في البداية - وإلا ستتلقى خطأ HTTP09 (عنوان وجهة غير صالح). بالنسبة للمحتوى العربي، استخدم type=4 (70 حرفًا لكل مقطع) أو type=2 لليونيكود؛ type=1 يُفسد المحتوى العربي. أرسل المحتوى بترميز UTF-8 وبترميز URL.

• التنسيق: 966 + الرقم الوطني، أرقام فقط (على سبيل المثال 9665XXXXXXXX).
• أرقام غير صحيحة ← HTTP09.
• العربية: type=4 (70 حرفًا)؛ Unicode: ‏type=2؛ لا تستخدم type=1 أبدًا للعربية.
• يجب أن يكون نص الرسالة بترميز UTF-8 وبترميز URL.

تأكيد التسليم والرصيد

تحقق من إيصال التسليم (DLR) قبل افتراض نجاح العملية: تحقق من حالة التسليم (DELIVRD) مقابل حالة عدم التسليم (UNDELIV)، باستخدام معرف الرسالة (MessageId) أو معرف الدفعة (BatchId)، عبر خطاف الويب (webhook) الخاص بك أو بسحب الحالة (واجهة HTTP القديمة: /websmpp/websmsstatus). إذا فشلت عملية نقل دفعة كاملة، فتحقق من الرصيد - يشير HTTP18 إلى عدم كفاية الرصيد - وتأكد من اعتماد المسار ومعرّف المُرسِل في المملكة العربية السعودية.

• اقرأ حالة DLR ‏(DELIVRD / UNDELIV).
• اسحب الحالة عند الطلب (واجهة HTTP القديمة: /websmpp/websmsstatus) إذا لم يتم إعداد خطافات الويب.
• قد يكون سبب فشل الدفعة بأكملها هو HTTP18 (عدم كفاية الرصيد).
• أعد التأكد من أن معرّف المُرسِل معتمد من قبل CST للمملكة العربية السعودية.

وثائق ذات صلة

تابع إلى الخطوة المنطقية التالية.