İYS Entegrasyonu

İYS (İleti Yönetim Sistemi) hesabınızı bir kanala bağlayın: bu kanalda verilen ve geri alınan her ticari ileti izni İYS'ye kendiliğinden bildirilir, alıcıların doğrudan İYS üzerinden verdiği retler de Selwise'e geri gelir.

Panelde nerede

Sol menüde Ayarlar → Mesajlaşma Sağlayıcıları, oradan İYS (/dashboard/settings/messaging/iys). Ayar kanal başınadır: üstteki kanal seçicide hangi kanal seçiliyse onun İYS bağlantısını görürsünüz. Ekranı açmak için Mesajlaşma modülü ve mesajlaşma görüntüleme yetkisi, bağlantıyı kurmak ve test etmek için mesajlaşma yönetme yetkisi gerekir.

Kim bildirir

İYS hesabı sizindir. Hizmet sağlayıcı sizsiniz; izinler sizin İYS numaranız ve marka kodunuz altında kaydedilir. Selwise İYS üyesi değildir ve kendi adına hiçbir şey bildirmez: İYS'yi sizin adınıza, sizin API kullanıcınızla çağırır. E-posta ve SMS sağlayıcınızda olduğu gibi, gönderen taraf siz kalırsınız.

Bağlamadan önce

Gerekli	Nereden
İYS numarası	İYS Web (hs.iys.org.tr) hesabınız
Marka kodu	Aynı hesapta, markalar listesi
API kullanıcı adı ve şifresi	İYS Web'de hesap sahibi veya hesap yöneticisinin oluşturduğu API kullanıcısı. Yönetici kullanıcı token alamaz; ayrı bir API kullanıcısı gerekir.
IP izni	Canlı ortam yalnızca izin verilen IP adreslerinden gelen istekleri kabul eder. Selwise sunucusunun çıkış IP adresini İYS hesabınızdaki API IP listesine ekleyin; adresi hesap yöneticinizden alın.

Test ortamı (sandbox) herkese açık değildir: İYS'ye kayıtlı bir hizmet sağlayıcı test API kullanıcısını İYS Web'de oluşturur ve test ortamı kendi İYS numarasını ve marka kodunu atar. Test ortamında gerçek veri yoktur.

Bağlantıyı kurma

1. İYS numarasını, marka kodunu, API kullanıcı adını ve şifreyi girin.
2. Ortamı seçin: Canlı ya da Test.
3. Varsayılan alıcı tipini seçin. Tüketicilere satış yapıyorsanız Bireysel, işletmelere satış yapıyorsanız Tacir.
4. İYS'ye bildir anahtarı açıkken kaydedin.

Kaydettiğinizde Selwise gerçek bir bağlantı testi yapar: token alır ve markanızın değişiklik listesini okur. Hiçbir izin yazılmaz. Test başarılı olursa entegrasyon açılır; başarısız olursa bilgiler kaydedilir ama entegrasyon kapalı kalır ve İYS'nin cevabı anahtarın altında görünür. Şifre bir kez kaydedildikten sonra ekrana bir daha gelmez; şifre kutusunu boş bırakarak kaydederseniz kayıtlı şifre korunur.

Ne bildirilir

Bir kişinin izni değiştiğinde, değişiklikle aynı işlemde bir bildirim kuyruğa yazılır ve en geç bir dakika içinde İYS'ye gönderilir.

Değişiklik	İYS'ye giden	Kaynak
Bülten formunda abone olma (web)	ONAY	HS_WEB
Bülten formunda abone olma (uygulama kanalı)	ONAY	HS_MOBIL
Sipariş sırasında izin verme veya geri alma	ONAY veya RET	HS_WEB ya da HS_MOBIL
Kendi sunucunuzdan izin API'si ile gelen karar	ONAY veya RET	HS_WEB ya da HS_MOBIL; isteğe iysSource eklerseniz o kaynak
E-postadaki abonelikten çık bağlantısı	RET	HS_EPOSTA
Abonelikten çıkış sayfasındaki tekrar abone ol düğmesi	ONAY	HS_EPOSTA
Panelde bir kişiyi abonelikten çıkarma	RET	HS_KARAR

E-posta adresleri EPOSTA, telefon numaraları MESAJ tipiyle bildirilir. Telefonlarda yalnızca Türkiye numaraları (+90) bildirilir; İYS yalnızca onları kaydeder.

Ne bildirilmez

