اختبار رموز التسجيل المقدونية (+389) قبل الإطلاق

قائمة الإطلاق تقول «تحقق من التسجيل بأرقام +389»: من أين يبدأ فريق الجودة؟

موقف مألوف: المنتج يتوسع نحو غرب البلقان، ومسار التسجيل يتعامل أصلًا مع عشرات الأسواق، ويجب على أحدهم أن يثبت أنه يقبل الأرقام المقدونية وأن رسالة SMS التي يرسلها تطبيقك تصل فعلًا. استعارة هاتف زميل لا تتسع للتوسع، والشريحة المحلية يصعب إبقاؤها داخل مشغّل CI.

يزيل OTP Gateway هذا الاعتماد. تطلب رقم تحقق لمقدونيا الشمالية عبر API أو لوحة التحكم، وتدخله في مسارك الخاص، وتجمع أي رمز يصل. يخدم كل رقم عملية تحقق واحدة، فتستطيع مجموعة الانحدار طلب رقم +389 جديد للاختبار في كل تشغيل. يوضح نظرة عامة على اختبار الجودة كيف تدمج الفرق ذلك في عملية الإصدار.

كيف تُكتب أرقام +389، وما الذي ينبغي أن يقبله المدقّق لديك؟

رمز الدولة لمقدونيا الشمالية هو +389 وبادئة الاتصال الوطني هي 0. تُكتب أرقام الجوال محليًا بالشكل 07X XXX XXX؛ وعالميًا يختفي الصفر فيصبح +389 7X XXX XXX برقم وطني من ثمانية أرقام. احفظ صيغة E.164 (+3897…) وتعامل مع الصيغة المحلية كتنسيق إدخال فقط.

حالات اختبار تستحق البقاء في المجموعة:

• مستخدم يختار +389 ويكتب الصفر مع ذلك؛ ينبغي أن يحذفه النموذج بدل رفض الإدخال.
• الأرقام الملصوقة التي تحتوي على مسافات أو خطوط مائلة أو شرطات يجب أن تُوحَّد في قيمة مخزّنة واحدة.
• فحوص النطاق مكانها مكتبة أرقام هواتف مُصانة، لا بادئات مكتوبة يدويًا في الشيفرة، لأن نطاقات المشغّلين تتغير مع الوقت.

لماذا تستحق قوالب SMS بالحروف السيريلية اختبارًا خاصًا؟

المقدونية هي اللغة الرسمية في البلد كله وتُكتب بالحروف السيريلية؛ وللألبانية أيضًا وضع رسمي وهي واسعة الانتشار. إذا أرسل تطبيقك رسالة التحقق بالمقدونية، فإن الحروف السيريلية تفرض ترميز UCS-2 الذي يقلّص الرسالة الواحدة من 160 حرفًا إلى 70. قد ينقسم قالب يتسع بسهولة بالإنجليزية إلى عدة أجزاء، أو يُقطع إذا كان المُرسِل يحدّد الطول.

استلام الرسالة الحقيقية على رقم +389 يريك ما سيراه المستخدم: هل يظهر الرمز مبكرًا بما يكفي لقراءته في معاينة الإشعار، وهل يعمل بديل بالحروف اللاتينية، وهل ما زالت تلميحات الإكمال التلقائي تعمل. ينبغي أن يطابق المحلّل لديك الأرقام لا عبارة ثابتة، لأن الخدمات الخارجية تختار صياغتها ولغتها.

ما الاستدعاءات التي تجلب رقمًا لمقدونيا الشمالية برمجيًا؟

تغطي وثائق المطورين كل حقل؛ أما مخطط واجهة التحقق عبر SMS هذه فقصير. صادِق بمفتاح Bearer يبدأ بـ or_live_ على https://otproute.com/api/v1، ثم:

1. حمّل قائمة الدول بـ GET /api/v1/countries؛ ومعرّف مقدونيا الشمالية هو mk.
2. اسأل GET /api/v1/prices?country=mk&service=<id> عن السعر المباشر والتوفر.
3. أنشئ التفعيل بـ POST /api/v1/activations مع جسم مثل {"service": "viber", "country": "mk"}.
4. استعلم عن GET /api/v1/activations/{id}، أو انتظر activation.sms_received على webhook.
5. ألغِ عبر POST /api/v1/activations/{id}/cancel عندما ينتهي الاختبار مبكرًا.

تحمل طلبات webhook الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>. أعد بناء HMAC-SHA256 على "<t>.<raw body>" بسر نقطة النهاية، وقارن بزمن ثابت، وارفض الطوابع الزمنية القديمة، واربط المعالجة بمعرّف التفعيل ليكون إعادة التسليم غير ضارة. يحصل كل حساب على ما يصل إلى 10 مفاتيح و5 نقاط نهاية webhook و300 طلب في الدقيقة.

ما الخدمات المفتوحة على مسار +389 الآن؟

