رموز التحقق التشيلية لفرق الجودة والإطلاق، موجَّهة عبر API

رقم Gateway أم رقم مخصص: أيهما يحتاجه الاختبار التشيلي؟

يعتمد الاختيار على سؤال واحد: هل سيحتاج أحد إلى رمز على رقم +56 هذا بعينه مرة أخرى؟ ففي معظم الأعمال التشيلية، كاختبار تسجيل أو فحص تعريف لمرة واحدة أو تأكيد ملف أعمال، الجواب لا، ويناسب ذلك OTP Gateway. تحصل على رقم واحد يستقبل رمزًا واحدًا، وينتهي العمل.

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

• استخدم OTP Gateway حين يلزم الرمز مرة واحدة: انحدار التسجيل، أو اختبار دخان قبل إصدار تشيلي، أو تأكيد حساب واحد.
• استخدم رقمًا مخصصًا أمريكيًا أو كنديًا حين يجب أن يواصل دخول اختبار مرحلي مشترك استقبال الرموز ولا يحتاج الحساب إلى هوية تشيلية.

ويعرض مقال الأرقام المؤقتة مقابل المخصصة المفاضلات بتعمق أكبر.

كيف يعمل OTP API لتشيلي من الطلب إلى الرمز؟

واجهة التحقق عبر SMS هي REST بسيطة تحت https://otproute.com/api/v1، تُصادَق بمفتاح Bearer يبدأ بـ or_live_ تنشئه في وحدة تحكم المطورين. معرّف دولة تشيلي هو cl.

1. استدعِ GET /api/v1/services وخزّن مؤقتًا معرّفات الخدمات التي تستخدمها اختباراتك، مثل whatsapp أو uber.
2. اقرأ القيمة الحالية من GET /api/v1/prices?country=cl&service=<id> بدل تثبيت تكلفة في الشيفرة.
3. ضع الطلب عبر POST /api/v1/activations بجسم مثل {"service": "whatsapp", "country": "cl"}. تحمل الاستجابة رقم +56 ومعرّف التفعيل.
4. اكتب ذلك الرقم في المسار قيد الاختبار وشغّل الرسالة.
5. استعلم دوريًا عن GET /api/v1/activations/{id}، أو دع webhook الحدث activation.sms_received يخبرك.
6. إذا تُرك تشغيل ما، فأرسل POST /api/v1/activations/{id}/cancel ليُقيَّد المبلغ في المحفظة فورًا.

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

ما التطبيقات التي ترسل رموزًا إلى رقم +56 للاختبار؟

يصل المسار التشيلي حاليًا إلى أكثر من 1,800 خدمة. ومن أكثر ما تلجأ إليه فرق الجودة WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وUber وMicrosoft & Outlook وAmazon وLinkedIn وChatGPT (OpenAI) وDiscord وNetflix.

يتحرك المخزون خلال اليوم، فاعتبر أي قائمة، بما فيها هذه، لقطة لحظية. وقبل مهمة مجدولة اسأل GET /api/v1/countries ونقطة الأسعار عما هو حي لـ cl وتخطَّ بسلاسة حين يغيب زوج ما، بدل اكتشاف الفجوة في منتصف مجموعة الاختبارات.

كيف تُخزَّن أرقام +56 وتُتحقق؟

أرقام الجوال التشيلية تسع خانات بعد رمز الدولة +56 وتبدأ بالرقم 9، فالجوال الكامل بصيغة E.164 يُقرأ +569 متبوعة بثماني خانات أخرى. وتُكتب الأرقام التشيلية الحالية محليًا بالخانات التسع نفسها التي تلي +56، ما يُبقي التوحيد قصيرًا.

ومع ذلك سيكتب المستخدمون الرقم بثلاث طرق مختلفة: بمسافات وعلامة زائد، أو 56 متبوعة بالخانات الوطنية دون زائد، أو بالخانات التسع المحلية وحدها. خزّن سلسلة E.164 قياسية واحدة، واحتفظ بالمدخل الخام بجانبها لتذاكر الدعم، وأضف حالات اختبار للأشكال الثلاثة. ورفض إدخال من ثماني خانات في مرحلة النموذج يوفّر عليك رسالة لم يكن لها أن تصل.

لماذا تتحقق فرق المنتجات من مسارات التسجيل التشيلية؟

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

ومن الأسباب الأخرى لإجراء فحوص تشيلية: التأكد أن حقل الهاتف يفترض +56 للزوار المحليين، وإثبات أن المسار الكامل يعمل للأرقام التشيلية تحديدًا، وتمكين موظفي الدعم أو العمليات من تأكيد حسابات الأعمال دون إعارة شريحة شخصية. وتوضح صفحة اختبار الجودة كيف تدمج الفرق ذلك في قوائم فحص الإصدار.

ماذا لو لم يظهر الرمز التشيلي؟

يبقى كل تفعيل مفتوحًا 20 دقيقة. لا تدفع إلا إذا وصل رمز؛ وحين تنتهي النافذة فارغة، أو تلغي قبلها، يعود المبلغ كاملًا إلى المحفظة تلقائيًا. وإذا ظل رقم +56 صامتًا:

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

وتجد أفكارًا إضافية لاستكشاف الأخطاء في مقالنا عن تقليل إخفاقات تسليم OTP.

كيف تعمل الفوترة والاختبار في sandbox؟

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

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

استخدمه لمنتجاتك وحساباتك فقط، واحترم شروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route سارية. يمكنك إنشاء حساب في دقائق.

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

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

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

ما معرّف الدولة الذي يتوقعه API لتشيلي؟

استخدم cl، مثلًا GET /api/v1/prices?country=cl&service=telegram.

كم يكلف رقم +56 للاختبار؟

من $0.20 للرمز؛ ويتوقف المبلغ الدقيق على الخدمة ويعيده API حيًا. ولا تُحاسَب إلا حين يصل رمز.

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

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

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

غالبًا بالإسبانية، وإن كانت تطبيقات كثيرة ترسل بلغة الحساب المختارة. حلّل الأرقام بدل مطابقة صياغة ثابتة.

هل الاستعلام الدوري أفضل أم webhook في تشغيلات الاختبار التشيلية؟

الاستعلام الدوري مقبول لفحص يدوي واحد. وحين تجري تشغيلات عدة بالتوازي، يكون webhook موقّع مبني على معرّف التفعيل أسهل في التوسع.

هل يستطيع فريق المالية لدينا الدفع بالعملات المستقرة؟

نعم. تقبل المحفظة البطاقات وUSDT/USDC، ويأتي مع كل شحن فاتورة PDF.

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