استقبال رموز Zalo OTP على أرقام OTP Route عبر API

كيف يبدو مسار واجهة رمز التحقق من Zalo؟

معرّف الخدمة هو zalo. تُرسل الاستدعاءات إلى https://otproute.com/api/v1 بمفتاح Bearer بالبادئة or_live_ يُصدر من وحدة تحكم المطوّرين.

1. احصل على معرّفات الدول من GET /api/v1/countries؛ فمعرّف فيتنام مثلًا هو vn.
2. تحقق من السعر والتوفر الفعليين عبر GET /api/v1/prices?country=vn&service=zalo.
3. أنشئ التفعيل: POST /api/v1/activations مع {"service": "zalo", "country": "vn"}. واحفظ معرّف التفعيل والرقم المُعاد.
4. أدخل الرقم في شاشة الهاتف في Zalo لحساب الاختبار الذي تتحكم به.
5. اجمع الرمز عبر Webhook أو الاستعلام، أو أنهِ الطلب عبر POST /api/v1/activations/{id}/cancel.

والتحقق من الرصيد عبر GET /api/v1/balance عند بدء مجموعة الاختبارات يجنّبك المفاجآت أثناء التشغيل. راجع توثيق API لأشكال الطلبات الكاملة.

بناء مستقبِل Webhook لرموز Zalo

سجّل نقطة نهاية في وحدة تحكم المطوّرين واشترك في activation.sms_received وactivation.expired وactivation.cancelled. يحمل كل طلب ترويسة X-OTPRoute-Signature بصيغة t=<unix>,v1=<hex>؛ احسب HMAC-SHA256 على <t>.<raw body> باستخدام سر نقطة النهاية، وقارن بزمن ثابت، وارفض الطوابع الزمنية القديمة.

اجعل المعالج idempotent بتخزين النتائج بمفتاح معرّف التفعيل. فإذا سُلّم الحدث نفسه مرتين، تكون الكتابة الثانية بلا أثر. ويمكن للفرق التي ليس لديها نقطة نهاية عامة أن تستعلم عبر GET /api/v1/activations/{id} بدلًا من ذلك؛ فحد 300 طلب في الدقيقة يترك متسعًا لفاصل استعلام قصير عبر عدة اختبارات متوازية.

متى يطلب Zalo رقم هاتف؟

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

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

ما الدول التي تستقبل OTP الخاص بـ Zalo على OTP Route؟

مسارات Zalo مُدرجة في 198 دولة. منها فيتنام والولايات المتحدة واليابان وكوريا الجنوبية وتايوان وأستراليا وكندا وكمبوديا ولاوس وتايلاند وماليزيا وسنغافورة وألمانيا وفرنسا والمملكة المتحدة.

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

خطوات لوحة التحكم لاختبار التحقق عبر SMS من Zalo

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

لماذا قد لا يصل رمز Zalo؟

يعتمد التسليم على الخدمة والمسار، فلا توجد مدة انتظار ثابتة. وقد ترفض Zalo أيضًا بعض الأرقام الافتراضية، وهذا سبب وجود الاسترداد. إن لم يظهر شيء:

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

هل ينبغي أن يستخدم حساب اختبار Zalo رقمًا مخصصًا؟

رقم OTP Gateway يتولى رمزًا واحدًا. أما إذا كان حساب تجريبي أو حساب دعم سيحتاج إلى تسجيل الدخول مجددًا الشهر القادم، فإن Dedicated Number هو الأنسب: خط أمريكي أو كندي ابتداءً من $1.95/شهر تحتفظ به ما دام يتجدد، مع استقبال SMS الواردة في لوحة التحكم وعلى Webhook number.sms_received. اعرف المزيد في صفحة الأرقام الافتراضية.

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

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

ما معرّف الخدمة الذي تستخدمه OTP Route API لـ Zalo؟

إنه zalo، ويُرسل في جسم POST /api/v1/activations مع معرّف الدولة.

هل أستطيع استقبال OTP من Zalo على رقم خارج فيتنام؟

نعم. مسارات Zalo مُدرجة في 198 دولة، ويعيد استعلام الأسعار التوفر الفعلي لكل منها.

هل أُحاسَب إذا رفضت Zalo الرقم الافتراضي؟

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

هل الرقم الافتراضي لـ Zalo مناسب لحساب أحتاجه لمدة طويلة؟

الرقم لمرة واحدة غير مناسب. أما لتسجيلات الدخول المتكررة فالأسلم هو Dedicated Number أمريكي أو كندي تحتفظ به ما دام يتجدد.

كيف أدفع مقابل التحقق عبر SMS من Zalo للاختبار؟

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

هل أستطيع تجربة تكامل Zalo دون إنفاق مال؟

نعم. بعد أن ينقل الدعم حساب التطوير إلى وضع sandbox، تعيد طلبات Zalo أرقامًا ورموزًا محاكاة، فيمكن اختبار كود Webhook والاستعلام قبل أي إنفاق فعلي.

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