Bu rehberde: İYS hizmet sağlayıcı API kullanıcınızı bağlarsınız. Workflow'larda İzin ekle ve İzin sorgula işlemlerini kullanırsınız; SMS, WhatsApp ve e-posta kampanyalarından önce OrqLabs alıcıların iznini İYS'den sorgular ve onayı olmayanlara göndermez.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | IYS |
| Kategori | Araç (uyum) |
| Kimlik doğrulama | İYS API kullanıcı adı + şifre (OAuth2 password grant, Bearer token) |
| Kapsam | Organizasyon |
| Webhook | Hayır |
| Yetenekler | Uygulama işlemleri (İzin ekle, İzin sorgula) + kampanya öncesi izin kontrolü |
| Kullanan kutular | İYS (app.iys), Toplu mesaj ve Kampanyalar (otomatik kontrol) |
Ne işe yarar?
- İzin ekle (
add_consent): web formu, mağaza veya çağrı merkezinde alınan ONAY / RET kaydını İYS'ye işler. Alanlar: alıcı (telefon veya e-posta), kanal (MESAJ,ARAMA,EPOSTA), alıcı türü (BIREYSEL,TACIR), durum (ONAY,RET), kaynak (HS_WEB,HS_MOBIL,HS_FIZIKSEL_ORTAM,HS_ISLAK_IMZA,HS_CAGRI_MERKEZI…), izin tarihi (boş = şimdi). - İzin sorgula (
query_consent): bir alıcının kanal bazında güncel durumunu döndürür:status(ONAY / RET / kayıt yok) veallowed(gönderilebilir mi). - Kampanya öncesi kontrol: İYS entegrasyonu bağlıyken SMS (Twilio, Netgsm, İleti Merkezi, Verimor), WhatsApp ve e-posta kampanyalarında her gönderim grubundan önce alıcıların izni sorgulanır. Onayı olmayanlar kampanya mesajı olarak atlandı durumuna geçer ve gerekçe "İYS onayı yok" yazılır. Telegram, Slack gibi İYS kapsamı dışındaki kanallar etkilenmez; İYS bağlı değilse kampanyalar eskisi gibi çalışır.
Telefonlar İYS'ye +905XXXXXXXXX biçiminde gönderilir (0555…, 90555…, +90 555… kabul edilir); e-posta adresleri küçük harfe çevrilir.
6563 sayılı Kanun ve İYS
6563 sayılı Elektronik Ticaretin Düzenlenmesi Hakkında Kanun ve Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik uyarınca:
- Bireysel alıcılara (tüketiciler) ticari elektronik ileti (SMS, arama, e-posta, anlık mesaj) göndermeden önce onay alınmalı ve onay İYS'ye kaydedilmelidir. İYS'de kaydı olmayan onaylar geçersiz sayılır.
- Tacirlere (esnaf, şirketler) önceden onay gerekmez; ancak İYS'de RET kaydı varsa gönderim yapılamaz.
- Alıcı İYS üzerinden (e-Devlet, İYS web / mobil, çağrı merkezi) iznini her an geri alabilir; gönderim öncesi sorgu bu değişiklikleri yakalar.
- Bilgilendirme mesajları (sipariş, kargo, randevu, şifre) ticari ileti değildir ve İYS kontrolüne tabi değildir.
Uyarı: OrqLabs'ın kontrolü yasal sorumluluğu ortadan kaldırmaz; içeriğin ticari olup olmadığına ve onayların doğru kaydına gönderici marka karar verir.
Ön koşullar
- Markanızın İYS'ye kayıtlı olması ve hizmet sağlayıcı İYS numarası.
- İYS panelinde (Entegrasyon → API kullanıcıları) oluşturulmuş bir API kullanıcısı (kullanıcı adı + şifre).
- Marka kodu: markanın İYS kodu (tek markalı firmalarda çoğunlukla İYS numarasıyla aynıdır).
- Test için İYS'nin sandbox ortamı kullanılabilir (
api.sandbox.iys.org.tr).
Adım adım kurulum
- İYS paneli → Entegrasyon → API kullanıcısı oluşturun; kullanıcı adı ve şifreyi saklayın.
- OrqLabs → Entegrasyonlar → İYS → Bağla.
| Alan | Değer |
|---|---|
| İYS API kullanıcı adı | API kullanıcınız |
| İYS API şifresi | Şifresi |
| İYS numarası | Hizmet sağlayıcı İYS numaranız (rakam) |
| Marka kodu | Markanın İYS kodu (rakam) |
| Kampanya öncesi İYS kontrolü | Açık (önerilen) / Kapalı |
| Alıcı türü (kontrol) | Bireysel – ONAY gerekir (varsayılan) / Tacir – yalnızca RET engeller |
| Ortam | Canlı / Test (sandbox) |
- Bağlantıyı test et: token alınır ve markalarınız listelenir; marka kodu bu İYS numarasına ait değilse hata verir.
- Bir workflow'a İYS kutusunu ekleyip İzin sorgula ile kendi numaranızı deneyin.
Örnek: form onayını İYS'ye işleme
- Form gönderildi tetikleyicisi (ör. Typeform, Tally veya OrqLabs aday formu) – formda "Kampanyalardan SMS ile haberdar olmak istiyorum" kutusu.
- IF: onay kutusu işaretli mi?
- İYS → İzin ekle: alıcı
{{ $json.phone }}, kanalMESAJ, durumONAY, kaynakHS_WEB. - Aday ekle/güncelle: adayı segmentinize alın; sonraki SMS kampanyaları İYS kontrolünden geçer.
Kampanyalarda nasıl çalışır?
- Kontrol her 500 adaylık gönderim grubunda bir kez yapılır; İYS'nin çoklu izin sorgusu kullanılamazsa tek tek (5 paralel) sorgulanır.
- Bireysel modda yalnızca ONAY kaydı olanlara; tacir modunda RET kaydı olmayanlara gönderilir.
- İYS'ye ulaşılamazsa (şifre hatası, servis kesintisi) kampanya duraklatılır ve bildirim gelir: onay kontrolü yapılmadan gönderim yapılmaz. Sorunu giderip kampanyayı Devam ettir ile sürdürün.
- Atlanan alıcılar kampanya mesajları listesinde atlandı – İYS onayı yok olarak görünür.
Limitler
| Konu | Sınır |
|---|---|
| İzin tarihi | Yeni kayıtlarda en fazla 3 gün geriye (İYS kuralı) |
| Kontrol | Her kampanya grubunda (500 aday) bir İYS sorgusu |
| Token | Yaklaşık 2 saat geçerli; OrqLabs önbellekte tutar ve süresi dolunca yeniler |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH | API kullanıcı adı / şifresi hatalı | İYS panelinden kullanıcıyı kontrol edin; entegrasyon "süresi doldu" olur |
FORBIDDEN | İYS numarası veya marka kodu bu kullanıcıya ait değil | Kodları İYS panelinden doğrulayın |
CONFIG – marka kodu yok | Marka kodu yanlış | Testte listelenen markalardan birini girin |
INVALID – izin tarihi | Tarih 3 günden eski veya gelecekte | Tarihi boş bırakın (şimdi) ya da doğru tarihi girin |
| Kampanya duraklatıldı | İYS'ye ulaşılamadı | Hata mesajını inceleyin, sorunu giderip devam ettirin |
Sık sorulan sorular
İYS bağlamazsam kampanyalar çalışmaz mı?
Çalışır; kontrol yalnızca İYS entegrasyonu bağlıyken yapılır. SMS sağlayıcınızın kendi İYS filtresi (Netgsm iysfilter, İleti Merkezi iys, Verimor is_commercial) ticari gönderimlerde ayrıca uygulanır.
Kontrolü bazı kampanyalarda kapatabilir miyim? Kontrol entegrasyon düzeyindedir; Kampanya öncesi İYS kontrolü alanını "Kapalı" yaparsanız tüm kampanyalar için kapanır.
İYS sorguları ücretli mi? İYS'nin hizmet sağlayıcı ücretlendirmesi kendi aboneliğinize aittir; OrqLabs ek ücret almaz.