Skip to content
Entegrasyon Rehberi
12 dk okuma30 Ağustos 2025

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.

Telefon doğrulama akışını gösteren Reverse OTP entegrasyon rehberi illüstrasyonu

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.

Reverse OTP entegrasyon akış diyagramı
1

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.

2

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://wa.me/PHONE_NUMBER?text=VERIFY-12345

Oluş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();
3

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.

4

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:

"Doğrulamanız tamamlanmamış görünüyor. Yeniden denemek mi yoksa SMS'e geçmek mi istersiniz?"
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);
5

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.