Farklı uygulamaların SMS gönderimlerinin merkezi API katmanında birleştirilmesi
Çözümün özeti CRM, sipariş yönetimi, insan kaynakları ve üyelik uygulamalarının her biri SMS sağlayıcısına ayrı bağlandığında servis şifreleri çoğalır, hata yönetimi farklılaşır ve merkezi izleme zorlaşır. Tek API katmanı, uygulama ekiplerinin mesaj göndermesini kolaylaştırırken izin kurallarını ve mesaj türlerini koruyacak ortak bir kontrol noktası sunmalıdır. Mimarinin değeri yalnız entegrasyon sayısını azaltmak değil; işlemsel ve ticari gönderimleri tutarlı yönetmektir.
Problemin kapsamı ve karar çerçevesi Birden çok ürünün ayrı SMS bağlantıları kurması kimlik bilgilerini çoğaltır, raporları parçalar ve aynı numaraya birbirinden habersiz mesaj atılmasına neden olabilir. Merkezi servis katmanı; uygulamadan bağımsız mesaj modeli, istemci kimlik doğrulama, gönderim öncesi iş kuralı, kuyruk, hata/yeniden deneme ve operasyonel ölçüm noktaları oluşturur. Teknolojik taşıma işlevi ile ticari ileti izin kontrolü ayrı değerlendirilmelidir. Bir API çağrısının başarılı olması operatör tesliminin de başarılı olduğu anlamına gelmez. İyi tasarım hata durumunu açıklanabilir ve yeniden işlenebilir kılar.
Başlamadan önce hazırlanacaklar
- Mesaj gönderen tüm uygulamaları ve gönderim hacmi/tetikleyici türlerini haritalayın.
- İşlemsel, OTP, operasyonel ve ticari mesajlara ayrı öncelik ve kural setleri tanımlayın.
- API kimlik bilgisi, gönderici başlığı ve yetkili iş birimleri için erişim matrisi çıkarın.
- Hata kodu, tekillik, yeniden deneme ve mesaj sonuçlarının merkezi şemasını hazırlayın.
Adım adım uygulama planı
| Aşama | Uygulanacak işlem |
|---|---|
| 1. Ortak mesaj sözleşmesi tasarlayın | Gönderilecek numara, kanal/tür, gönderen uygulama, şablon, işlem kimliği ve varsa kampanya bilgisinden oluşan açık API modeli hazırlayın. Uygulamaların serbest biçimde gizli veri eklemesini sınırlayın. |
| 2. Güvenlik ve yetki katmanı kurun | Her uygulamaya ayrı kimlik ve gönderim yetkisi tanımlayın. Şifreleri kod içine gömmeyin, erişimleri takip edin ve gereğinde anahtar döndürme prosedürü uygulayın. |
| 3. İzin ve mesaj türü kontrolü ekleyin | Ticari SMS için İYS/ret denetimini gönderimden önce işletin. İşlemsel mesaj akışını başka bir hukukî sınıflandırmaya göre yönetin; OTP'nin kampanya kuyruğunda gereksiz gecikmesini önleyin. |
| 4. Kuyruk ve hata işlemeyi merkezîleştirin | Geçici servis hatası için kontrollü yeniden deneme, kalıcı hata için açıklanabilir son durum tanımlayın. Aynı talebin iki kez SMS üretmemesi için işlem anahtarı kullanın. |
| 5. Operasyon izleme oluşturun | Uygulama, gönderici başlığı, mesaj tipi ve hata nedeni kırılımında rapor üretin. Entegrasyona yeni uygulama katarken ortak test ve güvenlik kontrol listesini kullanın. |
Örnek uygulama senaryosu Bir şirketin e-ticaret uygulaması sipariş SMS'i, CRM sistemi kampanya mesajı ve kullanıcı portalı OTP gönderir. Her uygulama merkezi API katmanını kullanır; ortak platform ticari mesajlarda güncel ret kontrolü yapar, OTP için farklı hız/öncelik kuralı uygular ve sonuçları kaynak uygulama kimliğiyle raporlar.
Özel karar noktası Merkezi SMS katmanında bütün uygulamalara aynı izin verilmesi, güvenlik ve maliyet yönetimini zorlaştırır. Örneğin e-ticaret sistemi sipariş şablonlarını, pazarlama ekibi kampanya başlıklarını, kimlik sistemi ise OTP akışını kullanmalıdır. Kimlik bilgileri, gönderici başlığı ve hız sınırı uygulamaya göre ayrılmalıdır. Böylece bir uygulamanın yanlış konfigürasyonu diğer kritik iletişimleri etkilemez. API başarısı ile mesaj teslimatını ayrı izlemek de uygulama sahiplerinin doğru hata nedeni görmesini sağlar.
Kontrol ve başarı göstergeleri
| Gösterge | Kontrol yaklaşımı |
|---|---|
| Aktif ayrı entegrasyon | Birleştirme öncesi ve sonrası doğrudan sağlayıcı bağlantısı sayısını karşılaştırın. |
| Hata çözüm süresi | Başarısız SMS çağrılarının tespit ve çözüm süresini izleyin. |
| Mükerrer gönderim | Tek bir işlem için gereksiz çift SMS üretimini ölçün. |
| İzin kontrol kapsamı | Ticari mesajların hangi oranında merkezî ret/izin kontrolü işletildiğini denetleyin. |
Mobildev çözümleriyle ilişki GİP (Güvenli İletişim Platformu), kurumsal SMS gönderimini çoklu uygulama ve veri kaynağı ortamında merkezi yönetmek için değerlendirilebilir. SMS API geliştiricilerin uygulamalarını SMS servisine bağlamasına yardımcı olur. İVT Lite, ticari mesajların ETK/İYS izin ve ret katmanını destekleyebilir. Kurulacak ara servis, kuyruk ve yetkilendirme mimarisi kurum projesine göre tasarlanmalıdır.
Sık yapılan hatalar ve önleyici kontroller
- OTP ve kampanya mesajlarını aynı kontrolsüz kuyruğa koymak.
- Tüm uygulamalarda ortak admin API anahtarı kullanmak.
- API çağrısı başarısını operatör teslimiyle eşitlemek.
Devreye alma ve yaygınlaştırma planı İlk aşamada uygulamalar ve mesaj türleri envanterlenerek ortak bir veri ve hata sözlüğü hazırlanmalıdır. İkinci aşamada tek bir düşük riskli uygulama üzerinden adaptör veya merkezî servis denenir; farklı hata ve teslimat durumları log ile doğrulanır. Üçüncü aşamada işlemsel ve ticari mesaj ayrımı, ret kontrolü, hız sınırları, yetki kısıtları ve geri dönüş prosedürü test edilerek kapsam genişletilir. Operasyona teslim edilecek teknik dokümanda hangi ekibin API anahtarını yönettiği, yeniden denemenin ne zaman yapılacağı ve neyin başarı sayıldığı açıkça belirtilmelidir. Test kodunun canlı konfigürasyonla karışmadığı ve tek işlemden iki mesaj çıkmadığı da kontrol edilmelidir.
Yayına alma / tamamlanma kontrolü Çalışmanın tamamlandığına yalnız ayarın açılması veya entegrasyonun kurulmasıyla karar verilmemelidir. Öncelikle 'Ortak mesaj sözleşmesi tasarlayın' aşamasında tanımlanan kayıt veya kararın gerçek örneklerde doğru üretildiği gösterilmelidir. Ardından 'OTP ve kampanya mesajlarını aynı kontrolsüz kuyruğa koymak.' riskinin sahada gerçekleşmediğini kanıtlayan bir negatif test uygulanmalıdır. 'Aktif ayrı entegrasyon' göstergesinin başlangıç değeri ve pilot sonrası sonucu kaydedilmelidir. Son kabul raporunda işlem sahibi, test tarihi, örnek kayıt, karşılaşılan istisna ve kapatma kararı yer almalı; sonraki sürümlerde aynı senaryo tekrar kontrol edilmelidir.
Görev paylaşımı ve operasyonel sahiplik Mimari ekip ortak mesaj ve hata sözlüğünü; uygulama sahipleri tetikleyicileri; güvenlik kimlik/yetkiyi; operasyon servis sağlık göstergelerini; hukuk ticari mesaj sınıflamasını yönetir.
Mevzuat ve kapsam sınırı GİP ile SMS API'nin kurumun mevcut mimarisine hangi düzeyde yerleşeceği proje bazında belirlenir; belgelenmeyen SLA, hız veya entegrasyon iddiası verilmez.
İlgili ürün ve resmî kaynaklar
- Mobildev ürün/dokümantasyon kaynağı: https://www.mobildev.com/gip
- Mobildev ürün/dokümantasyon kaynağı: https://www.mobildev.com/sms-api