Telefon Doğrulama için Reverse OTP Entegrasyon Rehberi
Mobil uygulamanızda Reverse OTP doğrulamasını uygulamak için kapsamlı, adım adım bir rehber: kesintisiz kullanıcı kimlik doğrulaması için API entegrasyonu, WhatsApp algılama, uç durum yönetimi ve yedek stratejileri.

Bu sayfanın yeri
Bu sayfa uygulama adımlarını anlatır. Reverse OTP'nin ne olduğunu ve parçaların nasıl bir araya geldiğini öğrenmek için Reverse OTP nasıl çalışır yazısını, kanal değiştirmenin gerekçesi için Reverse OTP ve SMS OTP yazısını okuyun. Uç nokta referansı WhatsApp Doğrulama API'si entegrasyon rehberinde yer alır.
Reverse OTP, süreci kolaylaştırmak için WhatsApp gibi mesajlaşma uygulamalarından yararlanan yenilikçi bir kullanıcı doğrulama yaklaşımıdır. Kullanıcıya SMS OTP göndermek yerine uygulamanın kendisi önceden doldurulmuş bir mesaj gönderir ve sunucu göndereni doğrular. Bu, dolandırıcılık risklerini azaltır, hızı artırır ve geleneksel SMS OTP'lere kıyasla maliyeti düşürebilir.
Bu yazıda reverse OTP'yi mevcut telefon doğrulama akışınıza nasıl entegre edeceğinizi adım adım ele alıyoruz: API entegrasyonu, uygulama algılama, uç durumların yönetimi ve WhatsApp kullanılamadığında yapılacaklar.

Kullanıcının Cihazında WhatsApp'ı Algılayın
Doğrulamayı başlatmadan önce uygulamanız, canOpenURL ile WhatsApp'ın yüklü olup olmadığını kontrol etmelidir.
iOS uygulaması:
Önce whatsapp:// şemasını, uygulamanızın Info.plist dosyasında LSApplicationQueriesSchemes altına sorgu şeması olarak kaydedin.
Info.plist yapılandırması
<key>LSApplicationQueriesSchemes</key>
<array>
<string>whatsapp</string>
</array>Android uygulaması:
WhatsApp paketinin mevcut olup olmadığını kontrol etmek için PackageManager kullanın.
Android WhatsApp algılama
try {
PackageManager pm = getPackageManager();
pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
// WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
// WhatsApp is not installed
}En iyi uygulama: WhatsApp mevcutsa reverse OTP ile devam edin. Değilse sorunsuzca SMS'e geçin.
Reverse OTP'yi Başlatın
Arka uçta kısa ve benzersiz bir oturum kodu oluşturun (bu, kullanıcı UUID'si gibi mevcut bir tanımlayıcı olabilir). Bu kodla doğrulama akışı başlatma API'mizi çağırın. API, önceden doldurulmuş bir WhatsApp deep link'i oluşturmak için kullanılacak benzersiz bir belirteç döndürür.
WhatsApp deep link biçimi
https:/PHONE_NUMBER?text=VERIFY-12345Oluşturulan metin, arka ucun belirteci algılayıp özgün oturumla eşleştirebilmesi için bu doğrulama belirtecini köşeli parantez içinde barındırır.
Kullanıcı bağlantıya dokunur, WhatsApp açılır, gönder tuşuna basılır ve kullanıcının telefon numarası arka uç tarafında WhatsApp meta verilerinden çıkarılır.
Kullanıcı, hizmetinize geri dönmesi için bir callback URL'si içeren bir onay mesajını doğrudan WhatsApp'ta alır.
API entegrasyon örneği
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();Sonucu Sorgulayın
Kullanıcı akışa yeniden girdiğinde arka ucunuz, telefon numarasını doğrudan almak için daha önce açılan oturumun durumunu sorgular. Bu telefon numarasını kaydedip doğrulamayı başarılı olarak işaretleyebilirsiniz.
Durum sorgulama uygulaması
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;
};İpucu: Tamamlanana veya zaman aşımına uğrayana kadar doğrulama durumunu birkaç saniyede bir kontrol etmek için polling uygulayın.
Uç Durumları Yönetin
Bazen kullanıcılar WhatsApp'ı açar ama süreci tamamlamaz:
- WhatsApp izin penceresini reddederler
- Uygulama devre dışı bırakılmış veya silinmiştir
- Zayıf bağlantı nedeniyle mesaj gönderilirken takılı kalır
Nasıl yönetilir:
Sorunsuz zaman aşımı:
Birkaç dakika boyunca mesaj alınmazsa kullanıcıya şunu sorun:
Yeniden deneme mekanizması:
Yeni bir bağlantı oluşturan bir "WhatsApp ile yeniden gönder" düğmesi sunun.
Yedek seçenekler:
Kayıt sürecinin engellenmemesi için her zaman alternatif bir doğrulama kanalı sunun.
Durum kalıcılığı:
Kullanıcı daha sonra geri dönerse oturumunu açık tutun ve kayıt sürecini baştan başlatmaya zorlamadan doğrulama seçeneklerini yeniden sunun.
Uç durum yönetimi uygulaması
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'ı Olmayan Kullanıcılar için Yedek
canOpenURL (iOS) veya PackageManager (Android) WhatsApp'ın mevcut olmadığını algılarsa otomatik olarak SMS OTP'ye veya e-posta OTP'sine geçin.
Yedek uygulaması
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');
}
};Kullanıcı deneyimi ipucu: Kullanıcıların seçimi kendilerinin yapmasını gerektirmeyerek yedek geçişi kesintisiz hale getirin. Cihazları için mevcut en iyi yöntemi otomatik olarak kullanın.
Sonuç
Reverse OTP doğrulamayı daha hızlı, daha güvenli ve çoğu zaman SMS'ten daha ucuz hale getirir. Ancak uygulama izinlerinden mesaj teslim hatalarına kadar gerçek dünyadaki kesintilere göre tasarım yapmak, kullanıcıların her zaman sorunsuz bir ilerleme yolu bulması için kritiktir. İyi düşünülmüş bir yedek akışı, hem güvenliği hem de dönüşüm oranlarını en üst düzeye çıkarır.
