TEKNİK REHBER · KAYNAKLI MÜHENDİSLİK NOTLARI

Kurumsal SMS ve OTP: teslim raporu, tekrar deneme ve güvenli entegrasyon

SMS API kabulü ile teslimi ayıran; OTP, işlem bildirimi, izin yönetimi, yinelenen gönderim ve alarm eskalasyonunu açıklayan uygulama rehberi.

Bir HTTP yanıtı, müşterinin mesajı okuduğu anlamına gelmez

SMS entegrasyonunda uygulama kabulü, operatöre gönderim ve teslim raporu ayrı olaylardır. Sağlayıcıların kullandığı durum isimleri değişebilir; bunları kendi sipariş veya işlem kimliğinizle ilişkilendirin. Örneğin Twilio belgeleri queued, sent ve delivered durumlarını ayırır; read durumu SMS için genel bir okundu kanıtı değildir. Bu kaynak teknik bir örnektir, MyFi Business’ın o sağlayıcıyı kullandığı iddiası değildir.

OTP ile tanıtım mesajını aynı akışa koymayın

Doğrulama kodu, işlem bildirimi ve pazarlama mesajı farklı amaçlara sahiptir. Gönderici başlığı, hedef ülke, alıcı türü, içerik ve izin gereksinimi devreye almadan önce değerlendirilir. Türkiye’de ticari elektronik ileti izinleri için İYS’nin resmî açıklamaları temel başvuru kaynağıdır. İşlem mesajına reklam eklemek içeriğin değerlendirmesini değiştirebilir; muafiyet varsayımıyla tasarım yapılmamalıdır. Geçerli koşulları kurumunuzun yetkili uyum sorumlusuyla ve hizmet sağlayıcıyla doğrulayın.

Tekrar denemede aynı işlemi iki kez bildirmeyin

Uygulama zaman aşımı aldığında sağlayıcı isteği kabul etmiş olabilir. Körlemesine tekrar göndermek aynı bildirimin iki kez ulaşmasına neden olur. İşlem kimliği, gönderim durumu ve yeniden deneme sınırı tutun; sağlayıcının desteklediği idempotency mekanizmasını kullanın. Desteklenmiyorsa uygulama tarafında yinelenmeyi önleyen iş kuyruğu kurun. Webhook bildirimleri geç veya farklı sırayla gelebilir; doğrulanmış olay zamanını ve son durumu birlikte işleyin. Durum belirsizse sınırsız yeniden gönderim yerine kontrollü inceleme uygulayın.

Doğrulama kodunun yaşam döngüsünü sınırlayın

OTP kısa ömürlü ve tek kullanımlı olmalı, deneme sayısı sınırlandırılmalı ve başarılı doğrulama sonrası geçersizleşmelidir. Kodları ve API anahtarlarını tarayıcıya veya genel erişilebilir günlük dosyasına koymayın. Yeniden kod isteme davranışı, önceki kodun durumu ve kullanıcıya gösterilecek hata açıkça tanımlanmalıdır. SMS, bütün kimlik doğrulama risklerini ortadan kaldırmaz; yüksek riskli işlemlerde ek doğrulama ihtiyacı ayrı değerlendirilir. Telefon numaralarının ve olay kayıtlarının erişimini görevle sınırlandırın.

Fabrika alarmında teslimat kadar sorumluluk önemlidir

Bir operasyon alarmı için “SMS gönder” adımı yeterli değildir. Hangi durumda kime, hangi sırayla ve ne kadar süre içinde bildirim yapılacağı belirlenmelidir. Teslim raporu gelmezse ya da sorumlu kişi olayı üstlenmezse ikinci kanal veya görevli devreye girebilir. Bu kurgu yerel emniyet mekanizmasının yerine geçmez. Özellikle üretim ve soğuk depo örneklerinde yerel kayıt, bağlantı yedeği ve insan eskalasyonu ayrı katmanlar olarak düşünülmelidir.

Kabul testini sınırlı ve izinli bir listeyle yapın

Geçerli numara, geçersiz numara, zaman aşımı, geciken webhook, yinelenen olay ve süresi dolan OTP senaryolarını kontrollü ortamda deneyin. Türkçe karakterlerin ve uzun mesajın segment sayısına etkisini sağlayıcı koşullarıyla birlikte kontrol edin. Örnek veri yerine gerçek müşteri listesi kullanmak zorunlu değildir. MyFi Business ve MyGroup ses/mesajlaşma ekibi, amaç, hacim, ülke, API entegrasyonu ve gönderici kapsamını değerlendirebilir; fiyat, teslim garantisi ve kullanım koşulları yazılı teklifle belirlenir.

Kaynaklar

Kaynak inceleme: 15.10.2026. Senaryolar açıklama amacıyla hazırlanmıştır; müşteri ölçümü veya ürün garantisi değildir.

Yazar ve yayın yaklaşımı
WhatsApp