Entegrasyon
İYS Entegrasyonu ve SMS Entegrasyonu: İzin Kaydı, Ret Senkronu ve Toplu SMS API
İYS entegrasyonu, sitenizde, mağazanızda ya da CRM'inizde aldığınız ticari ileti onaylarını İleti Yönetim Sistemi'ne kaydeden ve retleri geri getiren bağlantıdır. SMS sağlayıcınızın API'sini de aynı kurguyla bağlıyoruz.
İYS entegrasyonu, ticari ileti onaylarını aldığınız her noktayı (üyelik formu, ödeme sayfası, kayıt pop-up'ı, CRM) İleti Yönetim Sistemi'ne bağlar. İYS, SMS, e-posta ve arama yoluyla gönderilen ticari elektronik iletilerin onay ve ret kayıtlarının tutulduğu ulusal sistemdir. Onay İYS'de kayıtlı değilse kampanya SMS'iniz alıcıya ulaşmaz; alıcı İYS'den ret verdiyse bunu kendi sistemlerinize de yansıtmanız gerekir.
SMS entegrasyonu ise mesajın kendisiyle ilgilidir: sipariş, kargo ve randevu bildirimlerinin, tek kullanımlık kodların ve kampanyaların SMS sağlayıcınızın API'si üzerinden sistemlerinizden gitmesi. İki işi birlikte kuruyoruz, çünkü bir SMS'in kime gidebileceğine İYS'deki kayıt karar verir. Bu sayfada teknik kurguyu anlatıyoruz; hukuki ayrıntılarda hukuk danışmanınızın görüşünü almanızı öneririz. Diğer bağlantı türleri entegrasyon hizmetleri sayfasında.
Kısaca İYS'de kanallar, onay ve ret
- İzinler üç kanal için ayrı tutulur: mesaj (SMS), e-posta ve arama. E-posta onayı SMS göndermeye izin vermez.
- Onay, alıcının ticari ileti almayı kabul ettiğini gösteren kayıttır. İYS'ye kanal, alıcı tipi (bireysel ya da tacir), onayın alındığı kaynak ve tarihle gönderilir.
- Alıcı ret hakkını istediği an kullanabilir. Ret, mesajdaki bağlantıyla, SMS'e verilen cevapla ya da doğrudan İYS üzerinden gelebilir.
- SMS sağlayıcıları ticari iletiyi göndermeden önce İYS'deki kaydı kontrol eder.
- Sipariş, kargo, ödeme ve tek kullanımlık kod mesajları bilgilendirme iletisidir ve genellikle ticari ileti sayılmaz. İçlerine kampanya eklendiğinde durum değişebilir.
İYS entegrasyonu nasıl kurulur?
Onay toplama noktaları
Her onay noktası için hangi kanala onay verildiği, hangi metnin gösterildiği, onayın hangi formdan ve hangi tarihte geldiği kaydedilir. Bu bilgiler hem İYS'ye gönderim hem de olası bir şikâyette ispat için gereklidir. Onay kutularını önceden işaretli bırakmıyor, SMS ve e-posta iznini ayrı ayrı soruyoruz. Mağazada ya da çağrı merkezinde alınan onaylar da aynı entegrasyona bağlanabilir; bunun için kasadaki ya da çağrı merkezi ekranındaki izin alanının aynı kayıt yapısını kullanması gerekir.
İYS'ye aktarım
Yeni onaylar İYS'ye ya doğrudan İYS'nin API'si üzerinden ya da SMS sağlayıcınızın sunduğu İYS hizmetiyle aktarılır. Aktarım arka planda kuyrukla yürür; İYS erişilemediğinde kayıt bekletilir ve yeniden denenir. Yeni onayların mevzuatta belirtilen süre içinde İYS'ye işlenmesi gerektiği için başarısız aktarımlar bir hata listesine düşer ve bildirim üretir.
Ret senkronu
Ret en çok atlanan adımdır. Alıcı İYS üzerinden ya da bir SMS'e cevap vererek ret verdiğinde bu bilgi tüm listelerinize yansımalıdır:
- Shopify ya da e-ticaret sitenizdeki pazarlama izni
- E-posta platformunuzdaki abonelik durumu
- CRM'deki müşteri kartı (özel CRM yazılımı kullanıyorsanız izin geçmişi kartta tutulur)
- SMS sağlayıcısındaki gönderim listeleri
Entegrasyon İYS'deki izin değişikliklerini düzenli olarak çeker ve bu sistemleri günceller. Ters yönde de çalışır: sitenizde abonelikten çık bağlantısına tıklayan kişinin reddi İYS'ye yazılır.
Shopify ve e-ticaret sitelerinde İYS
Shopify'da pazarlama izni ödeme sayfasındaki kutuyla ve müşteri hesabından toplanır, ancak Shopify bu izni İYS'ye kendisi göndermez. Müşteri kaydı ve izin değişiklikleri Shopify'ın webhook'larıyla yakalanıp İYS'ye aktarılır. Ödeme sayfasındaki izin metninin ve onay adımının doğru kurulması bu işin ilk parçasıdır; mağaza tarafındaki bağlantıları Shopify entegrasyonları sayfasında anlattık. E-posta tarafındaki izin akışı Klaviyo ve e-posta pazarlama sayfasında.
SMS entegrasyonu ve toplu SMS API
SMS sağlayıcılarının çoğu, sistemlerinizden mesaj göndermek için bir API sunar. Entegrasyonla şu mesajlar kendiliğinden gider:
- Sipariş onayı, kargoya verildi ve teslim edildi bildirimleri
- Üyelik ve giriş için tek kullanımlık kodlar
- Randevu hatırlatmaları ve erteleme bağlantıları (online randevu sistemi)
- Ödeme ve tahsilat hatırlatmaları
- İzinli listelere kampanya gönderimleri
Teknik tarafta dikkat ettiğimiz noktalar:
- Mesajın hangi gönderici adıyla görüneceği SMS sağlayıcınız üzerinden kaydedilir ve onaylanır. Bu adımı projenin başında başlatırız.
- Sağlayıcılar bilgilendirme ve ticari gönderimleri ayrı işaretler, ticari gönderimlerde İYS kontrolü yapılır.
- Türkçe karakterler, kodlamaya göre bir SMS'e sığan karakter sayısını azaltabilir. Her parça ayrı ücretlendirildiği için şablonları gönderimden önce test ederiz.
- Hangi numaraya iletildiğini, hangisine iletilemediğini gösteren iletim raporları geri alınır ve kayda geçer.
- Aynı sipariş için aynı SMS iki kez gitmez. Sağlayıcı hata verdiğinde mesaj kuyrukta bekletilip yeniden denenir.
- WhatsApp'ta iletilemeyen kritik bildirimler yedek kanal olarak SMS'e düşebilir. Bu kurguyu WhatsApp Business API sayfasında anlattık.
Tek kullanımlık kod gönderen formlarda bir önlem daha gerekir: aynı numaraya ve aynı IP adresinden art arda gelen istekler sınırlanır, kodun geçerlilik süresi kısa tutulur ve gerekmiyorsa yurt dışı numaralara gönderim kapatılır. Bu önlemler olmadan kötü niyetli toplu istekler SMS faturanızı kısa sürede büyütebilir. Mantığını rate limiting ve throttling yazımızda anlattık.
İzin yönetiminde sık yapılan hatalar
- Tek bir onay kutusuyla SMS, e-posta ve aramaya birlikte izin istemek. Oysa kanallar İYS'de ayrı tutulur.
- Onayın nereden ve ne zaman alındığı belli olmayan listelerle kampanya göndermek.
- Onayları İYS'ye yazıp İYS'deki retleri geri çekmemek, yani senkronu tek yönlü bırakmak.
- Bilgilendirme mesajına kampanya eklemek. Kargo SMS'ine eklenen bir indirim kodu mesajın niteliğini değiştirebilir.
- E-posta platformu, SMS paneli ve CRM'de dağınık, ayrı listeler tutmak. Bu durumda ret birinde güncellenir, diğerinde unutulur.
İzinlerinizin ve SMS akışlarınızın haritasını çıkaralım
Onay topladığınız formları, kullandığınız SMS sağlayıcısını ve CRM ya da mağaza altyapınızı paylaşın. Hangi verinin hangi yönde akması gerektiğini birlikte belirleyelim.
Entegrasyon süreci
- İzin envanteri. Onay toplanan tüm noktaları, gösterilen metinleri ve mevcut izin listelerinizi çıkarırız.
- Erişimler. İYS ve SMS sağlayıcısı API erişimleri, gönderici adı ve test hesapları hazırlanır.
- Eşleme. Her sistemdeki izin alanının İYS'deki kanal ve alıcı tipine karşılığı belirlenir.
- Geliştirme. Onay aktarımı, ret senkronu ve SMS gönderim akışları kuyruklu yapıda yazılır.
- Test. Onay, ret, iletilemeyen mesaj ve erişilemeyen servis senaryoları denenir.
- İzleme. Başarısız aktarımlar, iletim oranları ve ret sayıları panelden takip edilir.
Kaynağı ve onay tarihi bilinmeyen eski listelerle kampanya göndermeden önce bu listelerin durumunu hukuk danışmanınızla birlikte değerlendirmenizi öneririz.
Maliyeti belirleyen kalemler
- Onay toplanan nokta ve bağlanacak sistem sayısı
- Ret senkronunun yansıyacağı sistemler (mağaza, CRM, e-posta platformu)
- SMS türleri (bildirim, tek kullanımlık kod, kampanya)
- İletim raporu ve hata ekranı ihtiyacı
- Yayın sonrası izleme ve bakım
SMS gönderim ücretleri ve varsa İYS hizmet bedeli doğrudan ilgili kuruluşlara ödenir. Entegrasyonların yayından sonraki takibi bakım ve destek kapsamında yürür.
İlgili canlı işlerimiz
- Shopify'da mesafeli satış sözleşmesi onay kutusunun ödeme öncesine eklenmesi ve sözleşme PDF'inin sipariş e-postasına eklenmesi
- Laravel kuyrukları ve zamanlayıcıyla çalışan, hata olunca yeniden deneyen entegrasyonlar
SSS