توجيه رموز التحقق من جمهورية الكونغو (+242) إلى بيئة اختبارك

ما استدعاءات API التي تجلب رمز +242 من البداية إلى النهاية؟

كل شيء تحت https://otproute.com/api/v1 ويُوثَّق بمفتاح Bearer يبدأ بـor_live_. أنشئ المفاتيح في وحدة تحكم المطورين؛ ويستطيع الحساب حمل ما يصل إلى 10 منها، مما يسهّل منح بيئة staging وCI وحاسوب زميل بيانات اعتماد منفصلة يمكن إلغاء كل منها باستقلال.

وهكذا يسير تشغيل اختبار نموذجي لسوق برازافيل:

1. اجلب GET /api/v1/services وGET /api/v1/countries واحفظ المعرّفات مؤقتًا. جمهورية الكونغو هي cg (ولا تخلطها بجارتها الأكبر التي لها معرّفها وصفحتها الخاصة في الكونغو (DRC)).
2. اسأل GET /api/v1/prices?country=cg&service=<id> عن السعر الحي وتوفر التطبيق الذي تختبره.
3. أنشئ التفعيل عبر POST /api/v1/activations بجسم مثل {"service": "telegram", "country": "cg"}. تحصل على معرّف تفعيل ورقم +242.
4. اكتب ذلك الرقم في شاشة التسجيل أو الدخول الخاصة بمنتجك.
5. التقط الرمز الكونغولي من webhook أو بالاستعلام عن GET /api/v1/activations/{id}. وإذا توقف الاختبار فحرّره عبر POST /api/v1/activations/{id}/cancel.

نفّذ GET /api/v1/balance قبل بدء المجموعة ليفشل المهمة مبكرًا إن كانت المحفظة فارغة بدلًا من منتصف التشغيل. ويترك حد 300 طلب في الدقيقة هامشًا واسعًا لبضعة عمال متوازين. وأشكال الطلبات والاستجابات الكاملة في وثائق المطورين.

كيف أربط webhook موقّعًا لتفعيلات الكونغو؟

الاستعلام الدوري مناسب لمهندس واحد يتنقل في مسار ما؛ أما webhook فأرفق بأسطول CI. أضف نقطة نهاية في وحدة تحكم المطورين (يُسمح بخمس لكل حساب) واشترك في activation.sms_received وactivation.expired وactivation.cancelled.

يحمل كل طلب X-OTPRoute-Signature: t=<unix>,v1=<hex>. أعد بناء HMAC-SHA256 للقيمة "<t>.<raw body>" بسر نقطة النهاية تلك، وقارنه بـv1 بفحص زمن ثابت، وتجاهل أي طلب طابعه الزمني قديم. احسب التجزئة على البايتات الخام قبل أي تحليل JSON، لأن JSON المعاد تسلسله نادرًا ما يتطابق بايتًا ببايت.

تعامل مع الأحداث على أنها مرتبطة بمعرّف التفعيل. وإذا وصل الحدث نفسه مرتين فينبغي أن يلاحظ معالجك أن المعرّف سبق حسمه وأن يعيد حالة نجاح ببساطة. ويستعرض دليل التقاط webhook أنماط الطوابير التي تمنع مشغّلات الاختبار البطيئة من تجاوز المهلة.

ما الخدمات التي يغطيها رقم تحقق الكونغو؟

تتضمن لقطة اليوم لـcg الخدمات WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وX (Twitter) وChatGPT (OpenAI) وClaude وMicrosoft & Outlook وLinkedIn وSignal وViber وimo. ويضم البلد في المجمل أكثر من 1,000 خدمة على OTP Gateway.

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

كيف تُخزَّن أرقام +242 وتُوحَّد؟

تتكوّن أرقام جمهورية الكونغو من تسعة أرقام بعد رمز الدولة، وعلى خلاف كثير من خطط الترقيم فإن الصفر الأول جزء من رقم المشترك لا بادئة محلية. وتُكتب خطوط الجوال عادةً 06… أو 05… محليًا و+242 06… دوليًا. وأي دالة توحيد منسوخة من قاعدة شيفرة أوروبية تحذف أي صفر أول ستفسد هذه الأرقام بصمت، لذا خزّن بالضبط سلسلة E.164 التي يعيدها API وتحقق من الطول لكل دولة بدلًا من قاعدة عامة واحدة.

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

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