تتوفر لمقدونيا الشمالية حاليًا أكثر من 900 خدمة على OTP Gateway. تضم اللقطة المباشرة Viber وWhatsApp وFacebook وInstagram وTelegram وGoogle (Gmail & YouTube) وTikTok وMicrosoft & Outlook وSignal وLinkedIn وUber وChatGPT (OpenAI).

ليست كل خدمة مفتوحة في كل ساعة؛ وهذا طبيعي في مخزون SMS، وهو سبب تقديم الأسعار والتوفر عبر API. يستطيع الزملاء الذين لا يكتبون شيفرة تنفيذ الخطوات نفسها في لوحة التحكم: أنشئ حسابًا، واشحن الرصيد، واختر مقدونيا الشمالية والخدمة، ثم يظهر الرمز في صفحة التفعيل عند وصوله.

لم يصل الرمز: ماذا الآن؟

يستمر كل تفعيل 20 دقيقة، ولا تدفع إلا إذا وصلت الرسالة. إذا ألغيته أو تركت النافذة تنتهي فارغة يعود المبلغ كاملًا إلى المحفظة تلقائيًا.

قبل أن تطلب مجددًا:

• انتظر انتهاء النافذة؛ فبطء المُرسِل أكثر شيوعًا بكثير من ضياع الرسالة.
• تأكد من أن الخدمة تقبل الأرقام الافتراضية؛ فبعضها يرفضها بحكم السياسة، وهذا بالضبط ما يغطيه الاسترداد.
• أعد المحاولة لاحقًا أو عبر مسار خدمة آخر.
• ضع فاصلًا بين المحاولات حتى لا يطلق اختبار غير مستقر طلبًا بعد طلب على مسار +389.

يشرح دليل توجيه الدول كيف تخطط للبدائل عبر الأسواق. اقصر الاستخدام على منتجاتك وحساباتك، واحترم شروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route سارية.

ماذا عن خط مقدوني دائم والفوترة وبيئة sandbox؟

لا يقدّم OTP Route رقمًا طويل الأمد بالخدمة الذاتية في مقدونيا الشمالية. الأرقام المخصصة (Dedicated Numbers) منتج للولايات المتحدة وكندا، تُباع فورًا بدءًا من $1.95/month؛ وللحصول على خط +389 دائم راسل [email protected] وسيخبرك الفريق ما إذا كانت اللوائح المحلية تسمح بذلك، دون وعد بالتوفر.

الدفع بنظام الاستخدام الفعلي من محفظة USD مسبقة الدفع تُشحن بالبطاقة أو USDT/USDC، دون رسوم شهرية، مع فاتورة PDF عن كل عملية شحن. يمكن نقل حسابات التطوير إلى sandbox عند الطلب لتعمل التكاملات على أرقام ورموز محاكاة.

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

هل أستطيع فحص رسالة تسجيل تطبيقي المقدونية دون بطاقة SIM؟

نعم. اطلب رقم OTP Gateway بالدولة mk، واستخدمه في شاشة التسجيل الخاصة بك، واقرأ الرسالة في لوحة التحكم أو من webhook.

كم يكلف رمز تحقق على +389؟

من $0.20 لكل رمز؛ ويتوقف المبلغ الدقيق على الخدمة ويظهر في لوحة التحكم أو يُعاد من GET /api/v1/prices. وعندما تنتهي نافذة الـ 20 دقيقة دون SMS يعود إليك المبلغ كاملًا.

هل ستكون رسائل التحقق إلى أرقام مقدونيا الشمالية بالحروف السيريلية؟

يتوقف ذلك على المُرسِل. يتحكم تطبيقك بقالبه، بينما تختار الخدمات الخارجية اللغة من إعدادات الحساب أو الجهاز، لذا حلّل الأرقام فقط.

هل تحتفظ قاعدة بياناتي بالصفر البادئ في أرقام الجوال المقدونية؟

احتفظ بصيغة E.164 بدلًا من ذلك: +389 يليه الرقم الوطني من ثمانية أرقام، دون صفر بادئ ودون مسافات.

هل أستطيع الاحتفاظ برقم مقدونيا الشمالية لعمليات دخول متكررة؟

ليس بالخدمة الذاتية. الأرقام المخصصة طويلة الأمد متاحة للولايات المتحدة وكندا فقط؛ أما +389 فراسل الدعم، وتتوقف الإجابة على اللوائح المحلية.

هل توجد طريقة لتشغيل CI على مقدونيا الشمالية دون إنفاق رصيد؟

اطلب sandbox لحساب تطوير. فهو يحاكي الأرقام والرموز ليعمل التكامل كله من البداية إلى النهاية دون خصم من المحفظة.

لماذا قد ترفض خدمة رقم +389 الخاص بي؟

بعض المنصات ترفض الأرقام الافتراضية. عندها ينتهي التفعيل أو يمكن إلغاؤه، ويعود المبلغ إلى محفظتك تلقائيًا.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.