التحقق عبر SMS في تونس (+216): قائمة فحص للمطوّرين

ما الذي يجب أن تتضمنه قائمة الفحص قبل طلب رقم +216؟

اجتز هذه القائمة مرة واحدة وستسير معظم تشغيلات الاختبار في تونس بسلاسة:

• مفتاح API جاهز. أنشئ مفتاح Bearer في وحدة المطوّرين؛ تبدأ المفاتيح الحية بـ or_live_.
• محفظة ممولة. يسحب OTP Gateway من رصيدك المسبق الدفع بالدولار؛ ويؤكد GET /api/v1/balance ذلك من سكربت.
• webhook يمكن الوصول إليه. سجّل نقطة HTTPS، واحفظ سرّها، وتأكد أن ساعة خادمك دقيقة كي تنجح فحوص الطابع الزمني.
• السعر مفحوص. استدعِ GET /api/v1/prices?country=tn&service=<id> للخدمة التي تنوي اختبارها بالضبط.
• حقل الهاتف مختبَر. تأكد أن نموذجك يقبل رقمًا وطنيًا تونسيًا من ثماني خانات ورقمًا دوليًا ملصوقًا بـ +216.
• محلّل متسامح. تأكد أن استخراج الرمز يعمل مع نصوص الرسائل بالعربية والفرنسية والإنجليزية (انظر أدناه).
• الشروط مراجَعة. أنت تختبر منتجك أو تشغّل حسابك المشروع، وفق قواعد الخدمة وسياسة الاستخدام المقبول لدى OTP Route.

كيف تُنسَّق الأرقام التونسية بصيغة E.164؟

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

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

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

تنتقل الرسائل العربية بصيغة SMS بترميز Unicode وقد تحتوي على علامات اتجاه من اليمين إلى اليسار حول الأرقام. والتعبير النمطي الذي يلتقط أول سلسلة من أربع إلى ثماني خانات ASCII، بعد إزالة العلامات غير المرئية، ينجو مع اللغات الثلاث. وتضيف الفرق تونس إلى مصفوفتها عادةً لإطلاقات شمال أفريقيا الناطقة بالفرنسية إلى جانب المغرب والجزائر، ولاختبار جودة التعريب لتخطيطات اليمين إلى اليسار، أو لأنها تخدم عملاء تونسيين يعيشون في أوروبا؛ ويغطي رقم +216 للاختبار كل تلك الحالات.

خطوة بخطوة: استقبال رمز OTP تونسي عبر API

تعرض اللقطة الحية أكثر من 1,700 خدمة لتونس، منها Facebook وWhatsApp وInstagram وTelegram وTikTok وGoogle (Gmail & YouTube) وSnapchat وSignal وLinkedIn وDiscord وChatGPT (OpenAI) وMicrosoft & Outlook وAmazon وUber. يتغير التوفر خلال اليوم، فدع منطق OTP routing لديك يقرؤه من GET /api/v1/services وGET /api/v1/countries عند بدء التشغيل.

1. أرسل POST /api/v1/activations مع {"service": "facebook", "country": "tn"} واحفظ معرّف التفعيل.
2. اكتب الرقم المُعاد في التطبيق الذي تختبره وأطلق الرمز.
3. عالج activation.sms_received على webhook لديك: تحقق من X-OTPRoute-Signature (HMAC-SHA256 للطابع الزمني ثم نقطة ثم الجسم الخام)، وارفض الطوابع الزمنية القديمة، وتجاهل التكرارات لمعرّف تفعيل عالجته سابقًا.
4. وبلا webhook، استعلم دوريًا من GET /api/v1/activations/{id}، مع البقاء دون حد 300 طلب في الدقيقة بمسافة كافية.
5. استدعِ POST /api/v1/activations/{id}/cancel إن أُجهض الاختبار.

تسرد وثائق API كل حقل، ويوضح دليل اختبار CI كيف تربط ذلك بخط معالجة.

خطوة بخطوة من لوحة التحكم

1. أنشئ حسابًا ببريدك الإلكتروني ورمز من ست خانات، أو بتسجيل الدخول عبر Google، وفعّل مصادقة TOTP الثنائية.
2. أضف رصيدًا بالبطاقة أو بعملات USDT/USDC.
3. اختر تونس، ثم الخدمة، وتحقق من السعر المعروض.
4. اطلب، وانسخ رقم +216، واطلب الرمز في التطبيق المستهدف.
5. انسخ الرمز التونسي من لوحة التحكم فور ظهوره وأكمل التسجيل الذي تختبره.

استكشاف الأخطاء: ماذا لو لم يظهر رمز +216 أبدًا؟

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

• لم يصل شيء إطلاقًا: دع النافذة تنتهي، ثم أعد المحاولة لاحقًا أو عبر مسار خدمة آخر إن سمح الاختبار.
• رفضت الخدمة الرقم: بعض الخدمات ترفض الأرقام الافتراضية؛ والاسترداد يغطي هذه الحالة.
• webhook صامت لكن اللوحة تُظهر الرمز: غالبًا يفشل فحص التوقيع لديك؛ قارن مع الجسم الخام لا JSON أُعيد تسلسله، وتحقق من انحراف الساعة.
• إخفاقات متتالية: أضف تراجعًا بين المحاولات؛ فإعادة الطلب في حلقة متلاحقة نادرًا ما تفيد.

الخطوط طويلة الأمد والفوترة وsandbox لتونس

لا يوجد رقم تونسي طويل الأمد بالخدمة الذاتية. الأرقام المخصصة منتج للولايات المتحدة وكندا بسعر يبدأ من $1.95/month؛ وإن احتجت خط +216 دائمًا فراسل [email protected]، مع العلم أن التوفر يعتمد على القواعد المحلية.

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

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

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

نعم. استخدم رقم +216 من OTP Gateway واجمع الرمز في لوحة التحكم أو عبر واجهة التحقق عبر SMS وwebhooks.

هل للأرقام التونسية بادئة خط يجب حذفها؟

لا. الأرقام التونسية ثماني خانات بلا بادئة خط، فصيغة E.164 هي +216 مع تلك الخانات فقط.

ما معرّف الدولة لواجهة OTP لتونس؟

استخدم tn في استعلام الأسعار وفي جسم طلب POST /api/v1/activations.

كم يكلّف رقم التحقق في تونس؟

من $0.20 للرمز؛ ويعتمد المبلغ الدقيق على الخدمة ويظهر في لوحة التحكم ونقطة الأسعار قبل أن تطلب. انظر الأسعار.

يفشل محلّلي مع رسائل OTP العربية. ماذا أغيّر؟

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

هل أستطيع الاحتفاظ برقم +216 لتسجيلات دخول لاحقة؟

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

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