Test İçin SMS Onay: Kayıt ve Giriş Akışınızı Gerçek Numaralarla Sınamak

Her test gerçek SMS gerektirmez. Kodu üreten ve doğrulayan mantık, SMS servisini taklit eden birim testleriyle hızlıca sınanır; birçok SMS gönderim sağlayıcısı da geliştirme için test modu sunar. Gerçek numaraya şu sorulardan birinin cevabı için ihtiyaç duyarsınız:

• SMS gerçekten ulaşıyor mu? Gönderim servisiniz farklı ülke ve operatörlere mesaj iletebiliyor mu, gecikme ne kadar?
• Mesaj doğru görünüyor mu? Türkçe karakterler, mesaj uzunluğu, kodun metindeki yeri ve uygulama adının nasıl göründüğü.
• Numara biçimi doğru işleniyor mu? Ülke kodu, baştaki sıfır ve farklı uzunluktaki numaraların kayıt formunda ve veritabanında nasıl saklandığı.
• Yeniden gönderme ve sınırlar çalışıyor mu? Kodu tekrar gönder sayacı, süresi dolan kodun reddedilmesi ve art arda isteklerde hız sınırı.
• Kayıt uçtan uca tamamlanıyor mu? Sürüm öncesi duman testinde yeni bir kullanıcının kayıttan ilk girişe kadar ilerleyebilmesi.

Doğru numara türü, test senaryosunda aynı numaraya kaç SMS gelmesi gerektiğine bağlıdır.

Testleri sürekli entegrasyon hattına bağlamak istiyorsanız panelden elle SMS onayı almak yerine API'yi kullanın. Anahtarınızı panelde API sayfasından alır, her isteğe X-Api-Key başlığıyla eklersiniz. Uç noktaların ayrıntıları ve örnek yanıtlar API belgesinde; tipik bir test adımı şöyle ilerler:

• Fiyat ve stok: GET /api/quote ile servis ve ülke için fiyatı, stoku ve başarı oranını alın.
• Numara al: POST /api/activations ile numarayı alın; yanıttaki phone alanında numara ülke koduyla birlikte gelir.
• Uygulamanızı tetikleyin: Test betiğiniz numarayı kayıt formuna yazar ve kod gönderimini başlatır.
• Kodu okuyun: GET /api/activations/:id ile durumu 3-5 saniyede bir sorgulayın. Kod gelince status received olur; code alanında kod, text alanında SMS'in tam metni bulunur, böylece mesaj şablonunuzu da aynı testte doğrularsınız.
• Kapatın: Kod kullanıldıysa finish, gelmediyse numarayı aldıktan 1 dakika sonra cancel çağırın; iptalde ücret bakiyeye döner.

Sürekli sorgulamak yerine panelin API sayfasından bir webhook adresi tanımlayabilirsiniz. Tek SMS işlemlerinde kod geldiğinde (activation.received), süre dolduğunda (activation.timeout) ya da işlem iptal edildiğinde (activation.canceled) bu adrese JSON gövdeli bir POST isteği gönderilir. Kurulumu sınamak için panelden bir test olayı da tetikleyebilirsiniz.

• İmzayı doğrulayın: X-Smsonay-Signature başlığı, gövdenin API anahtarınızla hesaplanmış HMAC-SHA256 imzasıdır. İmzası tutmayan isteği reddedin.
• Adres dışarıdan erişilebilir olmalı: Canlı ortamda yalnızca https adresler kabul edilir; yerel ve özel ağ adresleri kabul edilmez. Test ortamınız dışarıya kapalıysa sorgulama yöntemiyle devam edin.
• Yeniden deneme sınırlıdır: Ağ hatasında istek 3 saniye sonra bir kez daha gönderilir. Kritik testlerde webhook gelmese bile durumu sorgulayan bir yedek adım bırakın.
• Kimlikle eşleştirin: Gövdedeki activation.id alanını test çalıştırmanızın kaydıyla eşleştirin; paralel testlerde kodların karışmasını önler.

Test için alınan numaralar geçicidir. Bu yüzden baştan bir düzen kurmak, kodların ve hesapların birbirine karışmasını önler:

• Ayrı hesap ve anahtar: Test bütçesini ve API anahtarını, ekibin SMS onay sitesindeki günlük hesabından ayırın. Anahtar hesabın tam yetkisini taşır; kod deposunda değil, CI sisteminizin gizli değişkenlerinde saklayın.
• Test kullanıcılarını işaretleyin: Uygulamanızda test hesaplarını e-posta etiketi ya da bir bayrakla ayırın; büyüme ve dönüşüm metrikleriniz kirlenmez.
• Test verisini temizleyin: Numara işlem bitince sizden ayrılır ve ileride başka birine verilebilir. Testten sonra bu numaraya bağlı hesabı silin ya da devre dışı bırakın; gerçek bir hesabı test numarasına asla bağlamayın.
• Bütçeyi öngörün: Her test çalıştırmasında SMS onayı almak küçük de olsa bir maliyettir, ama yalnızca kodun geldiği numara ücretlendirilir. Başarı oranı yüksek ve fiyatı düşük ucuz SMS onay seçenekleri düzenli testlerin maliyetini düşürür.

Test için SMS onay, sahibi olduğunuz ya da test etme yetkisini yazılı olarak aldığınız uygulamalar içindir. Üçüncü taraf bir platformda toplu hesap açmak ya da bir hizmetin hız sınırlarını ve hesap kurallarını aşmak için test gerekçesi kullanılamaz; başkasına ait bir uygulamada seri WhatsApp SMS onay işlemleri yapmak test değil, platform kurallarının ihlalidir. Bu tür kullanım kullanım koşullarımıza aykırıdır ve hesabın kapatılmasına yol açabilir.

Kapsamı da bilin: numaralar yalnızca SMS alır, sesli aramayla gönderilen kodlar bu yöntemle sınanamaz. Türkiye numarası sunulmadığı için yurt içi operatör teslimatını kendi hatlarınızla test etmeniz gerekir. Bir SMS onay sitesi API'sini kendi ürününüzde müşterilere sunmayı düşünüyorsanız bu ayrı bir konudur; akışı bayilik rehberinde anlattık.