خبرة technical

اختبار تدمير SMS Sandbox في المغرب قبل الانتهاء من إنتاج

اختبار SMS sandbox قبل الإنتاج: دليل تقني مع أمثلة الكود للمطورين في المغرب.

اختبار تدمير SMS Sandbox في المغرب قبل الانتهاء من إنتاج
محتويات هذا المقال
  1. يستغرق اتصال API الرسائل البريدية SendSMS إلى أندرويد الخاص بك أقل من 10 دقائق، ولكن إذا اتصلت بالاتحاد مباشرة إلى قاعدة البيانات الإنتاجية الخاصة بك وتشغيل الملفات، فإنك تتعرض إلى اثنين من الكوارث:
  2. لماذا تغير تجربة Sandbox
  3. ما يجب أن يصف بيئة اختبار جيدة
  4. Checklist (Go / No-Go) قبل التحول إلى الإنتاج
  5. الأخطاء الشائعة التي تلاحظها في وقت الانتظار

يستغرق اتصال API الرسائل البريدية SendSMS إلى أندرويد الخاص بك أقل من 10 دقائق، ولكن إذا اتصلت بالاتحاد مباشرة إلى قاعدة البيانات الإنتاجية الخاصة بك وتشغيل الملفات، فإنك تتعرض إلى اثنين من الكوارث:

  1. يمكنك إزالة معدل الائتمان الخاص بك بالكامل بسبب زاوية لا نهاية لها في رمزك.
  2. يمكنك إرسال رسائل SMS اختبارية ("تقييم سلام 123") إلى مئات العملاء الحقيقيين المغاربة في 3 صباحًا.

هذا هو السبب في أن جميع التكاملات التجارية تتطلب عبور البيئة Sandbox (Sandbox). هنا كيفية تخصيص وتثبيت الظروف الحقيقية شبكات الاتصالات المغربية دون إرسال رسائل SMS الحقيقية.

لماذا تغير تجربة Sandbox

إن بيئة اختبار جيدة لا تقتصر على إرسال HTTP 200 OK. الهدف هو التأكد من أن تطبيقاتك (CRM، Laravel، Node.js) تتفاعل بشكل صحيح مع الأحداث المزمنة (الرسائل الإرسالية أو Webhooks DLR) (/fr/blog/webhook-de-status-de-delivery-sms-who-ne-start-no-guide/) .

في وضع Sandbox على إرسالSMS: - الهاتف الذكي الخاص بك هو مجاني (لا يتم تخصيص معدل الائتمان). - لا يتم نقل رسائل SMS أبدا إلى الشبكات الحقيقية (IAM، Orange، inwi) ، مما يمنع الاتصال غير المرغوب فيه إلى المستخدمين الحقيقيين. - يمكنك تثبيت حالات DLR المختلفة (/fr/blog/dlr-pending-delivered-failed-unknown-which-means-true-these/) (Delivered، Rejected، Failed) باستخدام أرقام اختبار محددة (Magic Numbers).

ما يجب أن يصف بيئة اختبار جيدة

للحصول على شهادة رمزك قبل تطويرها على الموردين المغربيين، استخدم "العددات السحرية" (Magic Numbers) في API التحقق من كلفة اختبارك للضغط على الشبكة من أجل إنتاج سيناريوات أخطاء:

  • اختبار النجاح (مثل الحالة المحددة): استخدم رقم +212600000001. سوف يرسّخ API لك HTTP 200 وبدء الاتصال Webhook على الفور مع الوضع Delivered.
  • اختبار إلغاء الشبكة: استخدم رقم +212600000002. سيحاول Sandbox التعبير عن إلغاء العملاء (على سبيل المثال: Sender ID banned) و سيحصل Webhook على 'Rejected' مع رمز خطأ تجاري.
  • اختبار الخطأ المأساوي: استخدم رقم +212600000003. سيحاول Sandbox تثبيت رقم لم يعد موجوداً على Maroc Telecom ، مما يجعلك تثبيتاً على شبكة الإنترنت Failed. يجب أن يكتشف سكوتك إدارة قاعدة البيانات هذا الوضع وتحديد الاتصال تلقائياً.

Checklist (Go / No-Go) قبل التحول إلى الإنتاج

