دليل دمج Reverse OTP للتحقق من الهاتف
دليل شامل خطوة بخطوة لتطبيق التحقق عبر Reverse OTP في تطبيق الجوال، يشمل الدمج مع واجهة API، ورصد WhatsApp، ومعالجة الحالات الاستثنائية، واستراتيجيات الاحتياط لمصادقة سلسة للمستخدمين.

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

رصد WhatsApp على جهاز المستخدم
قبل بدء التحقق، ينبغي أن يتحقق تطبيقك من تثبيت WhatsApp باستخدام canOpenURL.
التنفيذ على iOS:
سجّل أولًا whatsapp:// بوصفه query scheme في ملف Info.plist الخاص بتطبيقك ضمن LSApplicationQueriesSchemes.
إعداد Info.plist
<key>LSApplicationQueriesSchemes</key>
<array>
<string>whatsapp</string>
</array>التنفيذ على Android:
استخدم PackageManager للتحقق من وجود حزمة WhatsApp.
رصد WhatsApp على Android
try {
PackageManager pm = getPackageManager();
pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
// WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
// WhatsApp is not installed
}أفضل ممارسة: إذا كان WhatsApp متاحًا، فتابع بـ Reverse OTP. وإن لم يكن، فارجع بسلاسة إلى SMS.
بدء Reverse OTP
أنشئ على الخادم الخلفي رمز جلسة قصيرًا وفريدًا (يمكن أن يكون معرّفًا موجودًا، مثل UUID المستخدم). ثم استدعِ به واجهة API لبدء مسار التحقق. ستعيد لك رمزًا فريدًا يُستخدم لإنشاء رابط WhatsApp عميق معبأ مسبقًا.
صيغة رابط WhatsApp العميق
https:/PHONE_NUMBER?text=VERIFY-12345سيتضمن النص المُنشأ رمز التحقق هذا بين قوسين ليرصده الخادم الخلفي ويربطه بالجلسة الأصلية.
ينقر المستخدم على الرابط فيُفتح WhatsApp، ثم يضغط إرسال، ويستخرج الخادم الخلفي رقم هاتف المستخدم من بيانات WhatsApp الوصفية.
يتلقى المستخدم رسالة تأكيد مباشرة على WhatsApp تحمل رابط callback للعودة إلى خدمتك.
مثال على الدمج مع واجهة API
const response = await fetch('/api/start-verification', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
session_id: userSessionId,
phone_number: userPhoneNumber
})
});
const { validation_token, whatsapp_url } = await response.json();الاستعلام عن النتيجة
بعد عودة المستخدم إلى المسار، سيستعلم خادمك الخلفي عن حالة الجلسة التي فُتحت سابقًا ليحصل على رقم الهاتف مباشرة. يمكنك حفظ الرقم وتعليم التحقق بأنه ناجح.
تنفيذ التحقق من الحالة
const checkStatus = async (sessionId) => {
const response = await fetch('/api/check-verification-status', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ session_id: sessionId })
});
const result = await response.json();
if (result.status === 'verified') {
// Save the verified phone number
saveVerifiedPhoneNumber(result.phone_number);
markVerificationComplete();
}
return result;
};نصيحة احترافية: نفّذ استطلاعًا دوريًا (polling) لفحص حالة التحقق كل بضع ثوانٍ حتى الاكتمال أو انتهاء المهلة.
معالجة الحالات الاستثنائية
يفتح المستخدمون WhatsApp أحيانًا دون إتمام العملية:
- يرفضون نافذة أذونات WhatsApp
- يكون التطبيق مفرَّغًا من الذاكرة أو محذوفًا
- تعلق الرسالة في حالة الإرسال بسبب ضعف الاتصال
كيفية المعالجة:
مهلة سلسة:
بعد بضع دقائق دون وصول الرسالة، نبّه المستخدم:
آلية إعادة المحاولة:
وفّر زر «إعادة الإرسال عبر WhatsApp» ينشئ رابطًا جديدًا.
خيارات الاحتياط:
اعرض دائمًا قناة تحقق بديلة حتى لا يتعطل استقبال المستخدمين الجدد.
حفظ الحالة:
إذا عاد المستخدم لاحقًا، أبقِ جلسته قائمة وأعد عرض خيارات التحقق دون إجباره على إعادة بدء عملية الانضمام.
تنفيذ معالجة الحالات الاستثنائية
const handleVerificationTimeout = () => {
showDialog({
title: "Verification Incomplete",
message: "It looks like your verification didn't complete. Would you like to try again or switch to SMS?",
buttons: [
{ label: "Try WhatsApp Again", action: retryWhatsAppVerification },
{ label: "Use SMS Instead", action: fallbackToSMS },
{ label: "Cancel", action: closeDialog }
]
});
};
// Set timeout for 3 minutes
setTimeout(handleVerificationTimeout, 180000);الاحتياط للمستخدمين الذين لا يملكون WhatsApp
إذا اكتشف canOpenURL (على iOS) أو PackageManager (على Android) أن WhatsApp غير متاح، فارجع تلقائيًا إلى SMS OTP أو OTP عبر البريد الإلكتروني.
تنفيذ الاحتياط
const initiateVerification = async () => {
const hasWhatsApp = await checkWhatsAppAvailability();
if (hasWhatsApp) {
// Use Reverse-OTP via WhatsApp
return initiateReverseOTP();
} else {
// Fall back to SMS OTP
return initiateSMSOTP();
}
};
const checkWhatsAppAvailability = async () => {
if (Platform.OS === 'ios') {
return await Linking.canOpenURL('whatsapp://');
} else {
// Android package check
return await isAppInstalled('com.whatsapp');
}
};نصيحة لتجربة المستخدم: اجعل الرجوع إلى البديل سلسًا بعدم مطالبة المستخدمين باختياره بأنفسهم. استخدم تلقائيًا أفضل طريقة متاحة لجهازهم.
الخلاصة
يجعل Reverse OTP التحقق أسرع وأكثر أمانًا، وغالبًا أرخص من SMS. لكن من الضروري التصميم لانقطاعات الواقع، من أذونات التطبيق إلى إخفاق تسليم الرسائل، حتى يجد المستخدمون دائمًا طريقًا سلسًا للمتابعة. ويضمن مسار احتياطي مدروس جيدًا تعظيم الأمان ومعدلات التحويل معًا.
