NetİYS Hizmetleri

Bu yazının tahmini okunma süresi 6 dakikadır.

NETİYS Hizmetleri

1. NetSantral IVR

2. Kısa Mesaj (İnteraktif SMS)

3. Kısa Link

4. Webhook (Web Kancası)

5. API

6. Web Arayüz ile Adres Yükleme

7. E-devletten Ret

1. NetSantral IVR

  • Arayan numaranın markanızın İYS’sine kayıtlı olup olmadığını kontrol edebilir, tuşlama yardımıyla onay ve ret işlemlerini yapabilirsiniz.
  • Bu işlemler için onaylı numara kontrolü, onay alma ve reddetme fonksiyonları bulunmaktadır.IVR uygulamasının kullanılabilmesi için Netsantral hizmetinizin aktif olması gerekir.

2. Kısa Mesaj (İnteraktif SMS)

  • Abone numaranıza gelen SMS’teki anahtar kelimeniz ile onay ve ret alabilirsiniz.

3. Kısa Link

  • Telefon numarası ve mail adresi bilgileri için onay ve ret işlemlerinin link üzerinden yapılmasını sağlar.
  • Kendinize özel oluşturacağınız kısa linkte firma logonuzu kullanabilirsiniz.
  • 29417 sayılı yönetmelik gereği kısa link sms gönderimlerinde Ret-çıkış hakkı olarak kullanılamaz, mail içeriklerinde veya web sayfaları için kullanılabilir. Sms içeriğinde Ret-çıkış hakkı için 0800’lü ücretsiz tüketici hattı kullanılır.

4. Webhook (Web Kancası)

  • NetİYS hizmeti kullanılarak yüklenen onay ve ret bilgilerinin sonuç durumları Webhook uygulaması kullanılarak alınabilir.
  • Sonuç durumu bilgisi Webhook olarak tanımlanan URL adresine iletilir.

5. API

Adres yükleme, adres sorgulama ve webhook API’leri için https://www.netgsm.com.tr/dokuman/#İys-adres-yükleme adresini inceleyebilirsiniz.

İYS Adres Yükleme

İYS API Servisi ile Hizmet sağlayıcıların Netgsm İYS İş ortağı aracılığıyla iletişim adreslerini yükleyebilirsiniz.

JSON Post ve Gönderilecek parametreler ;

*username Sisteme: girişte kullanılan kullanıcı adı veya abone numarasıdır.

*password: Sisteme girişte kullanılan şifredir.

*brandCode : Adres izinlerini yüklemek istediğiniz marka kodunuz.

refid: Belirleyeceğiniz bir ID göndererek daha sonra requestin durumunu refid ile sorgulayabilirsiniz. Header içerisinde gönderilir.

*type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri olmalıdır.

*source:İzin alınan kaynaktır, HS_FIZIKSEL_ORTAM, HS_ISLAK_IMZA, HS_WEB, HS_CAGRI_MERKEZI, HS_SOSYAL_MEDYA, HS_EPOSTA, HS_MESAJ, HS_MOBIL, HS_EORTAM, HS_ETKINLIK, HS_2015, HS_ATM ve HS_KARAR değerlerini alabilir.

*recipient: İzin alınan kullanıcının adres bilgisidir. +905XX XXX XX XX ya da info@netgsm.com.tr formatlarında olmalıdır.

*status: ONAY ya da RET değerini gönderebilirsiniz.

*consentDate: İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında

gönderilmelidir.

*recipientType: BIREYSEL ya da TACIR parametre olarak gönderilmelidir.

retailerCode İzin alınmasına aracılık eden bayiye İYS tarafından atanan İYS numara bilgisidir. Nümerik olmalı.

RetailerAccess:İzne erişimi olan bayilere İYS tarafından tekil olarak atanan İYS numaralarını gösterir. Nümerik olmalı

İYS Adres Sorgulama

İYS veritabanına yüklemiş olduğunuz datalarınızın izinlerinin gerçekleşip gerçekleşmediği sonucunu api ile adres yüklerken belirlenen refid parametresi göndererek sorgulayıp öğrenebilirsiniz. İznin gerçekleşmeme ihtimalinden dolayı adres sorgulama önemli bir işlemdir. API isteklerine dönen hata kodlarına ve hata mesajlarına https://apidocs.iys.org.tr/#tag/HATA-KODLARI ‘dan ulaşabilirsiniz.

