عند إرسال الآلاف من الرسائل النصية إلى المغرب، فإن إجابة API (`HTTP 202 Accepted`) تؤكد فقط شيء واحد: تم قبول طلبك على الشبكة.لكن لابد من تفسير **Delivery Reports (DLR)** لتحديد ما إذا كان العميل قد حصل على الرسائل على الهاتف.
يتم إرسال هذه الرسائل المباشرة من قبل العملاء (IAM، Orange، inwi) إلى البوابة، والتي يتم إرسالها إلىك من خلال Webhook.
فهمًا صحيحًا لهذه الحقوق الرابعة أمرًا حيويًا لمراقبة صحة الرسائل الخاصة بك، أو تحديد قاعدة بيانات مفقودة، أو التعامل مع إصابات شبكة العملاء.
4 مقاصد DLR مفيدة بسهولة
1. DELIVERED (الحصول على النجاح) هو حالة النهائي المثالي. ويؤكد بشكل رسمي أن رسالة SMS قد وصلت إلى جهاز الكمبيوتر الخاص بك. المهلة التقنية: تصل هذه الحالة عندما يؤكد المشغل التسليم، وتختلف المدة حسب المشغل وحالة الشبكة (خلال أكتوبر 2026، كان الوسيط حتى هذا التأكيد على مساراتنا المغربية بين 11 و17 ثانية).
2. PENDING (في انتظار إرسال) تم إرسال الرسائل إلى الشركة المحلية، لكنها لم تتمكن حتى الآن من إرسالها إلى الشبكة. لماذا؟ يتم إلغاء الهاتف، في وضع الطائرات، خارج منطقة التغطية، أو يتم إلغاء خزينة الرسائل SMS للعميل. مستمر: ستحافظ الشركة على الرسائل في 'Pending' لفترة محددة (مستمرة، غالباً 24 ساعة أو 48 ساعة).
3. FAILED (الخسارة النهائية) لم يتم إرسال الرسائل، وبدلًا من ذلك، تم إلغاء المحاولة. لماذا؟ لا توجد رقمًا، لا توجد رقمًا غير موجود، أو قد تم إلغاء مدة الحمل، أو تم إلغاء الهاتف بشكل خاص.
4. UNKNOWN / REJECTED (إلغاء العملاء) حصلت العملاء على الطلب ولكنهم رفضوا بشكل واضح إرسالها. لماذا؟ Sender ID لا يسمح في هذه الشبكة، وقد تم تحديد المحتوى بـ SPAM من قبل مسحات الشبكة، أو تم إغلاق الطريق إلى هذا المفتاح مؤقتا.
لماذا تنتظر رسائل SMS طويلة الأمد
من الطبيعي أن تبقى نسبة صغيرة من "Pending" في نهاية الحملة (هواتف مطفأة أو خارج الشبكة).
ومع ذلك، إذا كنت ترى مخزونًا كبيرًا من الرسائل المغلقة في 'Pending' (على سبيل المثال: 40٪ من حملة) على محرر محدد (على سبيل المثال، فقط الأرقام في '0661')، فإنه يشير إلى إصابة شبكة (Throttling) أو نقص SMSC في محرر محدد.
عندما يكون هناك حالة غير معروفة يجب أن تحذر فريقك التقني
إذا كان الوضع "لا يعرف" أو "لا يرفض" هو الأكثر أهمية. إذا كان يظهر بشكل منفصل، فإنه غالباً ما يكون ملحوظاً. إذا كان يواجه حملة كاملة منذ بدء النشاط، تحذير تطبيقاتك على الفور: قد تم إرسال ID Sender الخاص بك إلى القائمة السوداء، أو تم إلغاء حسابك بسبب عدم التوافق.
مثل JSON payload من webhook الحقيقي:```json
{
"event": "message.failed",
"data": {
"id": "msg_8f2da1b2c3d4e5f6a7b8c9d0",
"to": "+212612345678",
"channel": "sms",
"status": "failed",
"error_code": "DLR_REJECTD",
"error_message": "The destination network did not deliver this message and gave no reason."
},
"timestamp": "2026-06-27T10:05:22Z"
}
كيفية تثبيت إصلاحات على الوضع المفقود
تحليل DLR لا يعني سوى إذا كان يهدد العمل التجاري.
- الصحة الأساسية: قم بتحديد نسخة تحدد حالة "الخيانة" (بخط "الرقم غير المخصص") وتخزين هذه الأرقام أو تقييمها كأنها غير فعالة في CRM الخاص بك.
- الإرسال الذكي: إذا كانت رسالة SMS المهمة (OTP) تصل إلى "الخسارة"، قم بإعداد جهازك لتشغيل إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال.
السيطرة على DLR هي الفرق بين التطبيق الذي يوفر "رسائل SMS" و [نظام إشعار قوي] (/fr/api-sms-maroc/) على مستوى الشركات.
الأسئلة الشائعة
كيف تتابع التوجيه على شبكات IAM وInwi وOrange؟
تُرسل مساراتنا المحلية نحو اتصالات المغرب (IAM) وأورنج وإنوي، مع تحويل تلقائي بين المسارات، حالة التسليم من المشغل لكل رسالة عبر webhook. ويتوقف زمن التسليم على مشغل المستلم وشبكته.
كيف تدير المنصة تنسيق الأرقام المغربية؟
يقوم EnvoiSMS تلقائيًا بتسوية الأرقام المدخلة (06..., 07..., 00212...) إلى معيار E.164 (+212) لتجنب أي فشل في التسليم.