اختيار مسار +55 للتحقق عبر SMS في البرازيل

هل يستخدم اختبار البرازيل OTP Gateway أم خطًا طويل الأمد؟

ابدأ بشكل المهمة، فهو الذي يحدد المنتج. يحتاج اختبار التحقق البرازيلي عادةً رمزًا واحدًا مرة واحدة: شاشة تسجيل بالبرتغالية، أو تحدي تسجيل دخول، أو خطوة تغيير هاتف. وهذا بالضبط ما صُمم له OTP Gateway. تختار خدمة والبرازيل، وتتلقى رقم +55 لرمز واحد، ويُغلق التفعيل بعد 20 دقيقة أو عند وصول الرسالة.

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

قاعدة سريعة:

• رمز واحد لكل حالة اختبار، وحالة جديدة في كل تشغيل: OTP Gateway مع br.
• حساب staging يجب أن يسجل الدخول مجددًا الشهر القادم: رقم مخصص أمريكي أو كندي، إن قبلته الخدمة.
• إن لم تكن متأكدًا: اقرأ الأرقام المؤقتة مقابل المخصصة قبل شراء أي شيء.

ما التطبيقات التي تستطيع إرسال رموز إلى رقم برازيلي الآن؟

يغطي مسار البرازيل حاليًا أكثر من 2,900 خدمة، ومن الشائعة في اللقطة الحية WhatsApp وTelegram وGoogle (Gmail & YouTube) وInstagram وFacebook وTikTok وUber وDiscord وMicrosoft & Outlook وLinkedIn وNetflix وAirbnb وShopee وAliExpress.

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

كيف يبدو تسلسل OTP API للبرازيل عمليًا؟

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

1. حدّد معرّفات الخدمات مرة واحدة عبر GET /api/v1/services واحفظها في الإعدادات.
2. قبل الطلب، استدعِ GET /api/v1/prices?country=br&service=whatsapp (أو معرّف خدمتك). تحمل الاستجابة السعر الحي والإتاحة لهذا الزوج.
3. أنشئ التفعيل عبر POST /api/v1/activations والجسم {"service": "whatsapp", "country": "br"}. احفظ معرّف التفعيل بجانب تشغيل الاختبار.
4. اكتب رقم +55 في المسار الذي تختبره.
5. استمع إلى حدث activation.sms_received على ويب هوك؛ وكبديل احتياطي افحص GET /api/v1/activations/{id} كل بضع ثوانٍ.
6. إذا توقف الاختبار، فحرّر الرقم عبر POST /api/v1/activations/{id}/cancel لتعود الأموال فورًا.

عمليات تسليم الويب هوك موقّعة في X-OTPRoute-Signature بصيغة t=<unix>,v1=<hex>: أي HMAC-SHA256 للنص <t>.<raw body> بسر نقطة النهاية. تحقق منه، وأسقط الطوابع الزمنية القديمة، واجعل المعالج متساوي الأثر (idempotent) على معرّف التفعيل. المرجع الكامل في وثائق API.

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

نعم. تُجري لوحة التحكم توجيه OTP نفسه دون أي برمجة:

1. أنشئ حسابًا ببريدك ورمز بريد إلكتروني من 6 أرقام، أو بتسجيل الدخول عبر Google.
2. أضف أموالًا إلى المحفظة بالدولار الأمريكي.
3. اختر البرازيل والخدمة، وتحقق من السعر المعروض، ثم اطلب.
4. الصق رقم +55 في التطبيق وراقب ظهور الرمز على بطاقة التفعيل.

كثيرًا ما يستخدم فريق التسويق والدعم ومراجعو التعريب هذا المسار للتأكد من أن شاشة التسجيل بالبرتغالية تعمل قبل الإصدار، بينما يحتفظ المهندسون بـ API للتشغيل الآلي.

كيف تُخزَّن أرقام +55 وتُطبَّع؟

تتألف الأرقام البرازيلية من رمز منطقة (DDD) من خانتين يليه رقم المشترك، وأرقام الهاتف المحمول من تسع خانات تبدأ بـ 9. وداخل البرازيل يطلب الناس 0 في البداية مع رمز اختيار شركة للمكالمات بعيدة المدى، ولذلك يحتوي إدخال المستخدم غالبًا على خانات زائدة لا مكان لها في التخزين.

احفظ كل شيء بصيغة E.164: +55 ثم رمز المنطقة ثم رقم المشترك، دون مسافات ودون 0 في البداية ودون رمز شركة. طبّع عند الإدخال، وقارن على القيمة المطبَّعة، ولا تنسّق إلا للعرض. تصل الرموز من المرسِلين البرازيليين عادةً بالبرتغالية، وأحيانًا بالإنجليزية، فحلّل الأرقام بدل مطابقة جملة ثابتة.

وتختبر الفرق هذا السوق لإطلاق برازيلي، ولاختبار جودة التعريب البرتغالي، ولمسارات تسجيل تجاور التزامات قانون حماية البيانات البرازيلي (LGPD). وتغطي صفحتنا عن التسجيل في الخدمات المالية جانب التحقق من هذا العمل.

ماذا لو لم يظهر الرمز البرازيلي؟

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

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

ويسرد دليل تقليل فشل تسليم OTP مزيدًا من أدوات التشخيص.

كيف تتكامل المحفظة والفواتير وsandbox؟

تحتسب OTP Route من محفظة واحدة بالدولار الأمريكي مدفوعة مسبقًا: الدفع حسب الاستخدام، دون رسوم شهرية ودون خطة تختارها. اشحنها ببطاقة أو بـ USDT أو USDC، وتصل مع كل شحن فاتورة PDF بالبريد. الأسعار الكاملة في صفحة الأسعار وفي API.

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

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

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

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

ما معرّف البرازيل في OTP Route API؟

هو br. مرّره كحقل country عند إنشاء تفعيل أو كمعامل الاستعلام country في نقطة نهاية الأسعار.

هل أُحاسَب إن لم ترسل WhatsApp الرمز إلى رقم +55 الخاص بي؟

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

هل يمكنني شراء رقم برازيلي والاحتفاظ به لأشهر؟

ليس كمنتج ذاتي الخدمة. الأرقام المخصصة طويلة الأمد تُباع للولايات المتحدة وكندا فقط؛ أما للبرازيل فيمكنك مراسلة [email protected] للاستفسار، دون وعد بالتوفر.

هل أحتفظ بالصفر البادئ من الرقم البرازيلي عند التخزين؟

لا. أزل صفر البادئة الوطنية وأي رمز اختيار شركة، ثم احفظ الرقم بصيغة E.164 تبدأ بـ +55 ورمز المنطقة من خانتين.

بأي لغة تصل رسائل التحقق البرازيلية؟

تصل معظمها بالبرتغالية، وترسل بضع خدمات عالمية نصًا إنجليزيًا. استخرج الرمز الرقمي بدل الاعتماد على الصياغة.

هل يمكنني تجربة API قبل شحن المحفظة؟

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

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