لا بد من استبدال "TEST_API_KEY" مع "LIVE_API_KEY" قبل أن تحدد هذه النقطة:

  1. [ ] إزالة الأرقام (E.164): هل تحاول أندرويدك إدخال جميع المكونات المحلية التي تم إدخالها من قبل المستخدمين (0661123456، 07 14 56...) إلى المعايير الدولية +212661123456؟
  2. [ ] التحقق من طول (كود) : هل كنت تحقق من أن رسائل SMS في اللغة العربية (UCS-2) لا تتجاوز الحد الأقصى من الميزات 70 ، على الرغم من أنها تخصيصاً على مجموعة متنوعة من الأجزاء؟
  3. [ ] أمن Webhooks: هل يتم التحقق من تسجيل HMAC-SHA256 (X-EnvoiSMS-Signature) من قبل المورد الخاص بك لتأكد من أن الأحداث DLR التي تلقىها تأتي من خادمنا وليس من القراصنة؟
  4. [ ] Sender ID متوافق: هل بدأت ممارسة القائمة الضوئية الصوتية من Sender ID الخاص بك مع الفريق المساعدة؟ في الإنتاج، لن يتم إلغاء Sender ID غير مؤهل من قبل العملاء المغاربة.

الأخطاء الشائعة التي تلاحظها في وقت الانتظار

في كثير من الأحيان، يمكنك إرسال 3 رسائل إلكترونية عبر الإنترنت من Sandbox إلى الإنتاج. في عملية الإنتاج، سوف تحاول وظيفة CRON إرسال 10،000 رسالة إلكترونية في ثانية واحدة. سوف تحاول إرسال رسالة إلكترونية في ثانية واحدة. سوف تحاول إرسال رسالة إلكترونية في ثانية واحدة. سوف تحاول إرسال رسالة إلكترونية عبر الإنترنت في ثانية واحدة.

تأكد من أن تصميم الإنتاج الخاص بك يحتوي على صندوق الانتظار (Redis / Queue) التي تسمح للرسائل الكبيرة ببطء مستمر (على سبيل المثال 20 إلى 50 SMS في الثانية).

لماذا تختار EnvoiSMS لشركتك؟

التوصيل نحو المشغلين

مسارات محلية نحو اتصالات المغرب وأورنج وإنوي، مع تحويل تلقائي بين المسارات وإرسال حالة التسليم عبر webhook.

تحسين الميزانية

واجهة برمجة تطبيقات WhatsApp Business ابتداءً من 0.65 درهم لكل رسالة. أفضل عائد على الاستثمار.

سيادة البيانات (CNDP)

استضافة ومعالجة متوافقة تماماً مع لوائح حماية المعطيات ذات الطابع الشخصي CNDP.

ما هو زمن الوصول للتوجيه على شبكات IAM وInwi وOrange؟
نستخدم مسارات محلية نحو اتصالات المغرب (IAM) وأورنج وإنوي، مع تحويل تلقائي بين المسارات. الوسيط الزمني حتى تأكيد المشغّل: 46–58 ثانية (مقاس خلال شتنبر 2026).
كيف تدير المنصة تنسيق الأرقام المغربية؟
يقوم EnvoiSMS تلقائيًا بتسوية الأرقام المدخلة (06..., 07..., 00212...) إلى معيار E.164 (+212) لتجنب فشل التسليم الناتج عن صيغة الرقم.

مقالات مقترحة

تنسيق الرسائل القصيرة في المغرب: فواصل الأسطر، تشفير GSM-7 مقابل UCS-2 وتحسين التكلفة
technical

تنسيق الرسائل القصيرة في المغرب: فواصل الأسطر، تشفير GSM-7 مقابل UCS-2 وتحسين التكلفة

تنسيق واتساب للأعمال في المغرب: نص معزز ورموز تعبيرية وأزرار تفاعلية
technical

تنسيق واتساب للأعمال في المغرب: نص معزز ورموز تعبيرية وأزرار تفاعلية

التحقق عبر واتساب بنقرة واحدة وتعبئة تلقائية One-Tap Autofill OTP في المغرب
technical

التحقق عبر واتساب بنقرة واحدة وتعبئة تلقائية One-Tap Autofill OTP في المغرب