SMS ile OTP Otomatik Doldurma: Android, iOS ve Web Formatları

Your Example code is 123456.

@example.com #123456

Webde OTP otomatik doldurma nasıl çalışır?

Önce özniteliği ekleyin, ardından bunu destekleyen tarayıcılar için JavaScript'i.

<input type="text" inputmode="numeric"
       autocomplete="one-time-code" name="otp" />

Chrome'un belgeleri tarayıcılar arası uyumluluk için özniteliği önerir ve Safari'nin WebOTP JavaScript API'sine sahip olmasa da doğru biçimlendirilmiş bir SMS'ten kodu önermek için bu özniteliği kullandığını belirtir.

Android'deki Chrome için WebOTP'yi sms taşıma yöntemiyle çağırın. API güvenli bir kaynak (HTTPS) gerektirir; AbortController ise kullanıcı kodu elle yazarsa bekleyen isteği iptal etmenizi sağlar.

if ("OTPCredential" in window) {
  const ac = new AbortController();
  const form = document.querySelector("form");
  const input = document.querySelector("input[autocomplete=one-time-code]");

  form.addEventListener("submit", () => ac.abort());

  navigator.credentials
    .get({ otp: { transport: ["sms"] }, signal: ac.signal })
    .then((otp) => {
      input.value = otp.code;
      form.submit();
    })
    .catch(() => {}); // user dismissed, or no matching SMS
}

SMS, WICG spesifikasyonundaki ve Chrome rehberindeki kaynağa bağlı formata uymalıdır: son satırdan önce en az bir rakam içeren dört ila on alfanümerik karakterlik bir kod, ardından @, host, tek bir boşluk ve # ile kodla başlayan bir son satır. Host boşluk içermemelidir.

Tek bir SMS Android, iOS ve webde çalışabilir mi?

Çoğu zaman evet, çünkü kurallar uyumludur. Okunabilir metni başa, Android hash'ini sonun bir üst satırına, alana bağlı satırı ise en sona koyun. Bu düzen belgelenmiş kurallardan türetilmiştir, bir sağlayıcı garantisi değildir; bu yüzden test edin.

Your Example code is 483921. Do not share it.
Ab3dE+9xYz1
@example.com #483921

Bu sıranın nedeni: Apple ve web spesifikasyonu alan adını ve kodu son satırda ister. Google 11 karakterlik hash'in mesajın bir yerinde olmasını şart koşar, ancak baktığımız sayfada konumunu sabitlemez. Yukarıdaki örnek düz Latin karakterlerle 78 bayttır; 140 baytlık sınırın rahatça içindedir.

Yayına almadan önce kontrol listesi:

1. Kod tek bir parçadır ve metindeki diğer rakamlardan açıkça ayrılmıştır.
2. Son satırdaki alan adı siteyle ve uygulamanın ilişkili alan adıyla eşleşir.
3. Retriever varyantı için toplam uzunluk 140 baytın içindedir.
4. Hash, test edilen sürümün imza anahtarıyla eşleşir.
5. Her platformdan bir telefonda ve gerçekten kullandığınız operatörlerde test edilmiştir.

Arapça ve Unicode metin için ne yapmalı?

Kodu ve iki makine tarafından okunan bölümü sade tutun. Google'ın sınırı bayt cinsindendir ve Unicode bir SMS, GSM-7 olanından çok daha az karakter alır: tek parçada 70'e karşı 160 (SMS karakter sınırları ve Unicode yazısına bakın). Bu yüzden Arapça bir cümle bütçeyi hızla tüketir ve GSM-7 dışı tek bir karakter mesajın tamamını Unicode'a çevirir.

Güvenli yaklaşım: kodu Latin rakamlarla yazın, @alan_adı #kod kısmını ASCII tutun ve Arapça ifadeyi kısa bırakın. Başka rakam sistemleriyle yazılmış kodların otomatik doldurulmasını anlatan resmî bir belge bulamadık; bu yüzden konuyu dışarıda bırakıyor ve kullanmadan önce test etmenizi öneriyoruz.

