إدخال رموز التحقق التشادية (+235) في منظومتك

ما تسلسل الاستدعاءات في طلب OTP API لتشاد؟

تصل طلبات تشاد إلى عنوان الأساس نفسه الذي تستخدمه كل الأسواق، https://otproute.com/api/v1، موقّعة بمفتاح Bearer من نوع or_live_. تنشئ المفاتيح في وحدة تحكم المطورين؛ ويمكن للحساب الاحتفاظ بما يصل إلى 10 منها وإرسال 300 طلب في الدقيقة.

يتألف التشغيل التشادي النموذجي من أربعة استدعاءات:

1. GET /api/v1/countries وGET /api/v1/services للتأكد أن td مدرجة وللعثور على معرّف الخدمة التي يستهدفها اختبارك.
2. GET /api/v1/prices?country=td&service=<id> لقراءة السعر الحي لذلك الزوج قبل إنفاق أي شيء.
3. POST /api/v1/activations بجسم مثل {"service": "telegram", "country": "td"}. تحمل الاستجابة معرّف تفعيل ورقم +235 لتكتبه في التطبيق قيد الاختبار.
4. انتظر الرمز، ثم دع التفعيل يكتمل أو استدعِ POST /api/v1/activations/{id}/cancel إذا أُلغي الاختبار مبكرًا.

يستحق GET /api/v1/balance أن يُستدعى في بداية مهمة CI كي يفشل خط الأنابيب بوضوح عند محفظة فارغة بدل أن ينتهي مهلته في منتصف الطريق. ويقع المرجع الكامل في وثائق المطورين.

كيف ينبغي أن يتعامل مستقبل webhook مع رموز +235؟

الاستعلام الدوري عن GET /api/v1/activations/{id} كل بضع ثوان مقبول لسكربت واحد. وحين تتشارك عدة منفذات اختبار مفتاحًا واحدًا، يصبح webhook أنظف. سجّل نقطة نهاية (خمس لكل حساب) واشترك في activation.sms_received وactivation.expired وactivation.cancelled.

يتضمن كل طلب ترويسة X-OTPRoute-Signature بالصيغة t=<unix>,v1=<hex>. أعد بناء النص <t>.<raw body>، ووقّعه بـ HMAC-SHA256 بسر نقطة النهاية، وقارن مع v1 بزمن ثابت. ارفض أي شيء طابعه الزمني قديم؛ فهذا يغلق الباب أمام الطلبات المعاد تشغيلها. ويشرح دليلنا عن تأمين webhook الخاصة بـ OTP عبر HMAC ذلك بعدة لغات.

اعتبر معرّف التفعيل مفتاح عدم التكرار (idempotency). فإذا سُلّم الحدث نفسه مرتين، فلا ينبغي أن تغيّر الكتابة الثانية شيئًا، وينبغي أن يعيد معالجك 2xx بسرعة وينجز العمل البطيء بعد ذلك.

ما التطبيقات التي تستطيع إرسال رموز إلى رقم تحقق تشادي؟

تسرد اللقطة الحية لـ td أكثر من 1,500 خدمة. ومن الشائعة WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وViber وimo وSignal وMicrosoft & Outlook وLinkedIn وChatGPT (OpenAI) وAliExpress.

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

كيف أخزّن رقم +235 وأوحّده؟

تعتمد تشاد خطة ترقيم مغلقة: الأرقام الوطنية من ثماني خانات ولا توجد بادئة محلية تُحذف، فصيغة E.164 هي ببساطة +235 متبوعة بتلك الخانات الثماني. وهذا يجعل تشاد من الأسواق الأسهل في التحقق.

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

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

لماذا تجري فرق المنتجات اختبارات في تشاد؟

قلة من فرق الهندسة تقيم في نجامينا، ولهذا بالتحديد يفيد رقم +235 عن بُعد. من الأسباب الشائعة التي نراها:

• إطلاقات أفريقيا الوسطى الناطقة بالفرنسية، حيث يضيف منتج يعمل في أسواق مجاورة تشادَ إلى منتقي الدول في التسجيل ويحتاج إلى دليل أن المسار يعمل.
• ضمان جودة التوطين بالعربية والفرنسية، بما في ذلك تخطيط شاشة إدخال الرمز من اليمين إلى اليسار.
• عملاء الشتات الذين يحتفظون برقم تشادي أثناء إقامتهم في الخارج، ما يؤثر في كيفية قراءة قواعد مكافحة الاحتيال لرمز الدولة.
• فرق العمليات التي تدير حسابات مراسلة أعمال لشركاء إقليميين.

يوصف النمط الأوسع في توجيه الدول لـ OTP.

ماذا لو لم يصل الرمز التشادي؟

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

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

إذا انتهت النافذة أو ألغيت يعود المبلغ كاملًا إلى المحفظة دون تذكرة دعم. مزيد من الأساليب في تقليل إخفاقات تسليم OTP.

هل يوجد خط تشادي طويل الأجل، وكيف يُحتسب؟

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

تُخصم رسوم رموز +235 من رصيد واحد مسبق الدفع بالدولار الأمريكي؛ فلا مستوى اشتراك ولا رسوم شهرية. يتم الشحن بالبطاقة أو بعملتي USDT/USDC المستقرتين، وتصل فاتورة PDF إلى بريدك بعد كل إيداع. تظهر الأسعار الحية في صفحة الأسعار. ولأعمال التكامل، اطلب التحويل إلى sandbox: فهو يعيد أرقامًا ورموزًا محاكاة لتجرّب المسار دون المساس بأموال المحفظة. ويتطلب فتح حساب جديد رمز بريد إلكتروني من ست خانات، أو تسجيل الدخول عبر Google إن فضّل فريقك ذلك.

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

ما معرّف دولة تشاد في API الخاص بـ OTP Route؟

استخدم td في حقل country في POST /api/v1/activations وفي استعلام الأسعار.

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

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

كم يظل رقم +235 صالحًا للاستخدام؟

يبقى التفعيل الواحد مفتوحًا 20 دقيقة ويغطي رمزًا واحدًا. بعد ذلك اطلب رقمًا جديدًا.

هل أدفع إذا لم تصل الرسالة؟

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

هل تحتاج الأرقام التشادية إلى حذف بادئة محلية؟

لا. ليس في تشاد بادئة محلية، فالصيغة المخزنة هي +235 متبوعة بالرقم الوطني من ثماني خانات.

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

ليس بخدمة ذاتية. الأرقام المخصصة طويلة الأجل موجودة في الولايات المتحدة وكندا فقط؛ أما لتشاد فراسل الفريق للسؤال عما هو ممكن.

هل توجد قواعد للاستخدام؟

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

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