العربية
استقبال رموز SMS من LINE على أرقام OTP Route: قائمة فحص وخطوات
يستقبل الفريق رمز التحقق من LINE عبر OTP Route بطلب رقم لمرة واحدة للخدمة linemessenger في OTP Gateway، وإدخاله في شاشة التسجيل أو الدخول في LINE، وقراءة الرمز من لوحة التحكم أو من webhook موقّع. يبدأ السعر من $0.20 للرمز، وإن لم يصل شيء خلال نافذة الـ 20 دقيقة يعود المبلغ إلى محفظتك تلقائيًا.
فيمَ يستخدم LINE رقم الهاتف؟
يربط LINE الحساب برقم هاتف. يُؤكَّد التسجيل الجديد برمز SMS، وقد يطلب التطبيق الرقم مجددًا عند نقل الحساب إلى جهاز جديد أو عندما يسجّل أحد الدخول بعد إعادة التثبيت. ويؤدي الرقم دورًا في استعادة الوصول أيضًا، لذا يهمّ الرقم الذي أُنشئ به الحساب.
وهذه النقطة الأخيرة تحدد اختيارك للمنتج: يناسب الرقم لمرة واحدة خطوة تحقق واحدة، أما الحساب الذي يجب أن يسجّل الدخول مجددًا بعد أشهر فيحتاج إلى رقم لا تزال تتحكم به.
قائمة فحص قبل طلب رقم LINE
- مفتاح API من وحدة تحكم المطورين (بالبادئة
or_live_)؛ حتى 10 مفاتيح لكل حساب. - رصيد كافٍ في المحفظة، تؤكده عبر
GET /api/v1/balance. - دولة مختارة تطابق سوق الحساب أو حالة الاختبار.
- استعلام عن السعر الحي لهذا الزوج، لأن الأسعار تختلف حسب الدولة.
- نقطة webhook مسجّلة وفحص توقيعها مُختبَر، أو حلقة استعلام دوري جاهزة.
- قرار بشأن ما إذا كان على هذا الحساب أن يسجّل الدخول لاحقًا؛ وإن كان كذلك فاقرأ قسم الرقم المخصص أدناه.
- مراجعة سريعة لشروط LINE الخاصة بنوع الحساب الذي تنشئه.
ما الدول التي يمكنني اختيارها لـ LINE، ولماذا يهم ذلك؟
خدمة LINE متاحة في 197 دولة. للتطبيق أقوى قواعد مستخدميه في أجزاء من شرق آسيا وجنوب شرقها، لذا تبدأ الفرق التي تُطلق منتجاتها هناك غالبًا بـاليابان أو تايلاند أو تايوان أو إندونيسيا أو هونغ كونغ أو ماليزيا. ومن الخيارات الأخرى سنغافورة والفلبين وفيتنام وكوريا الجنوبية وأستراليا والولايات المتحدة والمملكة المتحدة وألمانيا والبرازيل ورومانيا.
اختر الدولة التي يأتي منها مستخدموك الفعليون. النسخة الموجّهة إلى السوق التايلاندي ينبغي التحقق منها برقم تايلاندي حتى يعمل رمز الدولة وتنسيق الهاتف وأي شاشات استقبال إقليمية كما ستعمل في بيئة الإنتاج. وتغطية عدة أسواق لا تكلّف جهدًا إضافيًا يُذكر، لأن قيمة country وحدها هي ما يتغير بين التشغيلات.
خطوة بخطوة: مسار واجهة رمز التحقق من LINE
- استدعِ
GET /api/v1/prices?country=<id>&service=linemessengerوتأكد أن المسار متاح. - أنشئ التفعيل عبر
POST /api/v1/activationsبجسم مثل{"service": "linemessenger", "country": "th"}. - أدخل الرقم المعاد في شاشة التحقق من الهاتف في LINE.
- انتظر
activation.sms_received، أو استعلم عنGET /api/v1/activations/{id}كل بضع ثوانٍ ضمن حد 300 طلب في الدقيقة. - إذا أُلغي التشغيل فاستدعِ
POST /api/v1/activations/{id}/cancel.
تفاصيل نقاط النهاية في وثائق المطورين.
كيف ينبغي أن يتعامل معالج webhook مع أحداث LINE؟
اقرأ الترويسة X-OTPRoute-Signature بصيغة t=<unix>,v1=<hex>، واحسب HMAC-SHA256 على <t>.<raw body> بسرّ نقطة النهاية، وقارن بزمن ثابت، وأسقط أي طلب بطابع زمني قديم. ثم اربط معالجتك بمعرّف التفعيل، ليحدّث التسليم المعاد السجل نفسه بدل أن يشغّل خطوة اختبارك مرتين. وعامِل activation.expired وactivation.cancelled كنتيجتين سليمتين في الجدول نفسه. يتضمن دليل HMAC شرحًا كاملًا.
طلب رقم LINE من لوحة التحكم
سجّل الدخول، وافتح OTP Gateway، واختر LINE والدولة، وراجع السعر المعروض ثم اطلب. اكتب الرقم في LINE، ثم أبقِ بطاقة التفعيل مفتوحة؛ يظهر الرمز هناك فور استلامه. كثيرًا ما يستخدم مديرو المنتجات ووكلاء الدعم هذه الواجهة لفحص شاشة استقبال LINE المترجمة يدويًا قبل أن تتولى مجموعة الاختبارات الآلية. وتسري نافذة الـ 20 دقيقة وقاعدة الاسترداد نفسهما.
استكشاف الأخطاء: لماذا قد لا يصل رمز LINE
قد يرفض LINE بعض الأرقام الافتراضية، وقد يصبح مسار نجح سابقًا غير متاح لاحقًا في اليوم. وإن لم تصل أي رسالة يُسترد التفعيل كاملًا عند انتهاء النافذة أو عند الإلغاء. وبعد ذلك:
- جرّب دولة أخرى لا تزال تناسب حالة الاختبار؛
- أعد المحاولة لاحقًا بدل إعادة الطلب في حلقة سريعة؛
- تأكد من إدخال الرقم برمز الدولة الصحيح.
متى يكون الرقم المخصص هو الأنسب لـ LINE؟
إذا كان على حساب تجريبي أو تسجيل دخول مشترك للفريق أن يواصل الدخول، فالرقم لمرة واحدة أداة غير مناسبة. تبدأ الأرقام المخصصة في الولايات المتحدة وكندا من $1.95/month، وتستقبل الرسائل الواردة في لوحة التحكم وعلى webhook الخاص بك عبر number.sms_received، وتتجدد من المحفظة إلى أن تتخلى عنها. التفاصيل في صفحة الأرقام الافتراضية.
استخدم OTP Route لمنتجاتك وحساباتك المشروعة فقط: حساب واحد لكل شخص أو شركة حقيقية، مع احترام شروط LINE واتباع سياسة الاستخدام المقبول.
الأسئلة الشائعة
ما معرّف الخدمة الذي تستخدمه OTP Route لـ LINE؟
المعرّف هو linemessenger. استخدمه في استعلام الأسعار وفي الحقل service عند إنشاء تفعيل.
هل أستطيع إجراء التحقق عبر SMS من LINE للاختبار دون شريحة فعلية؟
نعم. يستقبل رقم OTP Gateway رمز LINE، وتقرؤه عبر API أو webhook أو لوحة التحكم.
أي دولة أختار لرقم افتراضي لـ LINE؟
اختر السوق الذي ينتمي إليه مستخدموك أو حالة الاختبار، مثل اليابان أو تايلاند عند الإطلاق هناك.
هل يقبل LINE كل أرقام OTP Route؟
ليس دائمًا. قد يرفض LINE بعض الأرقام الافتراضية، وعندما لا يصل رمز يُسترد المبلغ تلقائيًا.
كم تكلفة استقبال رمز OTP من LINE؟
من $0.20 للرمز، حسب الدولة؛ ويأتي السعر الحي من GET /api/v1/prices.
هل أستطيع الاحتفاظ برقم هاتف LINE نفسه لتسجيلات دخول لاحقة؟
فقط برقم مخصص، وهو متاح في الولايات المتحدة وكندا. الأرقام لمرة واحدة مخصصة لرمز واحد.
هل أحتاج إلى webhook لاستقبال رموز LINE، أم يكفي الاستعلام الدوري؟
يعمل الاستعلام الدوري عن GET /api/v1/activations/{id} جيدًا للتشغيلات الصغيرة. وتتوسع webhooks بصورة أفضل عندما تعمل تفعيلات كثيرة بالتوازي.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.