WhatsApp kimlik doğrulama şablonları otomatik doldurmayı nasıl ele alır?

Meta'nın kimlik doğrulama şablonları üç düğme stiliyle gelir ve her birinin gövde metni sabittir: <code> is your verification code.

Meta'nın belgeleri ayrıca iOS 26 ve sonrasında klavye önerilerinin entegrasyon olmadan otomatik doldurma sağladığını ve sıfır dokunuşu desteklemeyen platformlardaki kullanıcıların kodu kopyala düğmesi aldığını belirtir. code_expiration_minutes ile bir geçerlilik süresi belirleyebilirsiniz; önizleme API'si 1 ila 90 dakika arasındaki değerleri kabul eder. Kanalları WhatsApp OTP ve SMS OTP yazısında karşılaştırın.

Uygulamalı örnek: bir araç çağırma uygulamasında giriş

"Qafila Rides" (kurgusal), bir Android uygulaması, bir iOS uygulaması ve qafila.example adresinde bir mobil siteye sahip.

1. Android uygulaması, kullanıcı "Kodu gönder"e dokunduğunda SMS Retriever'ı başlatır.
2. Arka uç, birkaç dakika geçerli altı haneli bir kod üretir ve yukarıdaki üç satırlı mesajı SMS API ile gönderir.
3. Android mesajı uygulamaya iletir. iOS kodu klavyenin üstünde sunar. Mobil sitede Safari kodu önerir, Chrome ise WebOTP ile doldurur.
4. Sunucu kodu bir kez doğrular, yeniden kullanımı ve süresi dolmuş kodları reddeder ve istekleri hız sınırına tabi tutar.
5. SMS kısa bir zaman aşımı içinde doğrulanmazsa arka uç ikinci yol olarak bir WhatsApp kimlik doğrulama şablonu sunar.

Sık yapılan hatalar nelerdir?

• Kodun yalnız olmaması. Kodun yanındaki ek sayılar (telefon, fiyat, tarih) algılamayı şaşırtır. Her mesajda tek kod kullanın.
• Yanlış hash. Hash imza sertifikasını izler. Hata ayıklama anahtarından alınan hash, üretim sürümüyle eşleşmez.
• Alan adı uyuşmazlığı. @example.com, site ya da ilişkili alan adıyla eşleşmelidir; aksi halde iOS ve WebOTP kodu sunmaz.
• Bozuk son satır. #kod'dan sonra gelen herhangi bir şey, eksik bir boşluk veya alan adı içindeki boşluk formatı bozar.
• Çok uzun ya da Unicode ağırlıklı mesaj, 140 baytlık Retriever sınırını aşar.
• Geç dinlemeye başlamak. User Consent API, başlamadan önce alınan mesajları yok sayar.
• Otomatik doldurmayı güvenlik saymak. Otomatik doldurma bir kolaylıktır. Yine de sunucu tarafında doğrulayın, kodların süresini dolurun, deneme sayısını sınırlayın ve SMS pumping dolandırıcılığına dikkat edin.
• Kapsam. Bu rehber, yazıldığı andaki belgelenmiş davranışı kapsar. Platform kuralları değişir; yayından önce bağlantılı kaynakları kontrol edin.

Mesaj metni ve geçerlilik süresi seçimleri için OTP ve kimlik doğrulama mesajları rehberimize bakın.

OmniChannels.ai nasıl yardımcı olur?

OmniChannels.ai, BroadNet'in doğrudan operatör bağlantısı üzerinden OTP'yi SMS ve WhatsApp ile gönderir; böylece otomatik doldurma formatınızın dayandığı mesaj metnini birebir kontrol edebilirsiniz. WhatsApp şablonları kodu kopyala, tek dokunuş ve sıfır dokunuş kimlik doğrulamayı kapsar. Kanal yedeklemesi, örneğin önce WhatsApp sonra SMS, kullanım senaryosu başına yapılandırılır ve iletim durumları tek bir webhook formatıyla gelir. SMS API belgelerine, WhatsApp API belgelerine ve OTP çözümüne bakın.