استقبال رموز Zoho النصية للاختبار وحسابات الأعمال

الموقف: شاشة Zoho تطلب رقم جوال

يصادف الفرق هذه الخطوة بطرق متوقعة. مطوّر تكامل يحتاج إلى حساب Zoho جديد لاختبار اتصال OAuth مع CRM أو Books أو Desk. وكالة تجهّز Zoho Mail وZoho One لعميل ولا تريد ربط هاتف موظف شخصي بدخول المدير. ومسؤول جودة عليه أن يثبت أن مسار التسجيل يعمل بالطريقة نفسها لمستخدم في دبي ولآخر في سيدني. في كل حالة تكون العقبة هي الرسالة النصية نفسها، ونادرًا ما يملك صاحب الحاجة شريحة من الدولة المناسبة.

تحوّل OTP Route هذه الرسالة إلى شيء تستطيع أدواتك طلبه وانتظاره وقراءته.

أين يعتمد Zoho على التحقق الهاتفي؟

يطلب Zoho عادةً رقم جوال عند إنشاء حساب جديد، وقد يستخدم SMS عاملًا ثانيًا عند تسجيل الدخول إلى جانب تطبيق المصادقة التابع له. كما يُستخدم الرقم الموثَّق لاستعادة الحساب عند ضياع كلمة المرور. يعتمد توقيت طلب الرمز بالضبط على المنتج ومنطقة الحساب وإعدادات الأمان التي اختارها المسؤول، لذا ابنِ اختبارات تتحمل ظهور الطلب أو غيابه.

اختيار دولة رقم Zoho

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

من المسارات التي تُختار كثيرًا الهند والولايات المتحدة والمملكة المتحدة والإمارات العربية المتحدة وأستراليا وألمانيا. ومن الدول الأخرى في القائمة كندا والبرازيل والمكسيك وسنغافورة والسعودية وجنوب أفريقيا وهولندا وإسبانيا وفرنسا واليابان وإندونيسيا وماليزيا وكينيا. تتغير التغطية خلال اليوم، فاقرأها من GET /api/v1/countries عند بدء التشغيل.

ربط واجهة API لرمز التحقق من Zoho باختباراتك

تُرسَل الطلبات إلى https://otproute.com/api/v1 بمفتاح Bearer من وحدة تحكم المطورين.

1. اجلب السعر عبر GET /api/v1/prices?country=<id>&service=zoho.
2. أنشئ التفعيل: POST /api/v1/activations مع {"service": "zoho", "country": "<id>"}.
3. اجعل أتمتة المتصفح تكتب الرقم المُرجَع في نموذج Zoho وتطلب الرمز.
4. انتظر الحدث activation.sms_received، المرتبط بمعرّف التفعيل، عند نقطة الويب هوك.

عادتان تجعلان المعالج موثوقًا. الأولى، تحقق من X-OTPRoute-Signature بحساب HMAC-SHA256 على "<t>.<raw body>" بسر نقطة النهاية، وارفض الطوابع الزمنية القديمة. الثانية، اجعل المعالج idempotent: سجّل معرّف التفعيل وتجاهل التسليم المكرر، فلا يُرسل الرمز مرتين أبدًا. وإذا كان مشغّل اختباراتك لا يستقبل حركة واردة، فاستعلم دوريًا عبر GET /api/v1/activations/{id} وابقَ دون 300 طلب في الدقيقة. يعرض دليل التقاط الويب هوك النمطين.

تنفيذها يدويًا من لوحة التحكم

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

لماذا قد لا يصل OTP من Zoho؟

غياب الرمز له عادةً سبب عادي:

• قد يرفض Zoho الأرقام الافتراضية لبعض المناطق أو أنواع الحسابات. هذا قراره، وهو سبب كون الاسترداد تلقائيًا.
• قد يكون مسار تلك الدولة مزدحمًا في تلك اللحظة. أعد المحاولة لاحقًا أو عبر دولة أخرى تناسب الاختبار.
• قد يحدّ Zoho نفسه من الطلبات المتكررة من جلسة متصفح واحدة، فباعد بين المحاولات.
• طلب تفعيلات جديدة في حلقة سريعة لا يفيد ويستهلك حصة طلبات API.

دع المهلة تنتهي قبل أن تستنتج أن المسار فشل.

متى يكون Dedicated Number الخيار الأفضل

التفعيل لمرة واحدة مناسب لإنشاء الحسابات واختبارها. لكنه الأداة الخطأ لدخول مسؤول سيطلب منك SMS مجددًا الشهر القادم، لأن ذلك الرقم لن يكون ملكك لاحقًا. لهذه الحالة يمنحك Dedicated Number، ابتداءً من $1.95/month، خطًا أمريكيًا أو كنديًا تحتفظ به ما دام يُجدَّد، مع رسائل واردة في لوحة التحكم ومُعاد توجيهها إلى الويب هوك الخاص بك. الخطوط المخصصة متاحة في هاتين الدولتين فقط. اقرأ المزيد في صفحة الأرقام الافتراضية.

استخدام أرقام Zoho بمسؤولية

اتبع شروط Zoho. أنشئ حسابًا واحدًا لكل شخص حقيقي أو شركة، واستخدم OTP Route لاختبار منتجاتك وحسابات عملائك المشروعة وتشغيلها، لا لإنتاج تسجيلات بالجملة. لا ترتبط OTP Route بـ Zoho، واسمه علامة تجارية لمالكه، وتسري سياسة الاستخدام المقبول على كل تفعيل. تستطيع الوكالات التي تدير عدة عملاء قراءة صفحة حلول الوكالات.

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

كيف أستقبل OTP من Zoho عبر واجهة API؟

أنشئ تفعيلًا بمعرّف الخدمة zoho والدولة التي تختارها، ثم اقرأ الرمز من ويب هوك activation.sms_received أو بالاستعلام الدوري عن التفعيل.

هل أستطيع استخدام رقم افتراضي للتحقق عبر SMS من Zoho للاختبار؟

غالبًا نعم، لكن قد يرفض Zoho الأرقام الافتراضية في بعض الحالات. وإذا لم يصل رمز خلال 20 دقيقة يُسترد المبلغ.

كم يكلّف رقم هاتف Zoho لرمز واحد؟

ابتداءً من $0.20 للرمز. تُرجع نقطة الأسعار السعر المباشر لكل دولة ويظهر في لوحة التحكم.

أي دولة أختار لحساب اختبار Zoho؟

اختر دولة المستخدم أو السوق الذي تختبره، كي يطابق رمز الاتصال ولغة الرسالة الحالة الحقيقية.

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

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

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

نعم. يمكن تحويل حساب تطوير إلى sandbox عند الطلب، فيُرجع أرقامًا ورموزًا محاكاة. راجع الوثائق للتفاصيل.

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