İçeriğe geç
ZitenaZitenaZitena Belgeleri

İYS (izin sağlayıcı)

İleti Yönetim Sistemi (İYS), ticari elektronik iletiler için alıcı izinlerinin tutulduğu sistemdir. Zitena, İYS kontrolü zorunlu olan bir amaçla aramadan hemen önce, sizin tanımladığınız izin sağlayıcıya müşterinin ARAMA iznini sorar. İzin sağlayıcı İYS entegratörünüz ya da kendi sisteminizdir; Zitena doğrudan iys.org.tr’ye bağlanmaz. Ayar Ayarlar → Entegrasyonlar → İzin sağlayıcı (İYS) kartındadır (paket: Giden arama).

İYS sorgusu1. Arama zamanı geldi (istek sırada) → 2. İzin sağlayıcı (GET ?telefon=+90…) → 3. ONAY (aranır) → 4. RET / bilinmiyor (reddedildi, iys_izin_yok)Arama zamanı geldiistek sıradaİzin sağlayıcıGET ?telefon=+90…ONAYaranırRET / bilinmiyorreddedildi, iys_izin_yok

Genel HTTP izin sağlayıcı

Bölüm başlığı “Genel HTTP izin sağlayıcı”

İYS entegratörünüzün ya da kendi sisteminizin şu sözleşmeye uyan bir uç sunması yeterlidir:

İzin sorgusu

GET https://izin.example.com/arama-izni?telefon=%2B905321234567
Authorization: Bearer <erişim anahtarı>
{"durum": "ONAY"}
  • durum: ONAY ya da RET (büyük/küçük harf duyarsız). Başka bir değer bilinmiyor sayılır ve arama yapılmaz.
  • Telefon +90XXXXXXXXXX biçiminde gelir.
  • 200 dışı yanıt, zaman aşımı (5 sn) ya da geçersiz gövde hata sayılır: istek 30 dakika sonra yeniden denenir; üçüncü hatada iys_erisilemedi ile reddedilir.

Ret bildirimi (isteğe bağlı, Ret bildirimi adresi doluysa): müşteri görüşmede “beni aramayın” derse:

POST https://izin.example.com/ret
Authorization: Bearer <erişim anahtarı>
Content-Type: application/json


{"telefon": "+905321234567", "durum": "RET", "kanal": "ARAMA"}
AlanAçıklama
İzin sorgu adresiZorunlu. GET ?telefon=+905… → {"durum": "ONAY"}
Ret bildirimi adresiİsteğe bağlı. POST {telefon, durum: "RET", kanal: "ARAMA"}
Erişim anahtarıİsteğe bağlı; Authorization: Bearer … olarak gönderilir, yalnız yazılır

Ret bildirimi adresi boşsa RET bildirilmez; numara yine de arama yasağı listesine girer.

Belirli İYS aracı yazılımları için özel bağdaştırıcılar da vardır; kullandığınız yazılım için destek ile iletişime geçin.

Kurallar

Bölüm başlığı “Kurallar”
  • İzin sağlayıcı tanımlı değilse İYS kontrolü zorunlu amaçlarla yeni istekler iys_saglayici_yok ile reddedilir.
  • İzin, istek açılırken değil aramadan hemen önce sorulur; böylece planlanmış bir aramada izin geri çekildiyse arama yapılmaz.
  • Son savunma: İYS kontrolü gereken bir aramada yalnız ONAY arama başlatır.
  • Hata mesajlarında ve loglarda telefon numarası ve yanıt gövdesi yer almaz.

© 2026 Erusoft

Ana siteDestek[email protected]