JSON Post ve Gönderilecek Parametreler;

*username:Sisteme giriş yaparken kullanılan kullanıcı adı veya abone numarasıdır.

*password:Sisteme giriş yaparken kullanılan şifredir.

*brandCode: İletişim adresi izinlerinizi yüklediğiniz marka kodunuz.

*type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri olmalıdır.

*recipient: İYS’de kaydını sorgulayacağınız iletişim adres bilgisidir.

+90 5XX XXX XX XX ya da info@netgsm.com.tr formatlarında olmalıdır.

*recipientType:BİREYSEL ya da TACİR parametre olarak gönderilmelidir.

refid refid ile eklenen adresi sorgulayabilirsiniz, refid kullanıldığında recipient, recipientType ve type zorunlu değildir. Yalnızca refid gönderilebilir. Data parametresinde gönderilir.

Adres sorgulama API’si için https://www.netgsm.com.tr/dokuman/#İys-adres-sorgulama adresini inceleyebilirsiniz.

İYS Webhook

İYS’ye yüklenen izin ve ret bilgilerinin sonuç durumları, Webhook kullanılarak alınabilir. Bütün kanallardan gelen izin ve ret işlemlerinin bildirimi webhook olarak tanımlanan URL adresine yapılır.

URL’e bildirilen alanlar ;

iyscode: İYS’de kayıtlı numaranız.

brancode: İYS’de kayıtlı marka kodunuz.

type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri döner.

source: İzin alınan kaynağı ifade eder, HS_FIZIKSEL_ORTAM, HS_ISLAK_IMZA, HS_WEB, HS_CAGRI_MERKEZI, HS_SOSYAL_MEDYA, HS_EPOSTA, HS_MESAJ, HS_MOBIL, HS_EORTAM, HS_ETKINLIK, HS_2015, HS_ATM ve HS_KARAR ya da IYS_3338, IYS_CM, IYS_WEB, IYS_MOBIL, IYS_KISA_LINK değerlerinden biri döner.

status: ONAY ya da RET değeri döner.

consentDate: İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında döner.

recipientType: BIREYSEL ya da TACIR olarak döner.

retailercode: İzin alınmasında aracılık eden bayinin iyscode bilgisidir.Nümerik bayi iyscode değeri döner.

retailerAccess: İzne erişimi olan bayilerin iyscode bilgisidir. {123456,789456} formatında bayi iyscode döner.

submitid: İzin yüklenirken oluşturulan, izin paketinin id bilgisidir. “40e6215d-b5c6-4896- 987c-f30f3678f608” formatında id verisi döner.

recipient: İzin alınan kişinin telefon numarası ya da e-posta adresi bilgisidir. Telefon numaraları E164 uluslararası ( [+][country code][area code][local phone number] ) formatında döner.

resultstatus: İznin işlenme durum bilgisidir. success iznin eklendiğini, failure iznin eklenmediğini gösterir.

errcode: İzin işlenirken karşılaşılan hata kodu bilgisdir. “H155” formatında İYS hata kodu formatındadır.

errmsg: İzin işlenirken karşılaşılan hata mesajı bilgisdir. Metin formatında hata mesajı döner.

creationdate: İznin İYS tarafında işleme alındığı tarih bilgisidir. YYYY-MM-DD HH:mm:ss formatında tarih verisi döner.

İYS webhook API’si için https://www.netgsm.com.tr/dokuman/#İys-webhook adresini inceleyebilirsiniz.

6. Web Arayüz ile Adres Yükleme

  • Netiys arayüzünden adres kayıtlarınızın bulunduğu dosyayı yükleyerek İys’ye adres kaydı yapabilirsiniz.
  • Netgsm abone hesabınıza giriş sağladıktan sonra markanızı seçerek Dijital servisler ≫ NetİYS ≫ Dosya Yükle adımları ile .xls , .xlsx , .csv uzantılı adres dosyanızı yükleyebilirsiniz.

7. E-devletten Ret

  • E-devlet üzerinden yapılan ret işlemleri Webhook ile belirlenen URL’e bildirilebilir aynı zamanda Netİys arayüzü üzerinden görüntülenebilir.

Makaleyi yararlı buldunuz mu?