İçeriğe geç
Ondokuzon

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.

Teklif alın

Entegrasyon süreci

  1. İzin envanteri. Onay toplanan tüm noktaları, gösterilen metinleri ve mevcut izin listelerinizi çıkarırız.
  2. Erişimler. İYS ve SMS sağlayıcısı API erişimleri, gönderici adı ve test hesapları hazırlanır.
  3. Eşleme. Her sistemdeki izin alanının İYS'deki kanal ve alıcı tipine karşılığı belirlenir.
  4. Geliştirme. Onay aktarımı, ret senkronu ve SMS gönderim akışları kuyruklu yapıda yazılır.
  5. Test. Onay, ret, iletilemeyen mesaj ve erişilemeyen servis senaryoları denenir.
  6. İ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

Sık sorulan sorular

İYS nedir, kimler kayıt olmak zorunda?
İYS (İleti Yönetim Sistemi), ticari elektronik ileti onaylarının ve retlerinin kaydedildiği ulusal sistemdir. SMS, e-posta ya da arama yoluyla kampanya ve tanıtım iletisi gönderen işletmelerin kayıt olması ve izinlerini İYS'ye işlemesi gerekir. İşletmenizin durumunu ve istisnaları hukuk danışmanınızla netleştirmenizi öneririz.
İYS entegrasyonu nasıl yapılır?
İzinler İYS'ye ya doğrudan İYS'nin API'si üzerinden ya da SMS sağlayıcınızın sunduğu İYS hizmeti aracılığıyla aktarılır. Sitenizdeki, mağazanızdaki ya da CRM'inizdeki onay noktaları yeni izinleri kanal, alıcı tipi, kaynak ve tarih bilgisiyle gönderecek şekilde bağlanır. Alıcıların İYS üzerinden yaptığı değişiklikler de kendi listelerinize yansıtılır.
Sipariş ve kargo SMS'leri için İYS onayı gerekir mi?
Sipariş, kargo, ödeme ve tek kullanımlık kod gibi bilgilendirme mesajları genellikle ticari ileti sayılmaz ve İYS onayı aranmaz. Ancak bu mesajlara kampanya ya da indirim eklendiğinde ileti ticari niteliğe dönüşebilir. Şablonlarınızı bu ayrıma göre yazmanızı, sınırı hukuk danışmanınızla netleştirmenizi öneririz.
Alıcı İYS üzerinden ret verirse ne olur?
Ret İYS'de kayda geçer ve SMS sağlayıcıları ticari iletiyi göndermeden önce İYS'yi kontrol ettiği için mesaj o kişiye iletilmez. Yine de retin CRM'inize, e-posta platformunuza ve mağazanıza da yansıması gerekir; aksi halde başka bir kanaldan gönderim yapılabilir. Entegrasyon bu değişiklikleri düzenli olarak çekip ilgili kayıtları günceller.
Toplu SMS API hangi sistemlere bağlanabilir?
API sunan bir SMS sağlayıcısıyla Shopify ya da özel e-ticaret sitenizden, CRM'inizden, randevu sisteminizden veya ERP'nizden SMS gönderilebilir. Sipariş ve kargo bildirimleri, tek kullanımlık kodlar, randevu hatırlatmaları ve kampanyalar bu yolla otomatikleşir. İletim raporları da geri alınarak hangi mesajın ulaştığı kayda geçer.
Türkçe karakter kullanmak SMS maliyetini artırır mı?
Artırabilir. Türkçe karakterler, sağlayıcının kullandığı kodlamaya göre bir SMS'e sığan karakter sayısını azaltabilir ve mesaj daha fazla parçaya bölünür. Her parça ayrı ücretlendirildiği için şablonları gönderimden önce karakter sayısı açısından test ederiz.
İYS ve SMS entegrasyonunun maliyetini neler belirler?
Bağlanacak sistem sayısı, onay toplanan nokta sayısı, ret senkronunun kaç sisteme yansıyacağı, gönderilecek SMS türleri ve raporlama ihtiyacı maliyeti belirler. SMS gönderim ücretleri ve varsa İYS hizmet bedeli doğrudan ilgili kuruluşlara ödenir.

Hadi birlikte bir şeyler yapalım!

Projenizi anlatın, ihtiyacınızı netleştirelim ve size uygun yol haritasını birlikte çıkaralım.

Projeni anlat