Skip to content

API التحقق من الهاتف

تأكد من أن المستخدمين يملكون رقم الهاتف الذي يقدّمونه.

أكّد ملكية الرقم في ثوانٍ

التحقق من الهاتف هو أساس كل تجربة مستخدم موثوقة. أرسل كلمة مرور لمرة واحدة (OTP) عبر SMS أو WhatsApp أو مكالمة صوتية وأكّد الملكية في ثوانٍ.

ما هو التحقق من الهاتف؟

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

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

كيف يعمل التحقق من الهاتف

يقوم كل مسار تحقق من الهاتف على الفكرة نفسها: لا بد أن يحدث على الهاتف شيء لا يستطيع إحداثه إلا حامله. تُرسل النسخة الكلاسيكية رمزًا لمرة واحدة عبر SMS وتطلب من المستخدم كتابته. وتشغّله Phone-Verif في الاتجاه المعاكس، فيرسل المستخدم رسالة بدل أن يستقبلها، لكن الشكل هو نفسه: إنشاء جلسة، وعرض تحدٍّ، وانتظار الإثبات، وقراءة النتيجة.

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

التحقق عبر WhatsApp

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

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

التحقق عبر SMS والبديل الاحتياطي

للمستخدمين الذين لا يملكون WhatsApp، تقبل الجلسة نفسها الرمز نفسه عبر SMS: يرسل المستخدم الرمز رسالةً نصية عادية إلى رقم التحقق بدلًا من ذلك. وتبقى الجلسة والرمز والحالة التي تقرؤها بعد ذلك متطابقة، فلا يتفرع تكاملك، وإنما يتغير التوجيه المعروض للمستخدم فحسب.

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

Reverse OTP: لماذا يهم الاتجاه

في مسار OTP التقليدي يرسل الخادم سرًّا ويأمل أن يصل إلى الهاتف الصحيح ولا يصل إلى غيره. وهذا الافتراض هو ما يستغله كل من هجمات تبديل SIM وتصيّد OTP، وهو ما يجعل حركة المرور المضخّمة اصطناعيًا مربحة: فكل محاولة تكلّفك رسالة سواء كان وراءها مستخدم حقيقي أم لا.

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

مسار التحقق من البداية إلى النهاية

تبدأ الجلسة في حالة pending. ثم تمر بـ whatsapp_previewed حين يرى المستخدم الرسالة المعبأة مسبقًا، وopened حين يفتح الرابط، وverified حين تصل الرسالة وتُطابَق مع الجلسة. وإذا لم يتصرف أحد في الوقت المناسب، تنتهي عند expired بدلًا من ذلك.

لا تحمل الرقم إلا حالة verified؛ وإلى ذلك الحين يكون الحقل null. اعتبر الحالة هي الإشارة والرقم حمولتها، لا العكس أبدًا. فهذه القاعدة وحدها تزيل معظم حالات التسابق التي يصادفها الناس عند أول تكامل.

الدمج مع واجهة API

التكامل استدعاءان من نوع REST. يفتح POST /start-verification جلسة ويعيد رقم WhatsApp والرابط العميق وعنوان URL لصفحة ويب مستضافة إن فضّلت إعادة التوجيه على بناء شاشتك الخاصة. ويعيد GET /check-verification-status حالة الجلسة، والرقم نفسه متى تم التحقق.

يمكنك الاستغناء عن واجهة المستخدم كليًا وتضمين صفحة التحقق المستضافة في iframe، وهو أسرع طريق إلى شيء يعمل. وفي الحالتين، فضّل الـ callback على حلقة الاستطلاع في الإنتاج، ولا تستطلع إلا أثناء التطوير أو حين يعود المستخدم صراحةً إلى صفحتك.

الأمان والخصوصية

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

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

التسعير

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

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

ما هي واجهة API للتحقق من الهاتف؟
واجهة API للتحقق من الهاتف هي واجهة HTTP تثبت أن المستخدم يتحكم برقم هاتف. تستدعيها لفتح جلسة تحقق، وتعرض على المستخدم ما تعيده، ثم تقرأ الرقم الموثّق بعد أن يتصرف.
هل يعمل التحقق من الهاتف دون WhatsApp؟
نعم. تقبل الجلسة نفسها رمز التحقق عبر SMS، فيرسل المستخدمون الذين لا يملكون WhatsApp الرمز رسالةً نصية عادية بدلًا من ذلك. ويقرأ تكاملك النتيجة من نقطة النهاية نفسها في الحالتين.
كم يستغرق التحقق؟
استدعاء API نفسه فوري؛ والباقي هو أن يمسح المستخدم رمزًا وينقر على إرسال. وعمليًا تكتمل معظم الجلسات في ثوانٍ لا دقائق، لأنه لا توجد خطوة تسليم من المشغّل تُنتظر.
ماذا تعيد واجهة API بعد التحقق من الرقم؟
تتغير حالة الجلسة إلى verified وتحمل الاستجابة رقم الهاتف الموثّق مع الطوابع الزمنية لكل خطوة مرّت بها. وقبل ذلك يكون حقل الرقم null.
هل التحقق من الهاتف هو المصادقة الثنائية نفسها؟
لا. التحقق من الهاتف يثبت أن الرقم يخص المستخدم، عادةً مرة واحدة عند التسجيل. أما المصادقة الثنائية فتعيد فحص هذا الإثبات عند تسجيل الدخول أو قبل إجراء حساس. وتغطي واجهة API نفسها الحالتين، لكنهما تجيبان عن سؤالين مختلفين.

Related

سيناريوهات شائعة

التحقق من جهة الاتصال

تأكد من أن المستخدمين يقدّمون أرقام هاتف حقيقية يمكن الوصول إليها.

استقبال العملاء الجدد

ابنِ الثقة ببيانات اتصال موثّقة منذ اليوم الأول.

التحقق من صلاحية الرقم

ارفض الأرقام غير الصالحة أو المؤقتة أو التي يتعذر الوصول إليها.

تأكيد هوية المستخدم

اربط رقم الهاتف بملف المستخدم لإثبات هوية آمن.

Build your التحقق من رقم الهاتف flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.