• Panelde elle verilen izin. Bir panel kullanıcısının "bu kişi izin verdi" demesi İYS'ye bildirilebilecek bir kanıt değildir. İzni İYS'ye kendiniz kaydedin; kayıt İYS'den geri geldiğinde kişi kendiliğinden güncellenir.
• Giriş ile gelen adres. Giriş yapmak izin vermek değildir.
• Geçmiş veri aktarımı, dosya izin satırında hem tarihi (at) hem de source alanında geçerli bir İYS kaynağını (örneğin HS_FIZIKSEL_ORTAM) taşımıyorsa. Satır iys: registered diyorsa izni zaten siz kaydetmişsinizdir; tekrar bildirilmez.
• İzin API'sinde iys alanı dolu gelen karar. O alan izni İYS'ye kendinizin kaydettiğini söyler.
• Entegrasyonu bağlamadan önce toplanan izinler. Bunları İYS'nin kendi toplu yükleme aracıyla kaydetmeniz gerekir.

İYS'den gelenler

Alıcılar İYS'nin web sitesi, mobil uygulaması veya kısa mesaj hattı üzerinden markanız için izin verebilir ya da geri alabilir. Selwise bu değişiklikleri on beş dakikada bir İYS'den çeker:

İYS'de	Selwise'de
RET, kişi listenizde var	Kişi abonelikten çıkarılır ve İYS durumu "reddedildi" olur
RET, kişi listenizde yok	Geri çekilmiş bir kayıt açılır; sonradan bir sipariş veya içe aktarma bu adresi yeniden abone edemez
ONAY, kişi listenizde var	İzin İYS kaynağıyla verilir ve İYS durumu "kayıtlı" olur
ONAY, kişi listenizde yok	Yok sayılır. İYS bir adres söyler, bu kanalın topladığı bir kişiyi değil.

İYS'den gelen bir değişiklik, kişinin Selwise'teki son kararından daha eskiyse uygulanmaz. İYS değişiklikleri yalnızca yedi gün saklar: entegrasyon bir haftadan uzun süre kapalı kalırsa o aradaki retleri İYS'nin günlük mutabakat dosyasından kendiniz kontrol edin.

Gönderimde ne değişir

Durum	E-posta	SMS (Türkiye numarası)
İYS bağlı değil	İYS'ye bakılmaz	İYS durumu "kayıtlı" olmalı; durumu kişi listesinden siz girersiniz
İYS bağlı	İYS bu adres için RET tutuyorsa gönderilmez	İYS onayı kabul etmiş olmalı; onay kuyrukta beklerken mesaj gitmez

İki durumda da gönderilmeyen mesaj senaryo raporunda İYS kaydı yok nedeniyle sayılır. İYS bağlıyken kişi listesindeki İYS durumu yalnızca entegrasyon tarafından yazılır; elle değiştirilemez. Panelden yeniden abone ettiğiniz bir kişiye, İYS onu reddetmiş görüyorsa yine gönderilmez: önce izni İYS'ye kaydedin.

Bu ekranda ne görürsünüz

Bilgi	Açıklama
Bekleyen	Kuyrukta, İYS'ye henüz gitmemiş bildirimler
Süresi geçmiş	Bekleyenlerden, üç iş günü süresini aşmış onaylar
Başarısız	İYS'nin reddettiği bildirimler; nedeni İYS'nin kendi cümlesiyle listededir
Gönderilen	İYS'nin kabul ettiği bildirimler
Atlanan	Gönderilmesine gerek kalmayanlar: İYS'de hiç kaydı olmayan birine RET (H175), İYS'nin daha yeni bir kararı olan değişiklik (H178), silinmiş kişi
Son test, son gönderim, son çekme	Her birinin zamanı ve varsa hatası

Kullanıcı adı, şifre veya İYS aboneliğiyle ilgili bir hata bağlantının tamamını durdurur: kuyruk silinmez, yarım saat sonra yeniden denenir ve hata ekranda görünür. Sorunu giderdikten sonra Bağlantıyı test et ile doğrulayın, gerekirse Başarısızları yeniden dene ile reddedilenleri kuyruğa geri koyun.

Bağlantıyı kaldırma

Bağlantıyı kaldırdığınızda kuyruktaki bildirimler silinmez; yeniden bağladığınızda gönderilir. Entegrasyon kapalıyken veya kaldırılmışken yapılan izin değişiklikleri kuyruğa yazılmaz, onları İYS'ye kendiniz bildirmeniz gerekir.

Yasal sorumluluk

İzinlerin doğru toplanması ve İYS'ye zamanında kaydedilmesi hizmet sağlayıcı olarak sizin sorumluluğunuzdadır. Selwise bu bildirimi sizin adınıza yapan bir araçtır. Bu doküman hukuki danışmanlık değildir.