ماذا لو لم يصل أي رمز إلى الرقم +242؟

الصمت عادةً مشكلة في المسار أو القبول لا خطأ في التكامل. وهذه خطة معقولة:

• دع نافذة الـ20 دقيقة تنتهي قبل أن تستنتج شيئًا؛ فبعض المرسلين يجمّعون حركتهم الصادرة.
• تأكد من أن الخدمة المستهدفة تقبل الأرقام الافتراضية. فعدة خدمات لا تقبلها، ولهذا بالذات لا يكلّفك الرمز غير المستلم شيئًا.
• أعد المحاولة لاحقًا أو انتقل إلى مسار خدمة آخر، بدلًا من إطلاق طلبات جديدة في حلقة سريعة تستنزف حد الطلبات.
• ألغِ الأرقام التي لم تعد بحاجة إليها ليعود المبلغ فورًا بدلًا من انتظار الانتهاء.

ويتناول مقالنا عن تقليل إخفاقات تسليم OTP التراجع الأسي وميزانيات إعادة المحاولة بمزيد من العمق.

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

لا يوجد رقم طويل الأمد بالخدمة الذاتية لجمهورية الكونغو. يصدر OTP Gateway رقمًا واحدًا لكل رمز تحقق، وهذا هو المنتج الوحيد المعروض لـcg حاليًا.

أما الأرقام الافتراضية المخصصة لدى OTP Route فهي منتج للولايات المتحدة وكندا بدءًا من $1.95/month، مع الرسائل الواردة والصادرة والاتصال من المتصفح. وإن كان فريقك يحتاج فعلًا إلى خط كونغولي دائم فراسل [email protected]؛ وإمكانية ترتيب أي شيء تعتمد على القواعد المحلية، فاعتبرها سؤالًا لا وعدًا. وتُلخَّص المفاضلات في الأرقام المؤقتة مقابل المخصصة.

كيف تُفوتَر إعدادات توجيه OTP للكونغو وكيف تُختبر بأمان؟

تعمل الفوترة من محفظة واحدة مدفوعة مسبقًا بالدولار الأمريكي، بلا اشتراك ولا مستويات باقات. عبّئها بالبطاقة أو بعملات USDT/USDC المستقرة، وتنتج كل عملية تعبئة فاتورة PDF بالبريد لفريقك المالي.

قبل أن تربط أموالًا حقيقية بخط الإنتاج، اطلب من الدعم تحويل حساب التطوير إلى وضع sandbox. فهو يعيد أرقامًا ورموزًا محاكاة، فتجرّب مسار SMS verification API كاملًا دون إنفاق شيء. واستخدم OTP Route على منتجاتك الخاصة والحسابات المخوّل لك تشغيلها فقط؛ فشروط كل خدمة وسياسة الاستخدام المقبول لدينا سارية. وراجع الأسعار لمعرفة كيف تظهر الرسوم والمبالغ المستردة في المحفظة.

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

ما معرّف دولة جمهورية الكونغو في API الخاص بـ OTP Route؟

هو cg. جمهورية الكونغو الديمقراطية بلد مستقل له معرّفه الخاص، فتأكد من أي منهما يشير إليه إعدادك.

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

نعم. اطلب رقم +242 للاختبار من OTP Gateway، وأدخله في تطبيقك، واقرأ الرمز في لوحة التحكم أو عبر API.

هل أحذف الصفر الأول عند حفظ رقم +242؟

لا. في جمهورية الكونغو ينتمي الصفر إلى رقم المشترك المكوّن من تسعة أرقام، فاحتفظ بقيمة E.164 تمامًا كما يعيدها API.

بأي لغة ستصل رسائل التحقق الكونغولية؟

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

هل أُحاسَب إذا لم يظهر الرمز؟

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

كم تبلغ تكلفة استقبال SMS OTP من الكونغو؟

من $0.20 للرمز؛ ويُعرض سعر +242 لكل تطبيق حيًّا، فاستعلم عنه قبل الطلب.

هل يوجد sandbox لبناء التكامل؟

نعم، عند الطلب. يستطيع الدعم وضع حساب التطوير في وضع sandbox، فيعيد أرقامًا ورموزًا محاكاة دون المساس برصيد المحفظة.

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